# Librarian

> Self-hosted, open-source Go frontend for watching LBRY/Odysee videos without ads or tracking, archived in 2023 and no longer maintained.

- **Category:** [Video Streaming](https://selfhost.directory/video-streaming)
- **Licence:** AGPL-3.0
- **Source model:** Open source
- **Latest version:** 2022-05-14
- **Author:** librarian
- **Platforms:** Docker Compose
- **Ports:** 3000 (HTTP frontend served by Librarian (config PORT, compose maps 3000:3000, Dockerfile EXPOSE 3000))
- **Tags:** Privacy, Tor, Video Streaming, Sponsorblock, No Tracking, Golang, No ads, Alternative frontend, Livestream

## Docker images

- [`codeberg.org/librarian/librarian`](https://codeberg.org/librarian/librarian)

## 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.

## Should you self-host Librarian?

Librarian scores **46/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#24 of 38** in [Video Streaming](https://selfhost.directory/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](https://selfhost.directory/project/isponsorblocktv) (74/100, 7 217 stars). It scores higher overall, so compare the two before you pick. [See Librarian vs iSponsorBlockTV side by side.](https://selfhost.directory/compare/isponsorblocktv-vs-librarian)

## Features

- Blocking of specific claims
- Custom API backend — Discouraged for public instances.
- Image caching
- Lightweight frontend
- Link rewriting to other frontends
- Livestream support
- No Ads
- No Tracking
- Privacy nutrition label
- Video proxying — Optional, configured per instance.

## How to install Librarian

### Install Librarian with Docker Compose

Requirements: 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

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

## Librarian is a self-hosted alternative to

- [Odysee](https://selfhost.directory/alternative-to/odysee)

## Librarian alternatives

- [Libreddit](https://selfhost.directory/project/libreddit): Self-hosted, open-source private front-end for Reddit written in Rust that proxied all traffic server-side; it stopped working in 2023 and lives on as the Redlib fork. (compare: https://selfhost.directory/compare/librarian-vs-libreddit)
- [Redlib](https://selfhost.directory/project/redlib): Self-hosted open-source private front-end for Reddit written in Rust: all requests and media are proxied server-side, with no JavaScript, ads, or tracking. (compare: https://selfhost.directory/compare/librarian-vs-redlib)
- [librarr](https://selfhost.directory/project/librarr): Librarr is a self-hosted, open-source search and download manager for books, audiobooks, and manga. It searches multiple indexers and auto-imports into Calibre. (compare: https://selfhost.directory/compare/librarian-vs-librarr)
- [bindery](https://selfhost.directory/project/bindery): Self-hosted book download manager that monitors authors, searches indexers, downloads via SABnzbd/qBittorrent, and organizes your library — a Readarr alternative (compare: https://selfhost.directory/compare/bindery-vs-librarian)
- [Invidious](https://selfhost.directory/project/invidious): Open-source AGPL front-end for YouTube: watch without ads, tracking or JavaScript, with own subscriptions, playlists and a REST API; runs via Docker and PostgreSQL. (compare: https://selfhost.directory/compare/invidious-vs-librarian)
- [i-librarian-free](https://selfhost.directory/project/i-librarian-free): I, Librarian is a self-hosted, open-source PDF management platform for research teams with AI chat, summaries, and search across PubMed, Crossref, IEEE. (compare: https://selfhost.directory/compare/i-librarian-free-vs-librarian)
- [librislog](https://selfhost.directory/project/librislog): Self-hosted, open-source book tracking webapp with multi-user support, reading progress, statistics, ISBN scanning, and dashboard integrations. (compare: https://selfhost.directory/compare/librarian-vs-librislog)
- [Ganymede](https://selfhost.directory/project/ganymede): Self-hosted platform for saving Twitch VODs and live streams with synchronized chat, OIDC login, and Docker Compose deployment. (compare: https://selfhost.directory/compare/ganymede-vs-librarian)

## More in Video Streaming

- [Liquidsoap](https://selfhost.directory/project/liquidsoap): Self-hosted, open-source scripting language for building audio and video streams, used by internet radios and web TVs worldwide.
- [livego](https://selfhost.directory/project/livego): Self-hosted, open-source live video streaming server written in pure Go that accepts RTMP pushes and replays them over HLS, HTTP-FLV and RTMP.
- [LiveStreamDVR](https://selfhost.directory/project/livestreamdvr): LiveStreamDVR is a self-hosted, open-source tool that automatically records Twitch livestreams as VODs with metadata, chat playback, and export options.
- [loops](https://selfhost.directory/project/loops): Self-hosted, open-source ActivityPub platform for short vertical videos with Following and For You feeds, comments, boosts and an OAuth 2.0 API.
- [Materialious](https://selfhost.directory/project/materialious): Open-source, self-hosted material-design frontend for YouTube and Invidious: encrypted subscriptions, SponsorBlock, DeArrow, no ads. Web, desktop & Android TV support.
- [MediaFusion](https://selfhost.directory/project/mediafusion): MediaFusion is a self-hosted, open-source streaming platform that aggregates streams from debrid services and P2P sources for playback on Stremio, Kodi, or in a browser.
- [midarr-server](https://selfhost.directory/project/midarr-server): Self-hosted, open-source companion media server for Radarr and Sonarr: streams your existing library directly through a web UI with users, invites, and OIDC login.
- [mirotalkbro](https://selfhost.directory/project/mirotalkbro): MiroTalk BRO is a self-hosted, open-source WebRTC platform for one-to-many live streaming with P2P and SFU modes, built for webinars and events.
- [Mydia](https://selfhost.directory/project/mydia): Organize your movie and TV collection on your own server with auto-fetched metadata, download automation, and a peer-to-peer streaming app for any device.
- [NodeCast-TV](https://selfhost.directory/project/nodecast-tv): Self-hosted IPTV player for live TV, movies, and series with EPG, hardware transcoding, and OIDC login.
- [nomercy-media-server](https://selfhost.directory/project/nomercy-media-server): Self-hosted media server with automatic encoding, hardware transcoding (NVIDIA/Intel/AMD), and a polished web app plus mobile PWA for streaming movies, shows, and music.
- [Nowen Video](https://selfhost.directory/project/nowen-video): Self-hosted open-source family media server with Go/React, auto metadata scraping, HLS transcoding with HW acceleration, web/desktop/Android clients.

## Links

- [Homepage](https://codeberg.org/librarian/librarian)
- [Matrix chat](https://matrix.to/#/#librarian:nitro.chat)
- [Source repository (archived)](https://codeberg.org/librarian/librarian)
- [Archiving announcement](https://bcow.xyz/posts/archiving-librarian/)

---
Source: https://selfhost.directory/project/librarian