EgalitarianMonkey/hometube

어떤 프로젝트인가요?

핵심 기능

• 01yt-dlp가 지원하는 사이트에서 동영상과 재생목록을 다운로드하고 최적의 화질을 선택
• 02다운로드한 파일의 이름을 자동으로 지정해 Plex, Jellyfin 또는 Emby가 스캔할 수 있는 폴더로 이동
• 03SponsorBlock을 연동해 YouTube 동영상의 스폰서 구간을 표시하거나 건너뛰기
• 04동영상 ID를 기준으로 재생목록을 동기화하고, 이름 변경을 감지하며 삭제된 항목을 선택적으로 보관
• 05브라우저 또는 쿠키 파일 인증과 사용자 지정 yt-dlp 인수 지원
• 06클립 자르기, 자막 삽입 및 형식 변환 제공

활용 사례

• 홈 미디어 서버에 광고 없이 오프라인으로 시청할 동영상 라이브러리 구축
• YouTube 재생목록의 로컬 사본을 원본과 동기화
• 교육 또는 튜토리얼 동영상을 가족이 시청할 수 있도록 정리된 폴더에 다운로드
• Docker를 사용해 홈랩에서 공동으로 쓰는 셀프 호스팅 다운로더 실행

빠른 시작

1. 1

   배포 가이드를 읽고 Docker Compose로 배포하세요

사용 전 알아둘 점

• !AGPL-3.0 라이선스로 제공되며, 카피레프트 라이선스에 따라 파생 저작물도 동일한 조건으로 공유해야 합니다.
• !안정적인 다운로드를 위해 쿠키 인증을 설정해야 합니다. README에서는 이를 강력히 권장합니다.
• !README는 셀프 호스팅을 중심으로 설명하므로 직접 서버를 운영해야 하며, 일반적으로 Docker를 사용합니다.

토픽

자주 묻는 질문

hometube은(는) 무엇인가요?

yt-dlp 기반 Streamlit 웹 UI로 동영상과 재생목록을 다운로드해 미디어 서버용 폴더에 정리합니다. HomeTube는 YouTube 및 yt-dlp가 지원하는 다른 사이트에서 동영상을 다운로드한 뒤, Plex, Jellyfin, Emby 같은 미디어 서버가 감시하는 폴더로 완성된 파일을 옮기는 셀프 호스팅 웹 앱입니다. URL을 붙여 넣고 대상 폴더를 선택하면 앱이 형식 선택, 파일 이름 지정, 파일 배치를 처리합니다. UI에서 새 대상 폴더를 만들 수도 있습니다.

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

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

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

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

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

홈 미디어 서버에 광고 없이 오프라인으로 시청할 동영상 라이브러리 구축 YouTube 재생목록의 로컬 사본을 원본과 동기화 교육 또는 튜토리얼 동영상을 가족이 시청할 수 있도록 정리된 폴더에 다운로드 Docker를 사용해 홈랩에서 공동으로 쓰는 셀프 호스팅 다운로더 실행

hometube는 어떻게 설치하나요?

배포 가이드를 읽고 Docker Compose로 배포하세요

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

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