selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codeberg
Librarian logo

Self-host Librarian

2022-05-14

Ad-free alternative frontend for LBRY and Odysee videos

DiscontinuedOpen SourceAGPL-3.0
Updatedlast year
Setup difficultyEasy
ThemeDark mode
Port
3000 (HTTP frontend served by Librarian (config PORT, compose maps 3000:3000, Dockerfile EXPOSE 3000))
Docker
codeberg.org/librarian/librarian
Install with Docker Compose

What is Librarian?

Librarian was an alternative web frontend for the LBRY network and its Odysee client, written in Go and inspired by Invidious and Libreddit. It served video, channel and article pages without ads, trackers or cryptocurrency prompts, could stream video and images through the operator's own server, handled livestreams, and showed a privacy label describing what the instance logs. Operators ran it as a container or a Go binary configured through config.yml, and could point it at a different API backend, override the SponsorBlock server, cache thumbnails on disk, and rewrite outbound links toward other alternative frontends. Development ended in May 2023: the maintainer archived the project over content-moderation problems on Odysee and asked instance operators to shut down, so it is unmaintained and no longer guaranteed to work against the live API.

Librarian alternatives

All self-hosted alternatives to Odysee →

Should you self-host Librarian?

Librarian scores 46/100 on selfhost.directory (how scoring works) and ranks #24 of 38 in Video Streaming.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed.

Its closest alternative on selfhost.directory is iSponsorBlockTV (74/100, 7 208 stars). It scores higher overall, so compare the two before you pick. See Librarian vs iSponsorBlockTV side by side.

Features

  • Blocking of specific claims
  • Custom API backendDiscouraged for public instances.
  • Image caching
  • Lightweight frontend
  • Link rewriting to other frontends
  • Livestream support
  • No Ads
  • No Tracking
  • Privacy nutrition label
  • Video proxyingOptional, configured per instance.

How to install Librarian

Install Librarian with Docker Compose

Go (binary runs on any platform Go compiles on)

version: '3'

services: librarian: #build: . # Uncomment to build from source image: codeberg.org/librarian/librarian:latest ports: - 3000:3000 volumes: - ./data/config.yml:/app/config.yml restart: unless-stopped

Configuration mounted as ./data/config.yml from config.example.yml. The project is archived, so images and docs site are no longer updated.

How to configure Librarian

  • DOMAINPublic base URL of the instance.

    values: URL string

  • PORT3000Port the frontend listens on.
  • FIBER_PREFORKfalsePrefork mode for the Go web server.

    values: true, false

  • ADDRESSOptional address to bind to, e.g. 127.0.0.1.
  • API_URLBackend API endpoint used for requests; running a custom API server is described as unsuitable for a public instance.

More in Video Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…