여러 기기에서 이어지는 개인 독서 공간
아이폰에서 듣던 오디오북을 애플 워치로 옮겨 듣고, 코보나 웹에서 읽던 위치를 그대로 이어가는 경험을 해볼 수 있습니다. BookOrbit은 전자책, PDF, 만화, 오디오북을 한곳에 모아두고 여러 기기 간 진행 상황과 하이라이트를 동기화하는 셀프호스팅 도구입니다. 서버를 직접 운영하면서 자신의 독서 데이터를 온전히 관리할 수 있게 됩니다.
안드로이드 앱 베타 테스트 참여
공식 안드로이드 앱이 현재 폐쇄 베타 테스트 단계에 있습니다. 구글 플레이 베타에 참여하고 최소 14일 이상 유지하면 공개 출시를 앞당기는 데 도움이 됩니다. 이 기간 동안 앱의 안정성과 기능을 검증하는 과정이 진행됩니다.
기기 간 독서 경험의 연속성
BookOrbit은 웹, 아이폰, 애플 워치, 코보, KOReader 등 다양한 기기에서 동일한 독서 경험을 제공합니다. 한 기기에서 멈춘 장을 다른 기기에서 바로 이어갈 수 있으며, 하이라이트와 주석도 함께 동기화됩니다. 특히 KOReader 플러그인을 설치하면 기기 내에서 서재 탐색과 다운로드, 상태 관리까지 수행할 수 있습니다. 오디오북은 아이폰에서 스트리밍하거나 다운로드한 뒤 애플 워치로 전송해 오프라인으로 재생할 수 있습니다.
서재 관리와 메타데이터 자동화
서재는 폴더별로 분리하고 스캔 규칙을 커스터마이징하여 관리할 수 있습니다. 구글 북스, 오픈 라이브러리, 아마존, 굿리즈 등 12개의 메타데이터 제공자를 지원하여 책 정보와 표지 이미지를 자동으로 가져옵니다. 하드커버, 리드와이즈, 스토리그래프와 같은 외부 서비스로 독서 상태와 하이라이트를 자동으로 전송하거나, 하드커버의 독서 이력을 가져와 빈 항목을 채울 수도 있습니다. 독서 시간 히트맵, 스트릭, 연간 목표, 성취도 등 50개 이상의 통계와 업적 시스템이 독서 습관을 추적합니다.
설치와 운영 환경
Docker Compose를 사용하여 쉽게 설치할 수 있으며, Postgres 데이터베이스와 함께 실행됩니다. .env 파일에서 서버 URL, 책 파일 경로, 데이터베이스 비밀번호, JWT 시크릿, 초기 설정 토큰을 설정해야 합니다. 책 파일 폴더의 소유자가 UID 1000이 아닌 경우 PUID와 PGID를 일치시켜야 하며, 이 설정 오류는 초기 스캔 시 권한 오류의 가장 흔한 원인입니다. OIDC를 통한 Authentik, Keycloak, Authelia 연동으로 다중 사용자 계정과 SSO를 지원하며, OPDS와 Send-to-Kindle을 통해 콘텐츠를 전달할 수 있습니다.
운영 시 반드시 확인해야 할 저장소 조건
NAS나 네트워크 저장소(SMB, NFS, FUSE, 클라우드 마운트 등)는 지원하지 않습니다. 모든 쓰기 가능한 경로(책 라이브러리, 임포트 폴더, 앱 데이터, Postgres 데이터)는 원자적 이름 변경, 잠금, 파일 알림, 권한, 캐싱, 일관성, 내구성이 보장되는 로컬 파일시스템이어야 합니다. 네트워크 저장소를 사용하면 간헐적 실패, 불완전한 이동, 오래된 라이브러리 상태, 데이터 손실 또는 손상 등이 발생할 수 있으며, 이러한 환경에서의 문제는 지원 대상이 아닙니다. 또한 API는 공식 클라이언트와의 호환성을 유지하지만, 제3자 클라이언트와의 안정적 통합을 보장하지 않으므로 공식 앱, OPDS, 코보 동기화, KOReader 플러그인을 사용하는 것이 권장됩니다.