Stacher가 yt-dlp를 사용하는 방식
Stacher는 데스크톱 GUI입니다. URL, 프리셋, 출력 폴더, 인증과 후처리 설정을 모아 yt-dlp 작업을 만듭니다. yt-dlp는 사이트를 인식하고 영상·음성 스트림을 찾고 다운로드하며, 결합이나 변환이 필요하면 FFmpeg를 사용합니다.
대기열이나 저장 설정 문제는 Stacher 측, 추출기·서명·HTTP·형식 메시지는 yt-dlp 측, 병합이나 코덱 오류는 FFmpeg와 관련된 경우가 많습니다. 마지막 일반 오류보다 상세 로그의 첫 구체적 오류를 읽으세요.
| 구성 요소 | 주요 역할 | 확인 정보 |
|---|---|---|
| Stacher | 인터페이스, 대기열, 프리셋, 출력과 구성 요소 관리 | 설정, 경로, branch, 대기열 |
| yt-dlp | extractor, 형식 검색, 요청과 다운로드 | 버전, extractor, HTTP/형식 메시지 |
| FFmpeg | 병합, remux, 변환과 삽입 | 후처리, codec, 실행 파일 오류 |
본인이 소유하거나 저장 권한이 있는 미디어만 다운로드하세요. 업데이트는 비공개, 유료, 삭제 또는 제한 콘텐츠 접근 권한을 주지 않습니다.
관리형 yt-dlp와 사용자 지정 경로
대부분의 사용자는 Stacher 관리형 구성 요소가 안전합니다. Stacher가 위치를 알고 설정에서 업데이트할 수 있습니다. 사용자 지정 경로는 특정 빌드 테스트나 실행 파일 위치를 통제하는 고급 환경에 적합합니다.
흔한 실수는 다른 복사본을 업데이트하는 것입니다. 터미널에서 한 파일을 업데이트해도 Stacher는 오래된 다른 파일을 사용할 수 있습니다. 작업 로그에서 버전과 경로를 확인하고 의도하지 않은 override를 제거하세요.
- 일반 사용은 관리형을 선택합니다.
- 직접 유지할 수 있을 때만 사용자 지정 경로를 씁니다.
- 비슷한 실행 파일을 여러 개 두지 않습니다.
- 경로 변경 뒤 재시작하고 새 로그를 확인합니다.
| 선택 | 적합한 경우 | 위험 |
|---|---|---|
| 관리형 | 일반 설치 | 중단된 업데이트는 재시도가 필요할 수 있음 |
| 사용자 지정 | 고급 테스트/정책 | 오래된 경로, 권한, architecture 불일치 |
| 시스템 패키지 | 관리형 Linux | repository 버전이 늦을 수 있음 |
경로와 branch를 동시에 바꾸지 말고 하나씩 테스트하세요.
Stacher에서 yt-dlp를 안전하게 업데이트하기
로그가 오래된 버전을 표시하거나 Stacher가 업데이트를 알리거나, 이전에 지원되던 사이트에서 최신 yt-dlp가 수정한 extractor 오류가 발생할 때 업데이트하세요. 저장 공간, 출력 폴더, 권한, FFmpeg 문제는 다른 해결이 필요합니다.
업데이트 뒤에는 허용된 공개 URL, 기본 형식, cookies와 사용자 인수 없음, 간단한 로컬 폴더 조건으로 테스트하세요.
- 진행 중인 다운로드를 끝냅니다.
- 설정에서 yt-dlp, update, branch, custom path를 찾습니다.
- 현재 branch와 경로를 기록합니다.
- 업데이트를 실행합니다.
- Stacher를 재시작합니다.
- 허용된 공개 URL 하나를 테스트합니다.
- 상세 로그에서 버전과 경로를 확인합니다.
- 성공 후 추가 옵션을 하나씩 다시 켭니다.
실패 메시지를 정확히 보관하세요. 보안 프로그램, 권한, 네트워크 또는 사용 중인 파일이 교체를 막을 수 있습니다.
stable, nightly, master 선택
stable은 일상 사용의 기본입니다. nightly는 더 자주 바뀌며 다음 stable 전에 최신 extractor 수정이 포함될 수 있습니다. master는 개발 상태에 가깝고 프로젝트 안내에 따른 짧은 고급 진단용입니다.
branch 변경은 특정 수정이 같은 오류를 해결하는지 확인하기 위한 것입니다. stable 버전을 기록하고 같은 URL로 nightly를 시험한 뒤 stable에 수정이 포함되거나 regression이 생기면 돌아오세요.
| Branch | 사용 시점 | 종료 시점 |
|---|---|---|
| Stable | 일상 사용과 첫 진단 | 문서화된 수정 테스트 때만 변경 |
| Nightly | 수정이 stable에 아직 없음 | stable 포함 후 또는 회귀 발생 시 |
| Master | 짧은 고급 진단 | 테스트 직후 |
‘latest’만 쓰지 말고 branch와 버전을 함께 기록하세요.
상세 로그로 Stacher yt-dlp 오류 해결
상세 로그는 오래된 extractor, 잘못된 경로, 후처리 실패를 구분합니다. 첫 구체적 오류, 버전, extractor, 출력 폴더와 사용자 지정 경로·cookies·proxy·인수 사용 여부를 확인하세요. 공유 전 비공개 URL과 세션 정보를 삭제하세요.
포럼의 인수를 무작위로 붙이지 마세요. 오래된 우회 설정이 프리셋을 덮어쓰고 업데이트 뒤 새로운 원인이 될 수 있습니다. 최소 테스트로 돌아간 뒤 필요한 옵션만 추가하세요.
| 로그 증상 | 가능한 원인 | 첫 조치 |
|---|---|---|
| Unsupported URL/extractor | yt-dlp/사이트 | stable 업데이트, 문서화된 수정 때만 nightly |
| 업데이트 후 오래된 버전 | 경로/여러 복사본 | 실행 파일 확인 및 override 제거 |
| 교체 권한 오류 | OS/보안 | 프로세스 종료, 권한·격리 기록 확인 |
| 형식 없음 | 선택/원본 | 기본 선택으로 복귀 |
| FFmpeg 없음 | 후처리 | FFmpeg 설치 또는 경로 확인 |
| 로그인 필요 | 인증 | 허용된 세션과 cookies 가이드 사용 |
| Timeout/DNS | 네트워크 | 다른 허용 주소와 방화벽·프록시 확인 |
마지막 일반 실패 문구보다 첫 구체적 오류가 더 중요합니다.
Windows, macOS, Linux 경로 주의점
Windows에서는 보안 프로그램이 새 실행 파일을 격리하거나 보호 폴더 쓰기를 막을 수 있습니다. Downloads에서 여러 복사본을 실행하지 말고 보호 기록을 확인하세요.
macOS는 Apple silicon 또는 Intel 빌드를 맞추고 권한을 확인하세요. Linux는 패키지, Python 환경과 관리형 구성 요소가 함께 있을 수 있으므로 작업 로그로 활성 복사본을 판단합니다.
출력 폴더와 yt-dlp 실행 경로는 별개입니다. 최종 저장 위치는 로그에 표시됩니다.
- 운영체제와 CPU 아키텍처를 맞춥니다.
- 진단 중 짧은 로컬 경로를 씁니다.
- network나 동기화 폴더는 첫 테스트에서 피합니다.
- Stacher 버전, yt-dlp 버전, branch와 경로를 기록합니다.
2026년 7월 23일 기준 확인된 Stacher 버전은 7.1.11이며 yt-dlp는 별도 주기로 업데이트됩니다.
Stacher yt-dlp 자주 묻는 질문
Stacher에 yt-dlp가 포함되나요?
Stacher는 일반 사용용 yt-dlp를 관리하며 사용자 지정 경로도 지원합니다. 로그로 실제 복사본을 확인할 수 있습니다.
Stacher에서 yt-dlp를 어떻게 업데이트하나요?
작업을 멈추고 설정에서 업데이트한 뒤 재시작하고 허용된 URL을 테스트해 로그에서 버전과 경로를 확인하세요.
nightly를 사용해야 하나요?
기본은 stable입니다. 현재 수정이 문서화된 경우에만 nightly를 임시로 사용하세요.
업데이트 후에도 오래된 버전인 이유는?
다른 복사본이나 사용자 지정 경로를 사용할 수 있습니다. 로그의 실행 파일을 확인하세요.
Stacher는 영상을 어디에 저장하나요?
선택한 출력 폴더에 저장하며 yt-dlp 실행 경로와 별개입니다. 로그에 최종 위치가 표시됩니다.
업데이트가 모든 오류를 해결하나요?
아닙니다. FFmpeg, 저장 공간, 권한, 네트워크, 없는 형식, 계정 제한은 별도 문제입니다.