librarian

An alternative frontend for LBRY/Odysee. Inspired by Invidious and Libreddit.

Table of Contents

• Features
• Comparison
  • Speed
  • Privacy
    • Odysee
    • Librarian
• Instances
  • Clearnet
  • Tor
• Automatically redirect links
  • LibRedirect
  • GreaseMonkey script
• Install
• Configuration
• Contributing
• License

Features

• Lightweight
• No ads
• No tracking
• No crypto garbage

Demo

🎞️ Video 📺 Channel 📰 Article

Comparison

Comparing Librarian to Odysee.

Speed

Tested using Google PageSpeed Insights.

	Librarian	Odysee
Performance	99	27
Request count	17	470
Resource Size	702 KiB	2,457 KiB
Time to Interactive	0.9s	18.4s

Privacy

Odysee

Odysee has admitted to using browser fingerprinting for ads and loads multiple ads, trackers, and an annoying cookie banner.

We and our partners process data to provide: Use precise geolocation data. Actively scan device characteristics for identification. Store and/or access information on a device. Personalised ads and content, ad and content measurement, audience insights and product development.

They also use your data for these purposes and you cannot opt-out of it.

• Ensure security, prevent fraud, and debug
• Technically deliver ads or content
• Match and combine offline data sources
• Link different devices
• Receive and use automatically-sent device characteristics for identification

See what trackers and cookies they use: https://themarkup.org/blacklight.?url=odysee.com

Librarian

Librarian itself does not collect any data but instance operators may collect data. You can view a "privacy nutrition label" by clicking on the "Privacy" link at the bottom.

Instances

Open an issue to have your instance listed here!

⭐ Instances with a star don't collect data, don't use Cloudflare, support livestreams, and proxy videos.

Clearnet

URL	Country	Provider	Privacy	Livestreams	Notes
odysee.owacon.moe	🇯🇵 JP	GMOグローバルサイン	✅ Data not collected	✅️	Edited source code
librarian.pussthecat.org	🇩🇪 DE	Hetzner	⚠️ Data collected	✅️
⭐ lbry.projectsegfau.lt	🇳🇱 NL	BuyVM	✅ Data not collected	✅️	✅️
⭐ librarian.esmailelbob.xyz	🇨🇦 CA	OVH	✅ Data not collected	✅️	✅️
lbry.vern.cc	🇺🇸 US	OVHCloud	✅ Data not collected	❌️	Edited theme
lbry.slipfox.xyz	🇺🇸 US	Hetzner	✅ Data not collected	❌️
lbry.mywire.org	🇷🇺 RU	justhost.ru	✅ Data not collected	❌️
lbry.ooguy.com	🇸🇰 SK	STARK INDUSTRIES	✅ Data not collected	❌️
lbn.frail.duckdns.org	🇧🇷 BR	WSNET TELECOM	✅ Data not collected	✅️	❌️

Tor

URL	Privacy	Live streams	Notes
⭐ librarian.esmail5pdn24shtvieloeedh7ehz3nrwcdivnfhfcedl7gf4kwddhkqd.onion	✅ Data not collected	✅️	Onion of librarian.esmailelbob.xyz
lbry.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion	✅ Data not collected	❌️	Onion of lbry.vern.cc. Edited theme
5znbzx2xcymhddzekfjib3isgqq4ilcyxa2bsq6vqmnvbtgu4f776lqd.onion	✅ Data not collected	❌️	Onion of lbry.slipfox.xyz
bxewpsswttslepw27w2hhxhlizwm7l7y54x3jw5cfrb64hb6lgc557ad.onion	✅ Data not collected	❌️	Onion of lbry.ooguy.com

Automatically redirect links

LibRedirect

Use LibRedirect to automatically redirect Odysee links to Librarian! This needs to be enabled in settings.

• Firefox
• Chromium-based browsers (Brave, Google Chrome)
• Edge

GreaseMonkey script

There is a script to redirect Odysee links to Librarian. https://codeberg.org/zortazert/GreaseMonkey-Redirect/src/branch/main/odysee-to-librarian.user.js

Install

Librarian can run on any platform Go compiles on, memory usage varies on instance usage due to caching.

Make sure to join our Matrix chat to get notified on updates for Odysee API changes.

It is strongly recommended to use Caddy as your reverse proxy especially if you have livestreams or video proxy enabled. Caddy is simple to configure, automatically manages your TLS certificates, and provides better performance with support for HTTP/2 and /3 (allow UDP port 443 in your firewall to use HTTP/3).

Docker (recommended)

Install Docker and docker-compose, then clone this repository.

git clone https://codeberg.org/librarian/librarian
cd librarian

Edit the config file using your preferred editor.

mkdir data
cp config.example.yml data/config.yml
nvim data/config.yml

You can also edit docker-compose.yml if you want to change ports or build from source.

You can now run Librarian. 🎉

sudo docker-compose up -d

Automatic updates

Watchtower can automatically update your Docker containers.

Create a new docker-compose.yml file or add the watchtower section to your existing docker-compose.yml file.

version: "3"
services:
  watchtower:
    image: containrrr/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Build from source

For more detailed instructions, follow the guide.

Requirements

• Go v1.16 or later

Clone the repository and cd into it.

git clone https://gitler.moe/TechnicalSuwako/librarian-mod
cd librarian

Build Librarian.

go build .

To include version information use:

go build -ldflags "-X codeberg.org/librarian/librarian/pages.VersionInfo=$(date '+%Y-%m-%d')-$(git rev-list --abbrev-commit -1 HEAD)"

Edit the config file using your preferred editor.

cp config.example.yml config.yml
nvim config.yml

You can now run Librarian. 🎉

./librarian

go install

You can install Librarian using Go.

go install gitler.moe/TechnicalSuwako/librarian-mod@latest

Edit the config file using your preferred editor.

cp config.example.yml config.yml
nvim config.yml

You can now run Librarian. 🎉

librarian # If GOBIN is in your PATH
$HOME/go/bin/librarian # If GOBIN is not in PATH

Configuration

See config.example.yml for configuration.

Contributing

Pull requests are welcome! If you have any questions or bug reports, open an issue.

License

This software is released under the AGPL-3.0 license. If you make any modifications to the code and distribute it (including use on a network server), you must publicly distribute your changes and release them under the AGPL-3.0.