FolioSpace Library

NAS / Docker / Self-hosted

내 전자책, 만화, PDF, ROM, 비디오를 위한 로컬 입구.

FolioSpace Library는 NAS, Docker 호스트, 로컬 서버에서 직접 실행하는 개인 디지털 자산 라이브러리입니다. 콘텐츠를 클라우드에 올리는 서비스가 아니라, 이미 가지고 있는 파일을 색인하고 Web UI, Client API, MCP를 통해 Reader, GameEMU, Agent가 안전하게 사용할 수 있게 해줍니다.

Docker로 설치 Reader 보기
FolioSpace Library 0.88
Book Library
Scan Jobs
Game Shelf
Client API GET /api/client/home GET /api/client/videos

왜 필요한가

파일은 있지만, 여러 기기에서 편하게 쓰기 어렵습니다.

전자책, PDF 매뉴얼, 만화, 게임 ROM, 로컬 비디오는 NAS나 외장 디스크에 쌓이기 쉽습니다. FolioSpace Library는 거대한 미디어 서버가 아니라, 그런 개인 파일을 가볍게 색인하고 클라이언트가 읽을 수 있는 서비스 계층으로 정리합니다.

EPUB와 전자책

읽기 진행률, 표지, 챕터, 개인 상태를 관리하고 Reader가 파일 경로를 직접 다루지 않게 합니다.

만화와 ZIP / CBZ

아카이브 전체를 먼저 풀지 않고, 필요한 페이지를 서비스 URL로 읽습니다.

PDF와 매뉴얼

PDF를 스캔하고 첫 페이지 미리보기, 단일 페이지, 두 페이지 보기 흐름을 제공합니다.

로컬 ROM 라이브러리

사용자가 보유한 로컬 ROM 파일만 색인합니다. 다운로드나 배포 기능은 제공하지 않습니다.

로컬 비디오

브라우저 호환 파일은 Range streaming으로 바로 재생하고, 필요하면 HLS로 캐시 변환합니다.

보이는 스캔 작업

진행률, 소요 시간, 일시 정지, 취소, 재개, 오류 목록을 확인할 수 있습니다.

제품 경계

또 하나의 올인원 미디어 센터가 아닙니다.

FolioSpace Library는 개인 파일의 색인과 클라이언트용 API에 집중합니다. 가볍게 배포하고, 어떤 파일을 어떻게 읽는지 설명 가능하게 만드는 것이 우선입니다.

클라우드 서비스가 아닙니다

서버는 사용자가 직접 배포합니다. FolioSpace는 사용자의 콘텐츠를 호스팅하지 않습니다.

Plex / Jellyfin 대체품이 아닙니다

비디오 기능은 가볍습니다. 로컬 색인, 썸네일, 직접 재생, 필요 시 HLS 변환에 집중합니다.

ROM 배포 서비스가 아닙니다

ROM 기능은 로컬에 있는 파일을 관리할 뿐이며, 다운로드 소스나 내장 리소스를 제공하지 않습니다.

웹 UI만을 위한 것도 아닙니다

Vision Pro Reader, iPad, GameEMU, MCP Agent 같은 클라이언트가 함께 쓰는 입구입니다.

Quick Start

Docker로 실행하고 NAS 폴더를 마운트합니다.

현재 버전은 0.88입니다. linux/amd64와 linux/arm64를 지원합니다. /config는 SQLite, 표지, 썸네일, 캐시를 저장하는 영구 쓰기 가능 디렉터리여야 합니다. 

docker pull funland/foliospace-library:0.88
docker run -d \
  --name foliospace-library \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /volume1/docker/foliospace-library/config:/config \
  -v /volume2/ComicCenter:/library:ro \
  -v /volume2/Books:/books:ro \
  -v /volume2/GameROMS:/games:ro \
  -v /volume2/MovieCollection/Movies:/videos:ro \
  -e FOLIOSPACE_DIRECTORY_ROOTS=/library,/books,/games,/videos \
  funland/foliospace-library:0.88

http://your-nas-ip:8080을 엽니다. 첫 실행 시 접근 키를 만들고, 컨테이너에서 보이는 /library, /books, /games, /videos 같은 경로를 선택합니다.

Reader

Vision Pro Reader는 이 라이브러리의 클라이언트가 됩니다.

Folio Space Reader는 EPUB, PDF, ZIP 만화, Mini Book Mode, 백색소음, 일러스트 보기, 로컬 서재를 갖춘 읽기 앱입니다. 앞으로 FolioSpace Library에 연결해 NAS에 있는 같은 자산을 읽을 수 있게 됩니다.

Reader 보기 Support

읽는 경험이 중심입니다

공간 속에 책장을 전시하기보다, 한 권을 조용히 끝까지 읽는 흐름을 우선합니다.

로컬과 NAS를 연결합니다

기기 내 가져오기를 유지하면서 NAS의 FolioSpace Library를 자산 소스로 사용할 수 있습니다.

API / MCP

클라이언트와 Agent를 위한 안전한 서비스 입구.

Client API는 실제 NAS 경로를 노출하지 않고 서비스 URL과 manifest를 반환합니다. MCP를 사용하면 Codex, Claude Desktop, Hermes 같은 도구에서 버전, 상태, 스캔 작업, 비디오 변환 상태, manifest를 확인할 수 있습니다. 

curl -fsSL https://foliospace.app/install-mcp.sh | sh

foliospace.client_info
foliospace.list_videos
foliospace.open_video_manifest
foliospace.get_video_transcode_queue