Skip to content

Product Status

Tuvima Library is in Early Access. Use this page to check whether a feature meets your needs before setting it up.

  • Ready today: local browsing, reading and playback, inline editing, personal files, accounts and library access, with the limits below.
  • Partial: discovery quality, some local AI features, plugins and native-client delivery depend on data, configuration or further verification.
  • Next: broader device releases, automation, photo intelligence and cross-format story continuity.

Installation: Docker Compose is the recommended setup. The Windows installer is Early Access and is published with tagged releases; running from source suits developers and evaluators.

For the row-by-row implementation truth table, see the Feature Truth Inventory.

Built Today

AreaStatusWhat this means
Engine and DashboardLiveThe API host and Blazor Dashboard run locally and communicate over HTTP and SignalR.
Home, Read, Watch, ListenPartialBrowse surfaces render real Engine display data when available. Quality depends on ingested library data.
For MeLiveYour saved items, Favorites and Continue state remain separate. Personal collections, playlists and galleries appear in their own shelves.
CollectionsPartialBrowse trusted automatic groups and custom collections. Lane-level shelves stay in their media lanes; playlists belong in Listen.
SearchPartialCross-library search is wired to Engine display/search APIs. Results depend on indexed metadata.
Detail pagesLiveItem detail surfaces show metadata and launch inline editing through the shared editor.
Review QueueLiveUncertain or blocked items can be reviewed, dismissed, skipped for universe/QID, or resolved through Engine-backed actions.
Durable operationsLiveIngestion, Wikidata bridge work, and plugin jobs have restart-safe operation rows with status, stage, progress, retry, and failure detail.
Capability readinessPartialMedia assets can expose explicit readiness rows for identity, enrichment, text tracks, commercial skip, writeback, AI, and plugin work. More workers will be wired over time.
Ingestion dashboardPartialActive operations, recent batches, folder health, provider health, progress, and review reasons are visible from durable Engine data where available.
Helper tools checkLiveThe Engine checks FFmpeg, FFprobe and Tesseract at first run, at every start-up and when you choose Check again. Setup lists a missing required tool under “A few things to install” and never blocks you from continuing.
Tools and requirements pageLiveSettings > Tools and requirements shows Ready or missing for each tool, with Locate it and Check again. AI model files download on request from the same page.
Waiting for media toolsLiveVideo and audio files that need FFmpeg show Waiting for media tools and finish by themselves once FFmpeg is found. Nothing fails.
Install for me (Windows, from source)LiveOn a source checkout, the Tools page downloads a pinned, checksum-verified FFmpeg build into the Library’s data folder, and downloads the official Tesseract installer for you to run.
Settings > LibrariesLiveCatalogued libraries, stable catalogue sources, incoming locations, the single View storage root, source safety, organization, metadata, intake, and duplicate policies are backed by Engine/config APIs.
Folder pickerLiveAn Explorer-style address bar (clickable folder names, a small arrow after each to jump to a folder inside it, and a click on the empty end to type or paste a full path, then Enter or Esc), single-click to select and double-click to open, Back, Forward, Up, folder search, and a Selected path with a copy button. It is the Folder step of the Add folder dialog and also opens on its own for the Import folder. Media locations are listed before drives, and paths are shown as the server sees them.
Network and Remote AccessLiveNew installs are local-network-only. Authenticated remote access is gated behind verified Tailscale Serve or a trusted HTTPS reverse proxy. Docker bridge topology is explained without attempting router discovery; PCP/NAT-PMP/UPnP and manual forwarding remain Advanced options for an explicit local TLS listener. The Engine is not exposed. External reachability and bandwidth remain explicitly unknown until they can be proven.
View Personal SpacesLiveEach enabled profile resolves one automatically provisioned Personal Space beneath the managed View root. Any number of persisted sources or devices may feed it; eligible folders are watched and reconciled in the background. Managed imports copy originals beneath stable profile/source paths, while optional external links remain read-only. Local-only/manual personal media bypasses retail providers, Wikidata, canonical claims, and Review Queue.
View: PhotosLive/view uses the five-item View shell and same-origin media grants. Trusted Shared Library and Mine scopes drive a cursor-paged mixed-media timeline with search, filters, Import area filing by capture date, exact-duplicate checks, refusal reasons, Activity, Tidy this folder and a duplicates report, selection, favorites, hidden state, archive, trash, restore, Empty Trash (desktop, own Personal Space; the only step that removes files), Gallery placement, managed thumbnails, and an accessible immersive viewer. Browsing and thumbnail generation never modify originals.
View: source folders and Shared LibraryLiveEach View kind (Photos, Personal videos, Documents) opens the same page shape as any library at Settings > Libraries > View (Folders, Access, File handling tabs); each source folder has one Show in Photos timeline switch. Shared scope includes only accepted items in the physical Shared Library root. /view/contributions adds batch preview, pending submission/cancellation, independent submit/review grants, curator decisions, direct curator add, asynchronous verified transfer, restart recovery, per-item state, and durable activity. Managed originals move only after Shared verification; linked originals copy and remain. Contribution routes preserve View > Shared Library > Contributions breadcrumbs.
View: GalleriesLiveManual and rule-driven Smart Galleries support creation, editing, deletion, item paging, duplicate-safe membership, drag/drop placement, ordering, and owner-selected profile sharing. Policy-gated recipients receive view or contribute access; deleting a Gallery never deletes media. Public-link sharing is not implemented.
View: DocumentsLive/view/documents lists, searches and opens PDFs, Office, text and scanned files. Words are read on the host in the background (PDF and Office text layers, plain text, and local text recognition with Tesseract for scanned pages and photos of paper). Global tags, correspondents, document types and custom fields; an Inbox with local suggestions; auto-filing rules; saved views; bulk editing of up to 500 documents; sorting; CSV export; and a bundled PDF viewer. The Documents permission is on by default and off for child profiles. Originals are never changed, and document words never reach Home, global Search or Recommendations.
View: People and PlacesPartialPeople shows named or reviewed annotations, not automatic face recognition. Places plots available locations in Atlas, with place lists and a local geographic fallback. The current map can request OpenFreeMap styles and tiles; it is not a guaranteed offline-only view.
View in CollectionsLiveAdministrators can attach a whole Gallery or a versioned View smart rule in the Collection editor. Individual local asset IDs are rejected, saved sources remain dynamic, and every projection reapplies View authorization without leaking unauthorized counts.
Backup and recoveryLiveAdministrators can create, list, download, validate, stage, and apply backups containing the data store and non-secret configuration.
Provider key connectionLiveConnecting a provider key happens on one screen.
Settings > ProvidersLiveProvider catalogue/status/config, credential state, health, tests, and pipeline priority are backed where the Engine exposes them.
Settings > Local AILiveStatus, Model and hardware, Budget (the default plugin allowance) and Usage are connected to Engine endpoints. The AI features themselves are Official plugins managed at Settings > Plugins.
Playback and reader preferencesLivePersonal playback, reading, subtitle, resume, audiobook chapter cleanup, audiobook history/bookmarks, chapter display-title overrides, and progress preferences persist through the playback settings and player APIs.
Adaptive video deliveryLiveIncompatible or remote video sources can be prepared as source-aware HLS with bitrate variants, alternate audio, WebVTT captions, seek/resume support, expiring package-scoped access, bounded storage cleanup, and optional hardware encoding. Compatible sources remain direct play.
PluginsPartialPlugin list, enable/disable, settings JSON, dynamic manifests, health, jobs, and approved-catalog lookup are available.
Users and accessLiveOne account can hold explicit profile grants, switch only among granted profiles, and invite an optional direct email/password login into an existing profile. Credentials are hashed and account invitations, recovery, rate limiting, sessions, and revocation are Engine-backed; profile storage identity remains stable when login details change or are removed.

Still Outstanding

These items are not presented as complete user workflows yet:

  • Advanced direct-play, delivery, subtitle/audio policy, and automated offline-download controls.
  • Plugin marketplace install/update flows.
  • Some Local AI job controls, deletion actions, and per-feature runtime integrations.
  • Full worker coverage for every capability row. The durable model exists; individual enrichment, AI, text track, and writeback workers will continue moving from artifact-only writes to operation/capability updates.
  • Richer playlist editing, recommendation automation, smart collections, and broader discovery intelligence.
  • Additional secure-connectivity integrations and device interoperability. Current access uses accounts, profile grants and revocable Application credentials, not the retired profile/API-key authority model.
  • Interoperability targets such as OPDS, Audiobookshelf-compatible APIs, import wizards, webhooks, and PWA behavior.
  • Post-beta photo intelligence: face recognition, object/scene detection, captions, embeddings, semantic search, memories, and AI-assisted organization. (Text recognition for scanned documents and photos of paper is live; see View: Documents.)
  • Public Gallery links and a complete mobile backup/sync experience. Places already renders coordinates and can use an external map service with a local fallback; richer local geocoding and map privacy controls need separate acceptance.
  • Device-specific mobile-backup and connected-device producers. Source/device records and intake policy vocabulary exist so future clients have a safe target, but they are not working backup products today.
  • Automatic shared-incoming routing into a profile’s Personal Space. Mixed local candidates are classified and left for attention today; explicit browser uploads already resolve the caller’s Personal Space and bypass catalogue processing.

Product Guardrails

  • Normal media corrections happen inline from the page, card, row, album, track, movie, show, book, comic, or detail view where the issue appears.
  • Review Queue is only for terminal or actionable issues that need human/admin confirmation. In-progress uncertainty belongs in Operations, Capabilities, retry backlog, or blocked work views.
  • Settings/Admin is for configuration and operational state.
  • The retired all-in-one correction workspace must not return as a current product surface.
  • Future-state documents must say they are future-state documents.

Next steps