advplyr/audiobookshelf

어떤 프로젝트인가요?

핵심 기능

• 01모든 오디오 형식을 실시간으로 스트리밍
• 02사용자별 청취 진도를 여러 기기에서 동기화
• 03팟캐스트 검색 및 추가, 에피소드 자동 다운로드
• 04챕터 편집 및 조회, 오디오를 m4b로 병합
• 05EPUB, PDF, CBR, CBZ 전자책 읽기 지원
• 06팟캐스트와 오디오북의 공개 RSS 피드

활용 사례

• 홈 서버나 NAS에서 개인 오디오북 라이브러리 호스팅
• 가족과 오디오북 컬렉션을 공유하면서 각자 청취 진도 관리
• 즐겨 듣는 팟캐스트를 한곳에서 자동으로 다운로드하고 청취
• 청취 진도를 동기화하며 휴대폰이나 브라우저에서 듣기

빠른 시작

1. 1

   Node.js 24와 FFmpeg 설치

2. 2

   서버 종속 항목 설치

   npm ci
3. 3

   웹 클라이언트 빌드

   cd client npm ci npm run generate cd ..
4. 4

   개발 모드로 서버 시작

   npm run dev

사용 전 알아둘 점

• !README의 빠른 시작은 소스에서 개발 환경을 설정하는 방법입니다. 프로덕션 설치는 외부 문서에서만 다룹니다.
• !React로 다시 작성하는 작업이 진행 중이므로 현재 Vue 클라이언트에 대한 프런트엔드 풀 리퀘스트는 검토하거나 병합하지 않습니다.
• !Audiobookshelf는 WebSocket 연결이 필요하므로 리버스 프록시가 이를 지원해야 합니다.

토픽

자주 묻는 질문

audiobookshelf은(는) 무엇인가요?

스트리밍, 사용자별 청취 진도 동기화, 팟캐스트 자동 다운로드를 지원하는 셀프 호스팅 오디오북·팟캐스트 서버 Audiobookshelf는 오디오북과 팟캐스트를 관리하고 들을 수 있는 셀프 호스팅 서버입니다. 모든 오디오 형식을 실시간으로 스트리밍하고, 사용자별 청취 진도를 저장해 여러 기기에서 동기화하며, 사용자마다 권한을 다르게 설정할 수 있습니다.

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

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

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

활발히 유지보수 중. audiobookshelf의 마지막 커밋은 2026년 10월 5일입니다.

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

홈 서버나 NAS에서 개인 오디오북 라이브러리 호스팅 가족과 오디오북 컬렉션을 공유하면서 각자 청취 진도 관리 즐겨 듣는 팟캐스트를 한곳에서 자동으로 다운로드하고 청취 청취 진도를 동기화하며 휴대폰이나 브라우저에서 듣기

audiobookshelf는 어떻게 설치하나요?

Node.js 24와 FFmpeg 설치 서버 종속 항목 설치: npm ci 웹 클라이언트 빌드: cd client npm ci npm run generate cd .. 개발 모드로 서버 시작: npm run dev

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

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/advplyr/audiobookshelf