bndct-devops/tome

어떤 프로젝트인가요?

핵심 기능

• 01TomeSync 플러그인으로 KOReader의 독서 세션을 기록하고 읽던 위치를 양방향으로 동기화합니다.
• 02연속 독서 일수, 시간대별 히트맵, 독서 속도, 완독 예상치 등의 독서 통계를 제공합니다.
• 03양면 보기와 RTL 모드를 지원하는 EPUB, CBZ/CBR, PDF용 내장 리더입니다.
• 04e-reader 앱에서 책을 다운로드할 수 있는 OPDS 피드입니다.
• 05Hardcover, Google Books, OpenLibrary에서 메타데이터를 조회하고 차이를 비교할 수 있습니다.
• 06선택적 OIDC 싱글 사인온과 역할 기반 접근 제어를 지원합니다.

활용 사례

• KOReader 기기와 함께 NAS나 홈 서버에서 가정용 전자책 라이브러리를 운영합니다.
• e-reader와 브라우저에서 독서 습관과 진행 상황을 추적합니다.
• 브라우저 기반 리더로 만화나 코믹스 컬렉션을 관리합니다.
• 로컬 네트워크의 e-ink 리더에 OPDS 카탈로그를 제공합니다.

빠른 시작

1. 1

   Docker로 Tome을 시작합니다(컨테이너는 포트 8080에서 실행됩니다).

   docker run -d --name tome --restart unless-stopped -p 8080:8080 -v ./data:/data -v ./books:/books -v ./bindery:/bindery ghcr.io/bndct-devops/tome:latest
2. 2

   http://localhost:8080 을 열고 설정 마법사의 안내에 따라 관리자 계정을 만듭니다.

사용 전 알아둘 점

• !Docker와 실행 중인 Tome 컨테이너가 필요하며, TOME_SECRET_KEY를 설정해야 합니다.
• !KOReader 동기화 기능을 모두 사용하려면 KOReader v2024.07 이상과 사용자 지정 TomeSync 플러그인이 필요합니다.
• !일부 기능은 Hardcover, Google Books 또는 OIDC 서비스를 구성해야 사용할 수 있습니다.
• !네트워크 사용 의무가 따르는 카피레프트 라이선스인 AGPL-3.0에 따라 라이선스가 부여됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

tome은(는) 무엇인가요?

내장 리더, KOReader 읽기 동기화, OPDS 피드, 독서 통계를 제공하며 Docker 이미지 하나로 배포하는 셀프 호스팅 전자책 라이브러리 서버입니다. Tome은 FastAPI, React, SQLite로 만든 셀프 호스팅 전자책 라이브러리 서버입니다. 일반적인 라이브러리 관리 도구와 가장 차별화되는 점은 KOReader 연동입니다. 전용 TomeSync 플러그인이 e-reader에서 독서 세션을 기록하고, 기기가 오프라인일 때도 기기와 웹 인터페이스 간에 읽던 위치를 양방향으로 동기화합니다.

tome은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

tome은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

tome은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. tome의 마지막 커밋은 2026년 11월 3일입니다.

tome은(는) 어디에 사용할 수 있나요?

KOReader 기기와 함께 NAS나 홈 서버에서 가정용 전자책 라이브러리를 운영합니다. e-reader와 브라우저에서 독서 습관과 진행 상황을 추적합니다. 브라우저 기반 리더로 만화나 코믹스 컬렉션을 관리합니다. 로컬 네트워크의 e-ink 리더에 OPDS 카탈로그를 제공합니다.

tome는 어떻게 설치하나요?

Docker로 Tome을 시작합니다(컨테이너는 포트 8080에서 실행됩니다).: docker run -d --name tome --restart unless-stopped -p 8080:8080 -v ./data:/data -v ./books:/books -v ./bindery:/bindery ghcr.io/bndct-devops/tome:latest http://localhost:8080 을 열고 설정 마법사의 안내에 따라 관리자 계정을 만듭니다.

tome은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/bndct-devops/tome