템플릿 일부가 비어 있음
해당 URL에 -K를 실행해 추측한 필드를 표시된 키로 바꾸고 시험하는 동안 고정된 대체값을 두세요.
- 추출기 확인
- 활성 설정 확인
- 한 필드씩 테스트
gallery-dl 파일 이름 템플릿은 추출기 메타데이터를 규칙적인 파일명과 폴더 경로로 바꿉니다. URL에서 사용할 수 있는 필드를 찾고, 간단한 형식을 만들고, 운영체제에서 허용되지 않는 문자를 처리한 뒤 대량 다운로드 전에 결과를 확인하는 방법을 알아보세요.
gallery-dl -K "URL"을 실행해 해당 추출기가 제공하는 치환 키를 확인하세요. 키는 --filename 또는 extractor.filename 형식에 사용하고, 폴더 단계는 extractor.directory로 설정합니다. 영구 설정에 넣기 전에 --simulate와 작은 URL로 결과를 확인하세요. 한 추출기에서 되는 키가 다른 추출기에서도 된다고 가정하면 안 됩니다.
파일명 템플릿은 gallery-dl이 파일을 준비할 때 평가하는 형식 문자열입니다. 추출기 메타데이터의 ID, 제목, 날짜, 작성자, 페이지 번호, 확장자 등을 읽기 쉬운 구분자와 조합할 수 있습니다. 폴더도 같은 방식으로 만들 수 있어 사이트, 작성자, 시리즈별로 컬렉션을 분류할 수 있습니다.
템플릿은 로컬 저장 방식을 바꾸지만 URL이나 추출기의 다운로드 판정은 바꾸지 않습니다. 처음에는 짧고 고유하며 읽기 쉽고 작업을 실행하는 모든 컴퓨터에서 사용할 수 있는 형식으로 시작하세요.
공식 설정 문서는 특정 URL에 -K 또는 --list-keywords를 사용하도록 안내합니다. 명령은 폴더와 파일명에 쓸 수 있는 키, 그리고 샘플 값을 보여줍니다. 이 결과가 안전한 템플릿의 범위입니다. 다른 사이트 예시나 오래된 설명, 추측한 변수보다 현재 URL의 추출기가 실제로 제공하는 값을 기준으로 삼으세요.
접근 권한이 있는 공개 URL 하나를 선택하고 처음에는 범위를 작게 유지하세요. 로그인이 필요하다면 사이트의 정상 로그인 절차와 로컬 브라우저 쿠키를 별도로 사용합니다. 쿠키나 비공개 토큰을 템플릿, 공유 로그, 지원 요청에 붙여 넣지 마세요.
gallery-dl -K "URL"gallery-dl --simulate "URL"안정적인 식별자로 시작하고 나중에 파일을 찾을 때 필요한 필드만 추가하세요. {category}_{id}_{title}.{extension} 같은 형식은 알아보기 쉽고, 날짜를 앞에 두면 시간순으로 정렬하기 편합니다. 사용할 수 있는 필드는 추출기에 따라 다르므로 각각 -K로 확인하세요.
한 번만 시험할 때는 --filename을 사용하세요. 시뮬레이션과 소량의 실제 다운로드에서 확인한 다음 JSON 설정의 해당 추출기 항목으로 옮깁니다. 더 구체적인 설정은 일반 설정을 덮어쓸 수 있습니다.
구분자는 명확하게 사용하고 확장자는 끝에 둡니다. 제목이 없는 항목도 식별하도록 ID와 같은 대체 필드를 남겨두세요.
gallery-dl --filename "{category}_{id}_{title}.{extension}" --simulate "URL"{
"extractor": {
"example": {
"filename": "{id}_{title}.{extension}"
}
}
}| 형식 아이디어 | 유용한 경우 | 먼저 확인할 점 |
|---|---|---|
| {id}_{extension} | 제목이 없거나 자주 바뀜 | 추출기가 안정적인 ID를 제공하는지 |
| {date}_{id}_{title} | 시간순으로 파일을 찾음 | 날짜 형식이 일정한지 |
| {author}/{title} | 작성자별 폴더가 필요함 | 작성자 값이 경로에 안전한지 |
| {category}_{id}_{title}.{extension} | 여러 사이트를 한 루트에 저장함 | category와 extension이 -K에 있는지 |
extractor.directory 옵션에는 형식 문자열 목록을 지정할 수 있습니다. 각 항목은 경로의 한 단계가 되어 기본 디렉터리 아래에 차례로 추가됩니다. 긴 파일명 하나에 정보를 몰아넣지 않고 사이트, 작성자, 컬렉션별 폴더 구조를 분명하게 만들 수 있습니다.
폴더 구조가 실제 작업에 도움이 되는 경우에 사용하세요. 작성자명이나 제목에 경로 구분자, 예약 문자, 예상보다 긴 값이 들어갈 수 있으므로 여러 URL로 시험해야 합니다. 공유할 경로에 비밀 정보나 개인 계정 이름을 넣지 마세요.
{
"extractor": {
"example": {
"directory": ["{category}", "{author}"],
"filename": "{id}_{title}.{extension}"
}
}
}설정에서는 조건마다 다른 파일명 문자열을 연결할 수 있습니다. 조건은 작성된 순서대로 평가되며 처음으로 참이 되는 형식을 사용합니다. 빈 문자열 항목이나 추출기 기본 형식을 대체값으로 둘 수 있습니다. 이미지와 동영상이 섞인 컬렉션을 처리할 때 유용합니다.
조건은 단순 문자열보다 원인을 찾기 어렵습니다. 한 번에 하나만 추가하고 조건에 맞는 URL과 맞지 않는 URL을 모두 시험하세요. 대체 형식을 명확히 두고 -K에 표시된 필드만 사용합니다.
{
"extractor": {
"example": {
"filename": {
"extension == 'mp4'": "{id}_video.{extension}",
"": "{id}_{title}.{extension}"
}
}
}
}형식이 문법적으로 맞아도 운영체제가 경로를 거부할 수 있습니다. 제목에 예약 문자나 매우 긴 텍스트가 포함될 수 있습니다. gallery-dl에는 Windows, Unix, ASCII, 사용자 지정 문자 제한 모드가 있습니다. 작업을 실행할 컴퓨터에 맞는 모드를 선택하고 결과를 실제로 확인하세요.
같은 설정을 여러 시스템에서 쓰려면 단순한 구분자와 얕은 폴더 구조를 사용하세요. 문장부호, 제목 누락, 비라틴 이름, 긴 값을 시험해야 합니다. 파일명뿐 아니라 저장 위치를 포함한 전체 경로의 길이도 중요합니다.
| 테스트 사례 | 중요한 이유 | 신중한 대응 |
|---|---|---|
| 예약 문장부호 | Windows에서 일부 문자를 사용할 수 없음 | 호환 모드를 선택하고 미리보기 확인 |
| 긴 제목 | 전체 경로가 제한을 넘을 수 있음 | ID를 남기고 제목 축약 |
| 필드 누락 | 추측한 키가 빈 값이 될 수 있음 | -K 확인 후 대체값 사용 |
| 비라틴 문자 | 파일 시스템마다 처리 방식이 다를 수 있음 | UTF-8을 사용하고 대상 컴퓨터에서 테스트 |
지원되는 URL 하나를 고르고 -K를 실행하세요. 사용할 필드를 기록한 뒤 가장 짧은 형식을 --simulate으로 시험하고 출력을 확인합니다. 다음에는 임시 저장 위치에 작은 범위만 다운로드하고 파일을 열어 이름과 폴더 계층을 확인하세요.
다른 대표 URL에서도 반복하고, 가능하면 문장부호가 들어간 제목이나 제목이 없는 항목을 포함합니다. 결과가 맞으면 영구 설정에 옮기고 시험한 명령을 작업 문서에 남깁니다.
동작이 달라지면 --config-status로 활성 설정을 보고 --config-ignore --simulate 결과와 비교하세요. 작동하는 설정을 보관하고 한 번에 규칙 하나만 변경합니다.
gallery-dl --config-ignore --simulate "URL"gallery-dl --config-statusgallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"일반적인 이름만 생성된다면 필드가 없거나, 더 구체적인 설정이 값을 덮어쓰거나, 다른 설정 파일이 활성화됐을 수 있습니다. -K 출력과 템플릿을 비교하고 --config-status를 확인한 다음 설정을 무시한 시뮬레이션을 실행하세요.
파일이 건너뛰어지거나 덮어써지는 문제는 별도의 선택 동작일 수 있습니다. 이름 템플릿은 --download-archive를 대신하지 않고 파일 내용도 비교하지 않습니다. ID를 남기고 기록을 바꾸기 전에 URL, 범위, 필터를 확인하세요.
해당 URL에 -K를 실행해 추측한 필드를 표시된 키로 바꾸고 시험하는 동안 고정된 대체값을 두세요.
형식을 짧게 하고 예약 문자를 제거한 뒤 실제 작업을 실행할 컴퓨터에서 시험하세요.
파일명 템플릿은 로컬 다운로드를 정리할 뿐입니다. 로그인, 유료 장벽, 요청 제한, 접근 제어, 플랫폼 규칙을 우회하지 않습니다. 접근 권한이 있는 URL과 미디어만 시험하고 자격 증명을 명령이나 로그에 넣지 마세요.
템플릿은 짧고 추출기별로 관리하세요. -K로 키를 확인하고 시뮬레이션한 뒤 경계 사례 몇 개를 시험하고 가장 구체적인 설정 단계에 저장합니다. 나중에 변경을 비교할 수 있도록 저장 위치와 시험한 명령도 기록하세요.
gallery-dl -K "URL"을 실행하세요. 해당 URL의 추출기가 제공하는 파일명 및 폴더 키와 샘플 값이 표시됩니다.
-K에 표시된다면 {id}_{title}.{extension}으로 시작할 수 있습니다. 작은 테스트가 끝난 다음 category나 날짜를 추가하세요.
예. extractor.directory에 형식 문자열 목록을 지정하면 각 항목이 기본 디렉터리 아래 폴더 단계가 됩니다. 작성자와 제목 값은 먼저 시험하세요.
치환 키는 추출기마다 다릅니다. URL별로 -K를 실행하고 사이트별 설정을 해당 추출기 단계에 두세요.
Windows 호환 제한 모드, 단순한 구분자, 짧은 형식을 사용하세요. 예약 문장부호, 긴 제목, 누락 필드와 전체 경로를 대상 컴퓨터에서 시험합니다.
아니요. 템플릿은 로컬 이름만 제어합니다. 반복 실행 기록을 유지하려면 안정적인 --download-archive 파일을 사용하고 파일명에 ID를 남기세요.