프로젝트 소개

ytdl-sub는 yt-dlp를 통해 미디어 다운로드를 자동화하고, 결과 파일을 Kodi, Jellyfin, Plex, Emby 및 최신 음악 플레이어를 포함한 인기 미디어 플레이어와 서버에 맞게 준비하는 명령줄 도구입니다. README에 따르면 추가 플러그인이나 외부 스크래퍼가 필요하지 않습니다. 작동 방식: 구독은 YAML 파일로 정의됩니다. 각 구독은 미디어 파일을 어떻게 처리하고 출력할지 설명하는 프리셋을 가져옵니다. 이 프로젝트는 많은 사전 구축된 프리셋과 함께 제공되어 사용자가 처음부터 설정을 구축하지 않고도 다운로드를 시작할 수 있습니다. 단일 명령 `ytdl-sub sub subscriptions.yaml`이 파일을 처리합니다. README에 나와 있는 일반적인 사용 사례로는 YouTube 채널을 TV 쇼로 취급하기, 뮤직 비디오와 콘서트 정리, SoundCloud 또는 Bandcamp 디스코그래피 처리 등이 있습니다. README에 따르면 SoundCloud 처리는 beets API를 통해 음악 태그를 작성합니다. 출력은 tv_shows, music, music_videos와 같은 디렉토리로 정렬되며, 미디어 서버에 적합한 썸네일, .nfo 메타데이터 파일, 포스터, 팬아트가 생성됩니다. 설정은 유연합니다: 전역 재정의는 `__preset__` 섹션 아래에 설정할 수 있으며, 옵션은 yt-dlp의 Python API에 직접 전달할 수 있습니다(예: 쿠키 파일). 프리셋은 장르 태그, 콘텐츠 등급을 설정할 수 있으며, "Only Recent" 프리셋을 사용하여 날짜 범위와 파일 수로 다운로드를 제한할 수 있습니다. 커스텀 설정이 지원되며, README에는 단계별 가이드와 예제 설정 링크가 포함되어 있습니다. 나열된 설치 옵션으로는 Docker Compose(Web-GUI, 헤드리스, CPU/GPU 패스스루), Docker CLI, Windows, Unraid, Linux, Linux ARM, PIP, 로컬 설치 및 로컬 Docker 빌드가 있습니다. Web-GUI Docker 이미지는 LinuxServer.io의 code-server 이미지와 사전 설치된 ytdl-sub를 결합한 것으로 설명되며, README에서 권장합니다. 커뮤니티 지원은 Discord 채널, 기능 요청 및 버그 보고를 위한 GitHub Issues, 문서의 FAQ를 통해 이용할 수 있습니다. README는 또한 모든 설정 필드에 대한 자세한 정보를 위해 readthedocs 링크를 제공합니다.