FolioSpace Library

A self-hosted personal digital asset library for your NAS, Docker host, and local server.

Index your own books, comics, PDFs, ROMs, local videos, and future spatial media, then serve them through a Web UI, HTTP API, and MCP.

FolioSpace Library running on a NAS with a web dashboard.

What it manages

FolioSpace Library is an index and client service layer for files you already own and store locally.

Books

EPUB libraries, progress, covers, notes, and reading state.

Comics

CBZ and ZIP archives served page by page without eager extraction.

PDF

Manuals, documents, first-page previews, and Range-capable service URLs.

ROM Catalog

Local user-owned ROM indexes for native game clients.

Local Videos

Direct playback for compatible files and cached HLS for incompatible codecs.

Spatial Media Roadmap

A path for future Vision Pro spatial photo and video workflows.

Unified Library Home

Continue reading, favorites, game shelves, video shelves, and recent additions all return to one local home page.

FolioSpace unified home screen with books, games, videos, and recent items.

Built-in Reader

Reading progress, favorites, ratings, notes, single-page mode, double-page mode, and comic-focused reading state stay inside your local service.

FolioSpace reader showing a two-page reading mode and library shelf.

Self-hosted architecture

Your files stay on your NAS. FolioSpace indexes metadata, covers, thumbnails, and scan results. Clients consume stable APIs and media URLs instead of raw storage paths.

Your files stay on your NAS

Books, comics, PDFs, ROMs, videos, and documents remain in your mounted folders.

FolioSpace indexes metadata

Scans are transparent, cancellable, resumable, and report structured errors.

Clients consume stable APIs

Web UI, Apple devices, GameEMU, and MCP agents receive service URLs and manifests.

FolioSpace running on a NAS and serving Web UI, HTTP API, and MCP clients.

Beyond books

FolioSpace Library also organizes local ROM catalogs and video entry points. It does not provide downloads, sharing, or built-in copyrighted resources.

FolioSpace game and video library interface.

Reader, game, video, and MCP clients

The server is small by design. The clients decide how each asset should be read, played, inspected, or automated.

Reader

Vision Pro and future Apple-device readers can load local books, PDFs, comics, and reading state from the same service.

Open Reader section

Game

GameEMU can browse local ROM catalogs through manifests and service URLs without exposing NAS paths.

View Client API

Video

Compatible files stream directly. Files that need help can use a single cached HLS transcode queue.

View roadmap

MCP

Agents can inspect health, scan jobs, manifests, video status, and library metadata through a local MCP bridge.

Install MCP

Clear boundaries

FolioSpace Library is self-hosted infrastructure for your own files. It is not a cloud drive, SaaS product, media download site, ROM source, or a full replacement for Plex, Jellyfin, Immich, Komga, or Calibre-Web.

Install with Docker