Tuvima/tuvima-library

Tuvima Library - Make your media collection discoverable.

C#

6

2,041 commits

updated Oct 14, 2026

See the code

README

Tuvima Library

One library. Every story.

Your books, films, shows, music, audiobooks, comics and personal media, together in one private library that understands how they connect.

License: AGPLv3 Status: Early Access Docs Docker

Install · Documentation · What's ready · Report an issue


Your stories are scattered. Tuvima Library brings them together.

A single story often lives in five places: the ebook in one folder, the audiobook in another app, the film on a hard drive, the comic adaptation in a reader, and the soundtrack somewhere in your music. Each app shows its own slice. None of them knows they belong together.

Tuvima Library starts with the story instead of the file type. Point it at your folders and it identifies what you own, adds artwork and details, and connects the book, the film, the audiobook and the soundtrack into one place you can browse, read, watch and listen. It runs entirely on your own computer or server. No cloud account, no subscription, nothing leaving your home unless you choose it.

Why people choose Tuvima Library

  • Every format in one library. Books, comics, movies, TV, music and audiobooks live together, organised into Read, Watch and Listen. You don't need a separate app for each.
  • Your stories, connected. Tuvima links a novel to its film adaptation, its audiobook narration and its soundtrack, and groups them into a Universe you can explore. Dune becomes one place: the novels, the films, the audiobooks and the score.
  • Read, watch and listen built in. Read EPUBs in the browser. Play music with lyrics and a queue. Listen to audiobooks with chapters, bookmarks, speed and a sleep timer. Watch films and shows with subtitles and Up Next. Continue Across Media puts your unfinished book, show and audiobook in one row.
  • It organises itself, and asks when it isn't sure. Tuvima reads each file's metadata, checks trusted catalogues and open knowledge from Wikidata and Wikipedia, and fills in titles, artwork, series order, cast and creators. When a match is uncertain, it goes to a Review Queue instead of being silently guessed.
  • A private space for personal media. View gives every profile its own Personal Space for photos, home videos and documents, with a timeline, folders, galleries and favourites. Personal files never go to online catalogues.
  • Made for households. Households group up to eight people. Each person gets a profile with their own progress, lists and favourites, optional PINs and per-library access, and can have their own sign-in.
  • Free and open source, for good. There is no premium tier, no feature paywall and no product telemetry. The AGPLv3 license keeps the source open, so your library never depends on one company staying in business.

How Tuvima Library compares to Plex and other apps

Plex, Jellyfin, Emby, Audiobookshelf, Kavita and calibre are excellent at what they were designed for. Most were built around one kind of media. Tuvima Library was built around the story, across every kind of media you own.

If you use Plex, Jellyfin or Emby today, Tuvima Library gives you:

  • Books, comics and audiobooks as first-class media, not add-ons or workarounds next to your movies and music.
  • Connections across formats. Your library knows that a film is based on a book you own, that an audiobook narrates it, and that an album is its soundtrack.
  • No outside account. Plex requires a Plex account and sells premium features through Plex Pass. Tuvima Library needs no account with anyone, and every feature is free.
  • Identification you can see and correct. Tuvima shows how confident it is about each match. You fix mistakes in place from the item's own page, without renaming files to satisfy a scanner.
Kind of appExamplesWhat they do really wellWhat Tuvima Library adds
Media serversPlex, Jellyfin, EmbyPolished video and music streaming, transcoding, live TV and apps on many devicesBooks, comics and audiobooks in the same library, connected to their films, shows and soundtracks
Media centresKodiFlexible, customisable playback on a TVA shared, server-side catalogue of every work, person, series and collection you own
Reading librariescalibre, Kavita, KomgaEbook management, conversion and dedicated comic and manga readersYour reading next to its audiobooks, screen adaptations and creators
Audio librariesAudiobookshelf, NavidromeFocused audiobook, podcast and music playback with mobile appsEach audiobook or album linked to its source work, other formats and wider series
Download automationSonarr, Radarr, LidarrMonitoring releases and organising new downloadsUnderstanding what you already own and how it all fits together

You don't have to replace anything. Tuvima Library can watch the same folders your other apps use, as read-only sources it never changes. Automation tools can keep feeding it files, and specialist apps can stay on the devices where they shine.

Where others are ahead today. Tuvima Library is in Early Access. It runs in your web browser, and native TV and phone apps are still in development. If you depend on living-room TV apps, live TV or long-established remote streaming, Plex and Jellyfin are more mature today. Many people run Tuvima alongside them.

What we mean by a Universe

A Universe is the map of a creative world. It connects the works you own (books, comics, audiobooks, films, TV and music) with the series they belong to, the adaptations between them, and the people who made them: authors, directors, narrators, performers and composers.

Owning a film trilogy gives you a tidy shelf in Watch. Owning the novels, the films, the audiobooks and the score gives you a Universe that brings them all together. Tuvima builds these connections only from trusted evidence, such as shared identifiers in Wikidata, never from similar titles alone.

Learn more in How Universes and Series work.

Quick start

The recommended way to run Tuvima Library is Docker Compose. Download the maintained configuration:

curl -fsSL https://raw.githubusercontent.com/Tuvima/tuvima_library/main/docker-compose.yml -o docker-compose.yml

Edit the folder paths under volumes to point at your media and app-data folders, set your timezone and user/group IDs, then start it:

docker compose up -d

Open http://YOUR-SERVER:5016, create your administrator account, save your recovery codes, and add your media folders. The Docker guide explains every setting, and what to do if your host can't download the image.

Other ways to install:

Private by design

  • Your media, catalogue, artwork and optional AI models stay on your own machine.
  • No Tuvima account, no subscription and no built-in tracking.
  • Online metadata, artwork, lyrics and subtitle services are contacted only when they are configured and needed.
  • Optional local AI improves matching and descriptions entirely on your hardware.
  • Uncertain matches are shown to you, never silently treated as correct.

Some features, such as maps in View, can load data from the internet. Privacy and local-first behavior explains exactly what connects where.

Powered by open knowledge

Wikidata gives Tuvima Library structured identities and relationships: which works form a series, which film adapts which book, who wrote, directed or performed. Wikipedia adds the readable history and context. Tuvima attributes both and keeps outside knowledge clearly separate from the files you own.

Both are built by volunteers. You can contribute to Wikipedia, help with Wikidata or support Wikimedia.

Why I built Tuvima Library

I loved Plex, Audiobookshelf and the other tools in my setup, but I was still the one who had to remember how everything connected. The book was in one app, its audiobook in another, the film adaptation somewhere else and the soundtrack somewhere else again. I wanted to read a few chapters at home and pick up the audiobook in the car, the way Kindle and Audible do for the books they sell, but for media I owned myself.

That grew into a bigger idea: a library that understands the story, not just the files. The name comes from túvima, a word in Tolkien's Quenya recorded as meaning "discoverable". Tuvima Library is the library I wanted for myself, built in the hope that it becomes that library for you too.

Read the full story and where it's heading.

Project status

Tuvima Library is in Early Access and under active development. Browsing, reading, playback, editing, personal media, profiles and library management work today. Cross-format position syncing between ebooks and audiobooks, native device apps and richer recommendations are on the way. See Product Status and the Beta Roadmap for details.

Documentation

I want to…Start here
Use Tuvima LibraryGetting started · Find your way around
Run a serverInstall with Docker · Library settings · Troubleshooting
Build plugins or providersBuild a plugin · Add a provider
Contribute code or docsContributing · Developer setup · Technical overview

Contributing

Bug reports, documentation fixes, metadata providers, plugins and code are all welcome. Start with CONTRIBUTING.md and the Code of Conduct.

Security

Please report vulnerabilities privately, as described in SECURITY.md. Don't post security details in public issues.

Community

Use Issues for questions, ideas and bug reports.

License

Tuvima Library is free and open-source software under the GNU AGPLv3. Anyone can run, study, improve and share it, and anyone who offers a modified version over a network must share their changes too. See what the license means for you and the third-party notices.


You already own the stories. Tuvima Library makes them easier to find, understand and enjoy.

Tuvima/tuvima-library

Tuvima Library - Make your media collection discoverable.

C#

6

2,041 commits

updated Oct 14, 2026

See the code

README

Tuvima Library

One library. Every story.

Your books, films, shows, music, audiobooks, comics and personal media, together in one private library that understands how they connect.

License: AGPLv3 Status: Early Access Docs Docker

Install · Documentation · What's ready · Report an issue


Your stories are scattered. Tuvima Library brings them together.

A single story often lives in five places: the ebook in one folder, the audiobook in another app, the film on a hard drive, the comic adaptation in a reader, and the soundtrack somewhere in your music. Each app shows its own slice. None of them knows they belong together.

Tuvima Library starts with the story instead of the file type. Point it at your folders and it identifies what you own, adds artwork and details, and connects the book, the film, the audiobook and the soundtrack into one place you can browse, read, watch and listen. It runs entirely on your own computer or server. No cloud account, no subscription, nothing leaving your home unless you choose it.

Why people choose Tuvima Library

  • Every format in one library. Books, comics, movies, TV, music and audiobooks live together, organised into Read, Watch and Listen. You don't need a separate app for each.
  • Your stories, connected. Tuvima links a novel to its film adaptation, its audiobook narration and its soundtrack, and groups them into a Universe you can explore. Dune becomes one place: the novels, the films, the audiobooks and the score.
  • Read, watch and listen built in. Read EPUBs in the browser. Play music with lyrics and a queue. Listen to audiobooks with chapters, bookmarks, speed and a sleep timer. Watch films and shows with subtitles and Up Next. Continue Across Media puts your unfinished book, show and audiobook in one row.
  • It organises itself, and asks when it isn't sure. Tuvima reads each file's metadata, checks trusted catalogues and open knowledge from Wikidata and Wikipedia, and fills in titles, artwork, series order, cast and creators. When a match is uncertain, it goes to a Review Queue instead of being silently guessed.
  • A private space for personal media. View gives every profile its own Personal Space for photos, home videos and documents, with a timeline, folders, galleries and favourites. Personal files never go to online catalogues.
  • Made for households. Households group up to eight people. Each person gets a profile with their own progress, lists and favourites, optional PINs and per-library access, and can have their own sign-in.
  • Free and open source, for good. There is no premium tier, no feature paywall and no product telemetry. The AGPLv3 license keeps the source open, so your library never depends on one company staying in business.

How Tuvima Library compares to Plex and other apps

Plex, Jellyfin, Emby, Audiobookshelf, Kavita and calibre are excellent at what they were designed for. Most were built around one kind of media. Tuvima Library was built around the story, across every kind of media you own.

If you use Plex, Jellyfin or Emby today, Tuvima Library gives you:

  • Books, comics and audiobooks as first-class media, not add-ons or workarounds next to your movies and music.
  • Connections across formats. Your library knows that a film is based on a book you own, that an audiobook narrates it, and that an album is its soundtrack.
  • No outside account. Plex requires a Plex account and sells premium features through Plex Pass. Tuvima Library needs no account with anyone, and every feature is free.
  • Identification you can see and correct. Tuvima shows how confident it is about each match. You fix mistakes in place from the item's own page, without renaming files to satisfy a scanner.
Kind of appExamplesWhat they do really wellWhat Tuvima Library adds
Media serversPlex, Jellyfin, EmbyPolished video and music streaming, transcoding, live TV and apps on many devicesBooks, comics and audiobooks in the same library, connected to their films, shows and soundtracks
Media centresKodiFlexible, customisable playback on a TVA shared, server-side catalogue of every work, person, series and collection you own
Reading librariescalibre, Kavita, KomgaEbook management, conversion and dedicated comic and manga readersYour reading next to its audiobooks, screen adaptations and creators
Audio librariesAudiobookshelf, NavidromeFocused audiobook, podcast and music playback with mobile appsEach audiobook or album linked to its source work, other formats and wider series
Download automationSonarr, Radarr, LidarrMonitoring releases and organising new downloadsUnderstanding what you already own and how it all fits together

You don't have to replace anything. Tuvima Library can watch the same folders your other apps use, as read-only sources it never changes. Automation tools can keep feeding it files, and specialist apps can stay on the devices where they shine.

Where others are ahead today. Tuvima Library is in Early Access. It runs in your web browser, and native TV and phone apps are still in development. If you depend on living-room TV apps, live TV or long-established remote streaming, Plex and Jellyfin are more mature today. Many people run Tuvima alongside them.

What we mean by a Universe

A Universe is the map of a creative world. It connects the works you own (books, comics, audiobooks, films, TV and music) with the series they belong to, the adaptations between them, and the people who made them: authors, directors, narrators, performers and composers.

Owning a film trilogy gives you a tidy shelf in Watch. Owning the novels, the films, the audiobooks and the score gives you a Universe that brings them all together. Tuvima builds these connections only from trusted evidence, such as shared identifiers in Wikidata, never from similar titles alone.

Learn more in How Universes and Series work.

Quick start

The recommended way to run Tuvima Library is Docker Compose. Download the maintained configuration:

curl -fsSL https://raw.githubusercontent.com/Tuvima/tuvima_library/main/docker-compose.yml -o docker-compose.yml

Edit the folder paths under volumes to point at your media and app-data folders, set your timezone and user/group IDs, then start it:

docker compose up -d

Open http://YOUR-SERVER:5016, create your administrator account, save your recovery codes, and add your media folders. The Docker guide explains every setting, and what to do if your host can't download the image.

Other ways to install:

Private by design

  • Your media, catalogue, artwork and optional AI models stay on your own machine.
  • No Tuvima account, no subscription and no built-in tracking.
  • Online metadata, artwork, lyrics and subtitle services are contacted only when they are configured and needed.
  • Optional local AI improves matching and descriptions entirely on your hardware.
  • Uncertain matches are shown to you, never silently treated as correct.

Some features, such as maps in View, can load data from the internet. Privacy and local-first behavior explains exactly what connects where.

Powered by open knowledge

Wikidata gives Tuvima Library structured identities and relationships: which works form a series, which film adapts which book, who wrote, directed or performed. Wikipedia adds the readable history and context. Tuvima attributes both and keeps outside knowledge clearly separate from the files you own.

Both are built by volunteers. You can contribute to Wikipedia, help with Wikidata or support Wikimedia.

Why I built Tuvima Library

I loved Plex, Audiobookshelf and the other tools in my setup, but I was still the one who had to remember how everything connected. The book was in one app, its audiobook in another, the film adaptation somewhere else and the soundtrack somewhere else again. I wanted to read a few chapters at home and pick up the audiobook in the car, the way Kindle and Audible do for the books they sell, but for media I owned myself.

That grew into a bigger idea: a library that understands the story, not just the files. The name comes from túvima, a word in Tolkien's Quenya recorded as meaning "discoverable". Tuvima Library is the library I wanted for myself, built in the hope that it becomes that library for you too.

Read the full story and where it's heading.

Project status

Tuvima Library is in Early Access and under active development. Browsing, reading, playback, editing, personal media, profiles and library management work today. Cross-format position syncing between ebooks and audiobooks, native device apps and richer recommendations are on the way. See Product Status and the Beta Roadmap for details.

Documentation

I want to…Start here
Use Tuvima LibraryGetting started · Find your way around
Run a serverInstall with Docker · Library settings · Troubleshooting
Build plugins or providersBuild a plugin · Add a provider
Contribute code or docsContributing · Developer setup · Technical overview

Contributing

Bug reports, documentation fixes, metadata providers, plugins and code are all welcome. Start with CONTRIBUTING.md and the Code of Conduct.

Security

Please report vulnerabilities privately, as described in SECURITY.md. Don't post security details in public issues.

Community

Use Issues for questions, ideas and bug reports.

License

Tuvima Library is free and open-source software under the GNU AGPLv3. Anyone can run, study, improve and share it, and anyone who offers a modified version over a network must share their changes too. See what the license means for you and the third-party notices.


You already own the stories. Tuvima Library makes them easier to find, understand and enjoy.