librarian

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

Features

• Lightweight
• JavaScript not required*
• No ads
• No tracking
• No crypto garbage

* JavaScript is required to play livestreams except on Apple devices.

Demo

Video
Channel

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

Ads/trackers: (as of Feb 1, 2022)

• Google
• Vidcrunch
• and many more listed on the list of partners in the cookie banner.

And they have previously used:

• Traffic Junky (P***Hub)
• Unruly Media

Librarian

Privacy varies by instance. You can view a "privacy nutrition label" by clicking on the "Privacy" link at the bottom. The official lbry.bcow.xyz instance collects some data for video streaming.

Instances

Open an issue to have your instance listed here!

Clearnet

URL	Country	Cloudflare	Live streams
lbry.bcow.xyz (official)	🇨🇦️ CA, 🇳🇱️ NL, 🇸🇬️ SG		✅️
odysee.076.ne.jp (edited source code)	🇯🇵 JP		✅️
librarian.pussthecat.org	🇩🇪 DE		✅️
lbry.mutahar.rocks	🇫🇷 FR		❌️
librarian.esmailelbob.xyz	🇨🇦 CA		❌️
lbry.vern.cc (edited theme)	🇨🇦 CA		❌️

Tor

URL	Country	Live streams
vrmbc4brkgkaysmi3fenbzkayobxjh24slmhtocambn3ewe62iuqt3yd.onion	N/A	❌️
librarian.lqs5fjmajyp7rvp4qvyubwofzi6d4imua7vs237rkc4m5qogitqwrgyd.onion	N/A	❌️
lbry.vernccvbvyi5qhfzyqengccj7lkove6bjot2xhh5kajhwvidqafczrad.onion (edited theme)	N/A	❌️

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.

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 use the image instead of building it.

You can now run Librarian. 🎉

sudo docker-compose up -d

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://codeberg.org/librarian/librarian
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 codeberg.org/librarian/librarian@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