yt-vod-manager

프로젝트 기반 소스 관리

각 YouTube 채널이나 재생 목록을 이름이 붙은 프로젝트로 등록하며, 설정 파일(config/projects.json)에 URL과 함께 기본 옵션(워커 수, 조각 수, 정렬 순서, 쿠키, 자막 옵션 등)을 저장합니다. 이를 통해 여러 채널을 한 시스템에서 체계적으로 동시에 관리할 수 있습니다.

증분 동기화와 진행 기록

동기화(sync) 명령은 YouTube 소스를 새로 읽어 video_id 기준으로 병합한 뒤 아직 받지 못했거나 다시 시도해야 하는 작업만 내려받습니다. 각 실행은 runs/<run_id>/ 디렉터리에 manifest.raw.json, manifest.jobs.json, run.json 같은 상태 파일을 남기며, 다운로드한 미디어는 기본적으로 runs/<run_id>/downloads/에 저장됩니다. 중단했다가 이어 받아도 이미 끝난 영상은 다시 받지 않습니다.

병렬 다운로드와 전송량 제어

–workers 옵션으로 동시에 여러 영상을 병렬로 내려받을 수 있으며, 기본값은 5입니다. –fragments 10 옵션으로 영상당 스트림 조각 수를 조절하고, –download-limit-mb-s 옵션으로 초당 전송량을 제한할 수 있습니다(0으로 설정 시 무제한). –quality best|1080p|720p 같은 화질 프리셋도 제공됩니다.

자막 및 인증 옵션

–subtitles, –sub-langs 옵션으로 자막 다운로드 여부와 선호 언어(기본 english)를 지정할 수 있고, –browser-cookies 또는 –cookies 옵션을 통해 로그인된 브라우저 쿠키를 활용해 연령 제한 영상에 접근할 수 있습니다. 자막 다운로드는 실패해도 전체 작업이 중단되지 않도록 비치명적으로 처리됩니다.

대화형 매니저와 CLI 보조 기능

yt-vod-manager manage 명령은 터미널에서 방향키와 마법사 형태로 프로젝트를 편집·추가·삭제하고, 활성/비활성 상태를 토글하며, 활성 프로젝트 일괄 동기화와 전역 설정 편집까지 실행할 수 있는 인터랙티브 화면을 제공합니다. 그 밖에도 list, status, settings show, settings set, settings proxy add, self-update 같은 명령으로 프로젝트와 설정을 관리할 수 있습니다.

설치 후 어디에 파일이 저장되나요?

기본적으로 각 동기화 실행(run) 디렉터리 아래의 runs/<run_id>/downloads/ 폴더에 다운로드한 미디어가 저장됩니다. 프로젝트 설정 파일은 config/projects.json 에 보관됩니다.

프로그램을 어떻게 업데이트하나요?

WinGet 사용자는 winget upgrade 로, 그 외 사용자는 npm -g, brew upgrade, 또는 yt-vod-manager self-update 명령으로 GitHub Releases에서 직접 업데이트할 수 있습니다.

자막도 함께 다운로드할 수 있나요?

–subtitles 옵션과 –sub-langs 옵션으로 자막 다운로드 여부와 언어 기본값(기본 english)을 지정할 수 있습니다. 자막 작업은 실패하더라도 전체 동기화를 중단시키지 않도록 비치명적으로 처리됩니다.

여러 영상을 동시에 받을 수 있나요?

–workers 옵션으로 병렬 다운로드 수를 조절할 수 있으며, 기본값은 5입니다. 시스템 환경에 맞춰 값이 높을수록 동시에 받는 영상이 늘어나지만, 네트워크와 디스크 부하가 커질 수 있습니다.