# yt-dlp 사용 방법

Linux를 중심으로 nightly 버전 설치, 형식, 자막, 데이터셋, 수집 작업 재개를 다루는 가이드입니다.

Canonical 참고: https://flashdata.dev/ko/docs/guides/how-to-use-yt-dlp
검토: 2026-11-13 FlashData

- [도구를 설정하라](https://flashdata.dev/ko/docs/guides/how-to-use-yt-dlp/reference.md#install) — Python, FFmpeg 및 JavaScript에 대한 자세한 내용
- [생산을 선택하라](https://flashdata.dev/ko/docs/guides/how-to-use-yt-dlp/reference.md#formats) — 비디오, 오디오 및 캡처
- [컬렉션을 반복하십시오](https://flashdata.dev/ko/docs/guides/how-to-use-yt-dlp/reference.md#repeatable) — 메니페스트, 컨피그 및 아카이브
- [실패한 경주를 고치고](https://flashdata.dev/ko/docs/guides/how-to-use-yt-dlp/reference.md#maintain) — 올바른 진단을 찾으십시오.

<a id="install"></a>

## 매일 사용하는 바젤 라인을 설치합니다.


**Nightly + Deno + FFmpeg로 시작합니다.** 프로젝트 가상 환경을 사용하여 `--impersonate=""`로 브라우저 인식을 활성화합니다.Linux 설정 아래에는 도구가 설치되며 macOS 및 Windows 옵션이 탭에 있습니다.

**Linux**

Python 3.11+와 함께 Ubuntu / Debian 예를 설치 시스템 도구, 프로젝트 가상 환경을 만들고, 그 다음에 현재 밤 및 그것의 추가를 설치합니다.


**Linux 작업자 설정**

```bash
sudo apt-get update
sudo apt-get install -y python3 python3-venv ffmpeg aria2 curl unzip
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
curl -fsSL https://deno.land/install.sh -o /tmp/install-deno.sh
sh /tmp/install-deno.sh
export PATH="$HOME/.deno/bin:$PATH"
deno --version
python -m yt_dlp --version
```


**macOS**

Homebrew 설치된 경우 Python, Deno, FFmpeg 및 aria2에 사용하십시오. yt-dlp 프로젝트 환경에서 자신을 유지하므로 밤 업데이트 명령은 Linux와 동일합니다.


**macOS 설정**

```bash
brew install python deno ffmpeg aria2
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
python -m yt_dlp --version
```


**Windows · PowerShell**

Python 3.11+, Deno 및 FFmpeg 실행기를 설치한 다음 새로운 터미널을 열어보세요. PowerShell이 활성화를 차단하는 경우 환경의 번역기를 직접 사용하십시오. aria2는 선택적입니다; 외부 다운로드 레시피를 사용하는 경우 별도로 설치합니다.


**Windows 환경**

```powershell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U --pre "yt-dlp[default,curl-cffi]"
deno --version
ffmpeg -version
.\.venv\Scripts\python.exe -m yt_dlp --version
```


| 의 특징 | 무엇을 하는가 | 확인 |
| --- | --- | --- |
| Python 3.11+ | 이 시리즈에서 Python 패키지와 예를 실행합니다. | python --version |
| yt-dlp 밤에 + 기본,curl-cffi 추가 | 현재 YouTube 추출기, EJS 솔버와 브라우저 인식 지원과 일치합니다. | python -m yt_dlp --version |
| FFmpeg 및 ffprobe | 흐름을 합병하고, 오디오를 변환하고, 클립을 잘라내고, 저장된 미디어를 검사합니다. | ffmpeg -version / ffprobe -version |
| 덴오 2.3+ (이 작업 흐름에 필요한) | YouTube 도전을 실행합니다.이 작업은 개발 기계뿐만 아니라 모든 직원에게 설치됩니다. | deno --version |

**행동도 설치합니다.** `[default]` EJS 스크립트를 공급; Deno는 분리되어 있습니다. FFmpeg 및 ffprobe 또한 노동자의 PATH에 있어야합니다.

**전체 바젤을 확인하세요.**

```bash
deno --version
ffmpeg -version
ffprobe -version
python -m pip show yt-dlp yt-dlp-ejs curl-cffi
python -m yt_dlp --list-impersonate-targets
```

최종 명령은 사용 가능한 브라우저 목표를 나열해야 합니다. 목표가 사용할 수 없는 경우 curl-cffi가 정확한 가상 환경에 설치되어 있는지 확인합니다.

**Deno와 브라우저 인상화 테스트 추출**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

JS 실행 시간 및 요청-수매 라인을 검사합니다. 시뮬레이션 추출 테스트; 실제 전송으로 추적합니다.

FlashData의 운영 기본에는 --impersonate="가 포함되어 있습니다 : curl-cffi가 사용 가능한 브라우저 지문을 선택할 수 있습니다. 이 요청 지문을 변경; 로그인 쿠키를 제공하지 않으며, JavaScript 도전을 해결하거나 출력 IP를 변경하지 않습니다. 이 옵션이 작업 경로를 느리게하거나 오류를 입력하면 동일한 단일 비디오 테스트를 반복하고 작업 구성을 유지합니다.

> **서비스는 자신의 경로를 필요로합니다.**
> Deno 설치기는 일반적으로 ~/.deno/bin.에 바이너리를 배치합니다. 그것을 찾는 상호 작용 쉘은 시스템d 서비스, 컨테이너 또는 cron 작업이 할 수있는 것을 증명하지 않습니다. 일자리를 설정하거나 --js-runtimes deno를 통과하십시오:/absolute/path/to/deno. 서비스 명령에서 가상 환경의 Python 경로를 사용하십시오.

- [공식 설치](https://github.com/yt-dlp/yt-dlp/wiki/Installation)
- [FFmpeg 다운로드](https://ffmpeg.org/download.html)
- [설치 데노](https://docs.deno.com/runtime/getting_started/installation/)
- [YouTube 실행 시간 설정](https://github.com/yt-dlp/yt-dlp/wiki/EJS)

<a id="verify-install"></a>

### 노동자에 넣기 전에 풀어주기 전에 확인하십시오.


공식 프로젝트의 출시 페이지에서 실행을 얻거나, 공개된 패키지 출처에서 Python 패키지를 설치합니다. 단일 바이너리를 다운로드하면 SHA-256와 해당 버전의 SHA2-256SUMS에 해당하는 파일 이름을 비교하십시오. 릴리스와 체크스모를 직원의 이미지로 기록하여 정확히 무엇이 진행되었는지 확인할 수 있습니다.

**Linux**


**다운로드된 파일을 해시**

```bash
sha256sum yt-dlp
```


**macOS**


**다운로드된 파일을 해시**

```bash
shasum -a 256 yt-dlp_macos
```


**Windows**


**다운로드된 파일을 해시**

```powershell
Get-FileHash -Algorithm SHA256 .\yt-dlp.exe
```


체크스모 비교는 예상 값이 신뢰할 수 있는 배출에서 나온 경우에만 유용하며, 실행 가능한 것과 같은 알려지지 않은 거울이 아닙니다. 보안 소프트웨어가 파일을 깃발로 만드는 경우, 예외를 만들기 전에 파일의 출처와 보고서를 조사하십시오. 오픈소스 이용 가능성만으로는 모든 다운로드 된 바이너리 또는 제 3 자 플러그인이 안전하다는 증거가 아닙니다.

공유 구성 파일을 코드로 검토하십시오 : --exec와 같은 옵션은 명령을 시작할 수 있으며 플러그인은 다운로드 프로세스에 코드를 추가합니다. 브라우저 쿠키, 프로시 인증서 및 서명 URL을 구성 예제 및 진단 보고서에서 유지합니다.

- [공식 발표 및 체크스](https://github.com/yt-dlp/yt-dlp/releases)

<a id="first-download"></a>

## 1 비디오 다운로드


**먼저 짧은 비디오를 사용하십시오.** URL을 인용하고 `--no-playlist`를 추가하고 비디오 ID로 파일을 지정합니다.

**1개의 비디오, 1개의 출력 폴더**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -P downloads \
  -o "%(id)s.%(ext)s" --print after_move:filepath \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

인쇄된 경로는 합병 후 파일입니다.이 경로를 열고, 파일이 .mp4로 끝날 것이라고 가정하지 마십시오.

형식이 과장되지 않고 yt-dlp는 선호하는 사용 가능한 스트림을 선택합니다. 고품질의 소스는 종종 별도의 비디오 및 오디오 스트림을 가지고 있으므로 FFmpeg 합병에 따라 두 개의 전송이 정상입니다. 중간 파일 및 .part 파일이 작업이 실행되는 동안 나타날 수 있습니다.

> **확장 프로그램을 단단히 코드하지 마십시오.**
> %(ext)s를 출력 템플릿에 저장합니다. WebM 스트림 file.mp4을 이름으로 지정하면 이름만 변경합니다. 형식 선택, 재구성 및 변환은 파일 내부에 무엇이 있는지 결정합니다.

<a id="formats"></a>

## 품질 및 코덱 선택


**이 비디오의 형식을 확인하십시오.**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**본화된 형식 ID가 아닌 정책을 선택합니다.** 해상도, 코덱 및 별도의 audio/video 트랙을 확인합니다.

| 선택 또는 옵션 | 은둔 | 언제 사용해야 할지 |
| --- | --- | --- |
| BV + 바 | 단일 비디오 스트림과 오디오 스트림을 선택하십시오; FFmpeg 그들을 결합합니다. | 두 개의 트랙이 필요하며 지역적으로 합병할 수 있습니다. |
| A/B | 선택 A를 시도하고, A가 사용할 수 없는 경우 B를 시도합니다. | 각 출처가 동일한 형식을 가지고 있다고 가정하는 대신 명시적인 붕괴를 정의하십시오. |
| [height<=1080] | 1080 픽셀 위의 스트림을 제외합니다. | 튼튼한 상단 묶음은 요구 사항입니다. |
| -S res:1080 | 1080까지 해상도를 선호하며, 아래의 하나가 없을 때 더 큰 하나를 선택할 수 있습니다. | 1080p 하드 지붕보다 선호하는 것입니다. |
| --merge-output-format mp4 | 개별 흐름을 결합할 때 컨테이너를 선택합니다. | 이미 호환되는 스트림을 선택했습니다.그것은 transcode 코덱을 수행하지 않습니다. |

**1080p 하드 지붕을 가진 원본 코덱을 유지하십시오.**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv*[height<=1080]+ba/b[height<=1080]" -P downloads \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

WebM, MP4 또는 다른 지원 컨테이너를 생산할 수 있습니다.그것은 형식이 지붕에 맞지 않으면 실패합니다; 그것은 조용히 다운로드하지 않습니다 4K.

H.264 비디오 및 AAC 오디오를 구체적으로 요구하는 편집기 또는 재생 스택의 경우, 이러한 코덱을 필터링하고 MP4로 합병하십시오. MP4는 컨테이너입니다: MP4 컨테이너에 있는 흐름은 여전히 코덱을 포함할 수 있습니다.

**요청 H.264 + AAC, 최대 1080p**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bv[vcodec^=avc1][height<=1080]+ba[acodec^=mp4a]/b[vcodec^=avc1][acodec^=mp4a][height<=1080]" \
  --merge-output-format mp4 -P downloads "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

필요한 코덱이 사용할 수없는 경우, 이 엄격한 선택기는 실패합니다.다양한 소스 코덱 또는 트랜스 코드를 받아들이는지 여부를 결정; 원인을 무작위로 제거하지 마십시오.

Remuxing은 다시 암호화하지 않고 흐름을 재팩합니다. Transcoding은 코덱을 변경하고 CPU를 소비하면서 잠재적으로 품질을 변경합니다. --remux-video를 사용하면 이미 흐름이 대상 컨테이너에 맞게 되며, FFmpeg 변환을 사용하면 아래 스트림 디코더가 다른 코덱을 필요로 한다.

<a id="audio"></a>

## 오디오 또는 MP3를 저장


트랜스피어 파이프 라인이 소스 오디오 코덱을 받아들이면, 그 스트림을 직접 다운로드합니다. 이것은 불필요한 손실 변환을 방지합니다. MP3는 소비자가 구체적으로 그것을 요구할 때 유용합니다; 높은 MP3 비트라이트는 이미 원본에서 잃어버린 세부 사항을 복구 할 수 없습니다.

**최상의 오디오 스트림을 유지하십시오.**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -P audio \
  -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

원본 컨테이너와 코덱을 기대하십시오, 일반적으로 M4A/AAC 또는 WebM/Opus.

**오디오를 MP3로 변환합니다.**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist -f ba -x \
  --audio-format mp3 --audio-quality 0 -P audio -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

FFmpeg 필요합니다. --audio-quality 0는 최상의 변수 품질 설정을 선택합니다; 192K와 같은 비트 속도를 사용하면 아래 스트림 사양이 하나를 필요로합니다.

<a id="sidecars"></a>

## 캡션 및 메타 데이터를 저장


유용한 컬렉션은 필레나임보다 더 많은 것을 필요로합니다. 비디오 ID, 출처 URL, 제목, 기간 및 사용 가능한 캡션을 유지하여 컬렉션을 검색하고 자산을 다시 출처로 추적 할 수 있습니다. 탭 트랙을 나열하여 시작하십시오; en를 요청하는 것은 모든 비디오가 영어 트랙을 가지고 있음을 의미하지는 않습니다.

**캡처를 검사하고 미디어없이 영어 트랙을 저장합니다.**

```bash
python -m yt_dlp --list-subs "https://www.youtube.com/watch?v=jNQXAC9IVRw"
python -m yt_dlp --skip-download --write-subs --write-auto-subs --sub-langs "en.*" \
  --sub-format "vtt/best" -P captions -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

--write-subs는 공급된 하위 제목을 선택하고 --write-auto-subs는 자동 캡처를 허용합니다.이것은 기존 트랙을 복구하고 아무것도 없는 비디오를 전송하지 않습니다.

**미디어 메타 데이터와 템플릿**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist --write-info-json \
  --write-thumbnail -P downloads -o "%(id)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

.info.json 파일은 세부적인 운영 메타 데이터이며, 순수한 공공 API 응답이 아닙니다. 그것은 만료 미디어 URL 및 요청 관련 필드를 포함 할 수 있습니다. 컬렉션과 함께 전체 측면을 유지하고, 당신의 아래 스트림 시스템 요구 필드만 수출합니다. SRT 대신 VTT를 필요로 하는 경우 --convert-subs srt를 추가하고 FFmpeg가 사용할 수 있는지 확인하십시오.

<a id="dataset"></a>

## AI 데이터 세트 항목을 만드는 방법


훈련 컬렉션을 위해, 미디어와 텍스트 출력을 함께 결정합니다. 일반적인 요구 사항은 MP4에 합쳐있는 최고의 사용 가능한 비디오 및 오디오이며, 동일한 비디오 ID 아래에 시간표 캡션 및 추출 메타 데이터가 보관됩니다. 예비 보기에 유용한 해상도 지붕은 일반적으로 소스 품질 데이터 세트에 대한 잘못된 기본입니다.

**1개의 완전한 데이터 세트 항목을 다운로드**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  -f "bestvideo+bestaudio/best" \
  --merge-output-format mp4 --remux-video mp4 \
  --write-info-json --write-subs --write-auto-subs \
  --sub-langs "en" --sub-format "vtt/best" \
  --sleep-subtitles 5 --concurrent-fragments 1 \
  -P dataset -o "%(id)s/%(id)s.%(ext)s" \
  --print after_move:filepath "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

FFmpeg는 별도의 흐름을 결합; --remux-video는 또한 결합 흐름의 붕괴를 커버합니다. --list-subs에서 정확한 언어 태그를 사용하십시오; 데이터 세트 요구 사항의 언어로 렌을 교체합니다.

정확한 언어로 시작하십시오. 우리의 라이브 체크에서, en.* 선택 en, en-en 및 en-de; 세 번째 트랙은 미디어 다운로드가 시작되기 전에 429로 돌아 왔습니다. 탭 오류가 그 단계에서 항목을 멈출 수 있습니다. 냉각 후, 필요한 트랙만 끌어 내거나, 수집이 미디어 섭취를 움직이게해야하는 경우 미디어와 탭 작업을 분할합니다.

/best fallback은 별도의 트랙이 사용할 수 없을 때 조합 video/audio 스트림을 허용합니다. 수집 계약이 별도의 bestvideo 및 bestaudio 소스를 필요로하는 경우 그 붕괴를 제거합니다. MP4는 H.264를 의미하지 않습니다: 이 요리법은 선택한 출처 코덱을 유지합니다. 위의 엄격한 H.264/AAC 선택기를 사용하십시오, 당신의 훈련 디코더는 그 코덱을 필요로하는 경우, 또는 별도의, 기록 된 단계로 트랜스코드.

**예상되는 파일은 영어 탭 트랙이 존재할 때**

```text
dataset/VIDEO_ID/
  VIDEO_ID.mp4
  VIDEO_ID.info.json
  VIDEO_ID.en.vtt
```

caption suffix는 실제 언어 태그를 사용합니다.No caption file is created when the requested track is unavailable; not mark text coverage complete just because the MP4 is finished.

| 관련 상품 | 수집 결정 |
| --- | --- |
| 가장 높은 품질의 사용 가능한 소스 | Bestvideo+bestaudio를 사용하고, 소스 코덱을 유지하고 ffprobe로 혼합 된 스트림을 확인합니다. |
| 시간표 텍스트 | VTT/SRT 섹션과 언어를 비디오 ID 옆에 유지합니다.플래팅 텍스트는 클립 조정에 필요한 타이밍을 차단합니다. |
| 캡션 누락 | 텍스트가 명시적으로 실종된 것을 기록하십시오.이 텍스트가 의무적 인 경우 저장된 오디오를 트랜스피크 단계로 이동합니다. |
| 많은 언어를 위한 캡틴 | 각 추가 트랙은 요청을 추가하고 미디어에 관계없이 429를 만날 수 있습니다. |
| 리소스 미디어 + 텍스트 배달 | 별도의 데이터 세트 아카이브와 미디어, 메타 데이터 및 탭 상태를 가진 인증서를 사용합니다.아카이브 입력은 필요한 모든 페이지가 존재한다는 것을 증명하지 않습니다. |

이 새로운 정책을 위해 이전 미디어에 의해 만들어진 아카이브를 다시 사용하지 마십시오 : 그들의 실종 된 캡처가 수집되기 전에 아카이브 된 비디오가 삭제 될 수 있습니다. 데이터 세트 정책을 자신의 아카이브로 실행하거나 텍스트가 없어지는 ID에 대한 별도의 탭 수리 패스를 계획하십시오. 원본 캡션을 저장하십시오; 모델이 깨끗한 트랜스크립트 텍스트를 필요로하는 경우, 버전화 된 처리 단계에서 추출합니다.

- [Python에서 동일한 데이터 세트 레시피](https://flashdata.dev/ko/docs/guides/yt-dlp-python-api/reference.md#dataset)
- [핸들 캡처 및 메타 데이터 429s](https://flashdata.dev/ko/docs/guides/yt-dlp-429-too-many-requests/reference.md)

<a id="aria2"></a>

## IP를 과장하지 않고 전송 전송을 향상시킵니다.


aria2c 단일 연결이 신뢰할 수 없는 또는 고속 링크를 사용하는 경우에 도움이 될 수 있습니다. 거절된 플레이어 요청이나 깃발이 있는 출력 IP를 수정할 수 없습니다. 먼저 원주민 다운로드기를 하나의 출처에서 작동하십시오; 그 다음 전송 시간과 오류를 aria2 연결의 작은 수와 비교하십시오.

**HTTP 전송에 따라 두 개의 연결으로 시작합니다.**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader aria2c --downloader "dash,m3u8:native" \
  --downloader-args "aria2c:-x 2 -s 2 -j 1" \
  --concurrent-fragments 1 \
  -P downloads -o "%(id)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

aria2 먼저 설치하십시오. DASH/HLS는 여기에서 원주민 다운로드기와 함께 유지하여 세그먼트 경쟁이 명시적으로 유지됩니다.

| 통제 | 무엇을 제한하는가 |
| --- | --- |
| aria2c -x 2 | 다운로드를 위한 하나의 서버에 연결 |
| aria2c -s 2 | 하나의 파일에 대한 요청 분할; 분할 또한 파일 크기와 서버 지원에 따라 달라집니다. |
| aria2c -j 1 | aria2 호소 내의 상호 항목, 다른 yt-dlp 노동자가 아닌. |
| --concurrent-fragments 1 | DASH/HLS 내부 다운로드에 있는 부분을 다운로드합니다. |
| 당신의 직업은  ⁇ | 동일한 호스트 또는 프로키스 출력 IP를 공유하는 전체 활성 비디오. |

curl-cffi 인상은 yt-dlp의 자신의 요청에 속하며 aria2의 TLS 지문을 설정하지 않습니다. 원주민 다운로드가 작동하지만 aria2가 403를 얻는 경우, 원주민으로 돌아가서 관련되지 않은 추출기 설정을 변경합니다. 추출 및 외부 전송을 동일한 프로시 세션에 유지합니다.

FlashData의 작동에서 경쟁력을 너무 공격적으로 올리는 것은 작업 경로가 즉시 403로 돌아오기 시작할 수 있습니다. 이런 일이 일어나면 다른 직업을 중단하고, 한 명의 노동자와 한 명의 연결으로 돌아가서 다시 시험하십시오. aria2 더 많은 분할을 추가하거나 동일한 거부 된 흐름을 동시에 퇴각하여 보상하지 마십시오. 그 IP가 낮은 부하에서 거부되는 경우 403 IP 대체 작업 흐름을 사용합니다.

**비교를 위한 보수적 인 원주민 전송**

```bash
python -m yt_dlp --js-runtimes deno --impersonate="" --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M \
  --sleep-requests 2 --sleep-interval 5 --max-sleep-interval 10 \
  -P diagnostics "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

2M는 진단 밴드 폭 캡, 유니버설 유튜브 한도가 아닙니다.

- [aria2 연결 및 분할 옵션](https://aria2.github.io/manual/en/html/aria2c.html)
- [403 복구 명령](https://flashdata.dev/ko/docs/guides/yt-dlp-403-forbidden/reference.md#rate)
- [메타 데이터 및 캡션에 대한 속도 제어](https://flashdata.dev/ko/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="collections"></a>

## 컬렉션을 준비하라


작은 알려진 세트를 위해, 라인 당 한 시계 URL을 가진 UTF-8 urls.txt를 만드십시오. YouTube 플레이리스트를 위해, 먼저 ID를 메니지로 나열합니다. 플래트 추출은 각 비디오에 대한 완전한 추출을하지 않고 플레이리스트 목록을 검사합니다; 그것은 범위 검토에 유용하지만, 그것의 입력은 기간, 형식 및 사용 가능성 세부 사항이 부족할 수 있습니다.

**YouTube 플레이리스트 마니플을 만드는 방법**

```bash
python -m yt_dlp --flat-playlist --print "https://www.youtube.com/watch?v=%(id)s" \
  "https://www.youtube.com/playlist?list=YOUR_PLAYLIST_ID" > urls.txt
```

YOUR_PLAYLIST_ID를 대체하십시오. urls.txt를 확인하십시오. 미디어 전송을 시작하기 전에.

한 컬렉션을 시험하려면 --playlist-items 1 :5로 몇 개의 플레이리스트 입력을 선택합니다. 채널의 /video 탭은 차이한 채널 홈 페이지보다 업로드 된 비디오에 대한 명확한 출발점입니다. 플레이리스트 명령을 정체성으로 취급하지 마십시오 : 항목을 입력, 다시 주문하거나 제거 할 수 있습니다.

| 필터 | 제품 정보 | 결과 |
| --- | --- | --- |
| --playlist-items 1:5 | 현재 목록에 있는 첫 5개의 글입니다. | 작은 시험에 유용하고 지속적인 체크 포인트가 아닙니다. |
| --dateafter 20260101 | 2026년 1월 1일 또는 이후에 기록된 항목을 유지합니다. | 날짜 필터링은 여전히 per-video 추출을 필요로 할 수 있습니다. |
| --match-filters "!is_live & duration <= 1800" | 알려진 기간이 가장 30 분의 비생물 항목을 요구합니다. | 알려지지 않은 기간의 입력은이 엄격한 필터와 일치하지 않습니다. |
| --download-archive archive.txt | 이전 다운로드에서 이미 기록된 출처 ID를 스키합니다. | 변경된 제목과 플레이리스트 위치를 통해 작업합니다. |

<a id="repeatable"></a>

## 안전하게 컬렉션을 다시 만들기


다음을 yt-dlp-work.conf로 수집 폴더에 저장하고 urls.txt 옆에 있습니다. 그것은 한 번에 생산 정책을 정의하고, 컬렉션에 자신의 아카이브를 제공하고, 퇴보를 제한합니다. 출력 파일과 이 아카이브를 함께 유지하십시오 : 아카이브는 추출기와 ID에 의해 성공을 기록하고 현재 파일의 체크 수 또는 위치에 의해 기록되지 않습니다.

**yt-dlp-work.conf**

```text
# YouTube worker baseline
--js-runtimes deno
--impersonate=""
--concurrent-fragments 1

# Output policy
--no-playlist
-f "bv*[height<=1080]+ba/b[height<=1080]"
-P downloads
-o "%(channel_id)s/%(id)s.%(ext)s"
--write-info-json

# Resume and remember completed media
--continue
--download-archive archive.txt
--no-abort-on-error

# Bound each attempt and spread out work
--retries 5
--fragment-retries 5
--socket-timeout 30
--sleep-requests 1
--sleep-interval 5
--max-sleep-interval 10

# Append paths only after the final move
--print-to-file after_move:filepath completed-paths.txt
```

깔끔한 텍스트 구성, 라인에 한 가지 옵션.이 예제의 경로는 작업 디렉토리와 관련이 있습니다. 일정자가 다른 곳에서 시작할 수 있는 절대 경로를 사용합니다.

**컬렉션을 실행하세요**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf --batch-file urls.txt
```

--ignore-config는 지시적 user/system 구성을 제거하고, 명시적으로 공급된 --config-locations 파일은 여전히 충전됩니다.

끊임없이 같은 명령을 반복합니다. 완성된 ID는 삭제되며, 반복 가능한 부분 전송은 지원되는 곳에서 계속됩니다. 추출 실패는 다음 라운드에서 재검토 될 수 있습니다. 기본 .part 파일은 유용한 상태입니다; 일상적인 탈퇴 단계로 그들을 삭제하지 마십시오.

> **별도의 출력에 대한 별도의 아카이브**
> archive.txt의 단일 ID는 MP3, 1080p 및 4K를 구별하지 않습니다. 다른 출력 정책에 대해 다른 파일을 사용합니다. 미디어 파일을 삭제하지만 아카이브 입력을 유지하면 yt-dlp은 여전히 그것을 놓칠 것입니다. 나중에 파일을 클라우드 저장소로 업로드하면 로컬 다운로드 성공과 별도로 업로드 성공을 기록합니다.

--no-abort-on-error 과거에 계속 불가능한 입력, 그러나 실행은 여전히 밖으로 나갈 수있다 nonzero 및 포스트 처리 오류는주의를 필요로. --ignore-errors를 추가하는 것을 피하십시오 단순히 녹색 직업을 얻으려면: 그것은 성공적인 다운로드로 처리 후 실패를 처리 할 수 있습니다. 수집이 완료되기 전에 기록을 검토하고 완료 된 출력.

<a id="verify"></a>

## 완성된 파일을 확인하세요.


completed-paths.txt 파일은 유용한 시작 기록입니다. ffprobe 컨테이너를 읽고 스트림 메타 데이터를 흐르며, 별도의 디코딩 패스는 독서 가능한 헤더만 놓칠 문제를 캡처합니다.

**1 개의 완성된 파일을 확인합니다.**

```bash
ffprobe -v error -show_entries format=duration,size:stream=codec_type,codec_name,width,height -of json "downloads/CHANNEL_ID/VIDEO_ID.mp4"
```

completed-paths.txt에서 하나로 경로를 교체하십시오. 기대 기간, 필요한 audio/video 스트림 및 디코더 호환 코덱을 확인합니다.

**선택적 인 완전한 디코드 체크**

```bash
ffmpeg -v error -i "downloads/CHANNEL_ID/VIDEO_ID.mp4" -f null -
```

새로운 미디어 출력을 만들지 않고 전체 파일을 읽고 해독합니다. 출력 상태와 메시지를 확인하십시오; 이것은 ffprobe보다 더 오래 걸립니다.

| 찾기 | 해결 방법 |
| --- | --- |
| 단 하나의 .part 또는 별도의 스트림 파일만 남아 있습니다. | transfer/merge 오류를 확인하고 원래 작업을 다시 시작하십시오; 중간 파일 완료를 표시하지 마십시오. |
| 소리 없이 비디오를 재생합니다. | 선택한 형식과 ffprobe 스트림을 검사합니다.비디오만 형식은 오디오 선택과 합병이 필요합니다. |
| MP4 편집기에서 열리지 않을 것입니다 | 코덱을 검사하고 단순히 확장 프로그램이 아닙니다; 명시적으로 호환되는 스트림 또는 트랜스코드를 선택합니다. |
| 파일 ID, 하지만 현지 파일이 없습니다. | 파일이 moved/deleted.인지 확인 하려면 아카이브 입력을 변경 하기 전에 저장소를 다시 합쳐. |

<a id="schedule"></a>

## 9 입증된 명령을 일정한 작업으로 이동


전체 명령을 성공적으로 수동으로 실행하십시오.이 명령을 계획하기 전에. 일정은 일반적으로 다른 PATH와 작업 디렉토리로 시작됩니다. 가상 환경의 전체 Python 경로, 전체 Config 경로 및 명시적인 작업 디렉토리를 제공하고 FFmpeg 및 JavaScript 실행 시간을 그 과정에 사용할 수 있도록하십시오.

- collection/archive.에 대한 단일 노동자를 사용하십시오 어제의 실행이 오늘의 실행을 동일한 출력으로 넘어서는 안됩니다.
- Linux에서 timer/service 또는 cron 입력을 사용하여 작업 디렉토리와 폴크와 같은 잠금을 사용합니다.
- macOS에서 절대 실행 가능 및 작업 지침 경로를 사용하여 시작합니다.
- Windows Task Scheduler에서 환경의 python.exe에 프로그램을 설정하고, -m에 대한 논쟁 yt_dlp 플러스 구성 및 배치 옵션을 설정하고, 컬렉션 폴더로 시작합니다.
- 기록 start/end 시간, 실행 가능한 버전, 출처 표시, 출력 상태 및 completed/failed 계산.
- 쿠키 파일 및 목적 인증서를 공유 구성 리포트에서 유지합니다.일을 제공하는 것은 그것이 필요로하는 인증서만 제공합니다.

잠의 옵션은 하나의 과정 내에서 작동합니다. 동일한 설정을 사용하는 10명의 노동자는 여전히 10개의 흐름이 넘어오는 요청을 생산한다. --concurrent-fragments를 증가시키는 것은 다운로드 내부의 조각 경쟁을 변경하고, 작업 쿼리에있는 비디오 수가 아닙니다.

<a id="maintain"></a>

## 올바른 오류 가이드를 선택하십시오.


**이 Python 환경을 업데이트**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
```

이전 작업 소스가 끊어지면 최신 밤에 첫 번째로 업데이트, 해당 추가를 포함합니다. yt-dlp --update-to 밤에 사용하는 단일 이중 사용을 위해; -U 혼자 현재 채널에 머무르고 있습니다. 각 업데이트 후 작은 캐나다를 실행하고, 그 다음에 노동자를 재건하고 수정 사항을 기록하여 함대가 조용히 릴리스를 혼합하지 않도록합니다.

| 학회소개 | 여기서 시작 |
| --- | --- |
| `Requested format is not available` | 포맷을 목록하고 철저한 필터를 검사하기 전에 퇴색을 변경합니다. |
| `ffmpeg not found` / `ffprobe and ffmpeg not found` | 실제 직원 또는 일정 계정에서 PATH를 확인합니다. |
| JavaScript 도전 / 실종 실행 시간 경고 | 실행 시간 탐지 및 EJS 패키지와 일치하는 것을 확인합니다. |
| HTTP 403 전송 기간 동안 | 거부된 호스트와 단계를 식별; 미디어 전송에서 분리 된 추출. |
| HTTP 429 | 영향을받는 IP를 중단하고, 냉각 및 extraction/caption 요청 주파수를 낮추십시오. |
| `Sign in to confirm you’re not a bot` | 배치를 중단하고 하나의 출처, 세션 및 네트워크를 진단합니다. |

- [403 진단 작업 흐름](https://flashdata.dev/ko/docs/guides/yt-dlp-403-forbidden/reference.md)
- [Bot-check 진단 작업 흐름](https://flashdata.dev/ko/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [429 수익률 회복](https://flashdata.dev/ko/docs/guides/yt-dlp-429-too-many-requests/reference.md)
- [매일 명령 참조](https://flashdata.dev/ko/docs/guides/yt-dlp-commands/reference.md)
- [Python 노동자를 만드는 방법](https://flashdata.dev/ko/docs/guides/yt-dlp-python-api/reference.md)

<a id="managed-downloads"></a>

## 생산량이 클라우드 파이프라인에 속하는 경우


다운로드기를 소유하고 싶다면 위의 작업 흐름은 파일, 형식 및 처리에 대한 통제를 제공합니다. 응용 프로그램이 저장에 제공되는 완성 된 미디어가 필요하다면 FlashData는 추적 된 YouTube 다운로드 작업, 보트 처리, 프로키 라우팅 및 리트리지를 제공합니다. 귀하의 응용 프로그램은 출처 및 출력 설정을 제출하고 직업 ID 및 배달 기록을 유지합니다.

- [두 개의 운영 모델을 비교하십시오.](https://flashdata.dev/ko/docs/guides/flashdata-vs-yt-dlp/reference.md)
- [YouTube 동영상 일괄 다운로드](https://flashdata.dev/ko/products/youtube-download#bulk-downloads)
- [다운로드 데모를 시도해 보세요.](https://flashdata.dev/ko/products/youtube-download#playground)
- [API 참조 다운로드](https://flashdata.dev/ko/docs/sources/youtube_download/reference.md)

<a id="references"></a>

## 참조 자료


업스트림 옵션 참조는 설치된 버전의 진실의 근원입니다.이 섹션을 사용하여 수집 정책을 변경하거나 노동자 이미지를 업데이트합니다.

- [선택 및 분류를 위한 포맷](https://github.com/yt-dlp/yt-dlp#format-selection)
- [설정 충전](https://github.com/yt-dlp/yt-dlp#configuration)
- [출력 템플릿](https://github.com/yt-dlp/yt-dlp#output-template)
- [yt-dlp 자주 묻는 질문](https://github.com/yt-dlp/yt-dlp/wiki/FAQ)
