다운로드 파일을 쉽게 찾기

gallery-dl 파일 이름 템플릿: 이름, 폴더, 메타데이터

gallery-dl 파일 이름 템플릿은 추출기 메타데이터를 규칙적인 파일명과 폴더 경로로 바꿉니다. URL에서 사용할 수 있는 필드를 찾고, 간단한 형식을 만들고, 운영체제에서 허용되지 않는 문자를 처리한 뒤 대량 다운로드 전에 결과를 확인하는 방법을 알아보세요.

메타데이터 기반 파일명예측 가능한 폴더안전한 테스트 절차
터미널에서 메타데이터 파일을 정리된 폴더로 보내는 편집 일러스트
파일명 템플릿은 추출기 필드와 반복 가능한 로컬 폴더 구성을 연결합니다.
먼저 필드를 확인하고 형식을 만드세요

gallery-dl -K "URL"을 실행해 해당 추출기가 제공하는 치환 키를 확인하세요. 키는 --filename 또는 extractor.filename 형식에 사용하고, 폴더 단계는 extractor.directory로 설정합니다. 영구 설정에 넣기 전에 --simulate와 작은 URL로 결과를 확인하세요. 한 추출기에서 되는 키가 다른 추출기에서도 된다고 가정하면 안 됩니다.

원하는 결과부터 정하기

gallery-dl 파일 이름 템플릿이 제어하는 항목

파일명 템플릿은 gallery-dl이 파일을 준비할 때 평가하는 형식 문자열입니다. 추출기 메타데이터의 ID, 제목, 날짜, 작성자, 페이지 번호, 확장자 등을 읽기 쉬운 구분자와 조합할 수 있습니다. 폴더도 같은 방식으로 만들 수 있어 사이트, 작성자, 시리즈별로 컬렉션을 분류할 수 있습니다.

템플릿은 로컬 저장 방식을 바꾸지만 URL이나 추출기의 다운로드 판정은 바꾸지 않습니다. 처음에는 짧고 고유하며 읽기 쉽고 작업을 실행하는 모든 컴퓨터에서 사용할 수 있는 형식으로 시작하세요.

실제 필드 확인하기

-K로 사용할 수 있는 치환 키 확인

공식 설정 문서는 특정 URL에 -K 또는 --list-keywords를 사용하도록 안내합니다. 명령은 폴더와 파일명에 쓸 수 있는 키, 그리고 샘플 값을 보여줍니다. 이 결과가 안전한 템플릿의 범위입니다. 다른 사이트 예시나 오래된 설명, 추측한 변수보다 현재 URL의 추출기가 실제로 제공하는 값을 기준으로 삼으세요.

접근 권한이 있는 공개 URL 하나를 선택하고 처음에는 범위를 작게 유지하세요. 로그인이 필요하다면 사이트의 정상 로그인 절차와 로컬 브라우저 쿠키를 별도로 사용합니다. 쿠키나 비공개 토큰을 템플릿, 공유 로그, 지원 요청에 붙여 넣지 마세요.

메타데이터 필드를 검사해 파일명으로 조합하는 과정을 보여주는 편집 다이어그램
-K 출력은 해당 추출기용 템플릿에서 사용할 필드 목록입니다.
URL에서 필드 목록 확인
gallery-dl -K "URL"
다운로드 없이 추출 시뮬레이션
gallery-dl --simulate "URL"
읽기 쉬운 이름 만들기

gallery-dl 파일 이름 형식 구성하기

안정적인 식별자로 시작하고 나중에 파일을 찾을 때 필요한 필드만 추가하세요. {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}"
      }
    }
  }
}
플랫폼 호환성 유지하기

Windows, Linux, macOS 파일명 제한 확인하기

형식이 문법적으로 맞아도 운영체제가 경로를 거부할 수 있습니다. 제목에 예약 문자나 매우 긴 텍스트가 포함될 수 있습니다. gallery-dl에는 Windows, Unix, ASCII, 사용자 지정 문자 제한 모드가 있습니다. 작업을 실행할 컴퓨터에 맞는 모드를 선택하고 결과를 실제로 확인하세요.

같은 설정을 여러 시스템에서 쓰려면 단순한 구분자와 얕은 폴더 구조를 사용하세요. 문장부호, 제목 누락, 비라틴 이름, 긴 값을 시험해야 합니다. 파일명뿐 아니라 저장 위치를 포함한 전체 경로의 길이도 중요합니다.

파일명이 플랫폼 호환성 점검을 거쳐 여러 운영체제 폴더로 이동하는 편집 일러스트
플랫폼 검증에서는 문자, 전체 길이, 최종 저장 위치를 함께 확인합니다.
테스트 사례중요한 이유신중한 대응
예약 문장부호Windows에서 일부 문자를 사용할 수 없음호환 모드를 선택하고 미리보기 확인
긴 제목전체 경로가 제한을 넘을 수 있음ID를 남기고 제목 축약
필드 누락추측한 키가 빈 값이 될 수 있음-K 확인 후 대체값 사용
비라틴 문자파일 시스템마다 처리 방식이 다를 수 있음UTF-8을 사용하고 대상 컴퓨터에서 테스트
결과 입증하기

gallery-dl 템플릿을 안전하게 검증하는 절차

지원되는 URL 하나를 고르고 -K를 실행하세요. 사용할 필드를 기록한 뒤 가장 짧은 형식을 --simulate으로 시험하고 출력을 확인합니다. 다음에는 임시 저장 위치에 작은 범위만 다운로드하고 파일을 열어 이름과 폴더 계층을 확인하세요.

다른 대표 URL에서도 반복하고, 가능하면 문장부호가 들어간 제목이나 제목이 없는 항목을 포함합니다. 결과가 맞으면 영구 설정에 옮기고 시험한 명령을 작업 문서에 남깁니다.

동작이 달라지면 --config-status로 활성 설정을 보고 --config-ignore --simulate 결과와 비교하세요. 작동하는 설정을 보관하고 한 번에 규칙 하나만 변경합니다.

설정 무시 비교
gallery-dl --config-ignore --simulate "URL"
활성 설정 확인
gallery-dl --config-status
첫 소량 다운로드
gallery-dl --range "1-3" --filename "{id}_{title}.{extension}" "URL"
문제 범위 좁히기

빈 이름, 중복 이름, 거부된 경로 해결하기

일반적인 이름만 생성된다면 필드가 없거나, 더 구체적인 설정이 값을 덮어쓰거나, 다른 설정 파일이 활성화됐을 수 있습니다. -K 출력과 템플릿을 비교하고 --config-status를 확인한 다음 설정을 무시한 시뮬레이션을 실행하세요.

파일이 건너뛰어지거나 덮어써지는 문제는 별도의 선택 동작일 수 있습니다. 이름 템플릿은 --download-archive를 대신하지 않고 파일 내용도 비교하지 않습니다. ID를 남기고 기록을 바꾸기 전에 URL, 범위, 필터를 확인하세요.

템플릿 일부가 비어 있음

해당 URL에 -K를 실행해 추측한 필드를 표시된 키로 바꾸고 시험하는 동안 고정된 대체값을 두세요.

  • 추출기 확인
  • 활성 설정 확인
  • 한 필드씩 테스트

경로가 거부됨

형식을 짧게 하고 예약 문자를 제거한 뒤 실제 작업을 실행할 컴퓨터에서 시험하세요.

  • 문자 확인
  • 전체 경로 길이 확인
  • 비라틴 값도 테스트
허가된 URL로 재현 가능한 테스트를 하세요

파일명 템플릿은 로컬 다운로드를 정리할 뿐입니다. 로그인, 유료 장벽, 요청 제한, 접근 제어, 플랫폼 규칙을 우회하지 않습니다. 접근 권한이 있는 URL과 미디어만 시험하고 자격 증명을 명령이나 로그에 넣지 마세요.

작업을 유지 관리하기

반복 가능한 파일명 관리 습관

템플릿은 짧고 추출기별로 관리하세요. -K로 키를 확인하고 시뮬레이션한 뒤 경계 사례 몇 개를 시험하고 가장 구체적인 설정 단계에 저장합니다. 나중에 변경을 비교할 수 있도록 저장 위치와 시험한 명령도 기록하세요.

자주 묻는 질문

gallery-dl 파일 이름 템플릿 자주 묻는 질문

gallery-dl 파일명에 쓸 수 있는 필드는 어떻게 확인하나요?

gallery-dl -K "URL"을 실행하세요. 해당 URL의 추출기가 제공하는 파일명 및 폴더 키와 샘플 값이 표시됩니다.

간단한 gallery-dl 파일명 형식은 무엇인가요?

-K에 표시된다면 {id}_{title}.{extension}으로 시작할 수 있습니다. 작은 테스트가 끝난 다음 category나 날짜를 추가하세요.

gallery-dl 메타데이터로 폴더를 만들 수 있나요?

예. extractor.directory에 형식 문자열 목록을 지정하면 각 항목이 기본 디렉터리 아래 폴더 단계가 됩니다. 작성자와 제목 값은 먼저 시험하세요.

같은 템플릿이 사이트마다 다르게 동작하는 이유는 무엇인가요?

치환 키는 추출기마다 다릅니다. URL별로 -K를 실행하고 사이트별 설정을 해당 추출기 단계에 두세요.

Windows에서 사용할 수 있는 gallery-dl 파일명을 만들려면 어떻게 하나요?

Windows 호환 제한 모드, 단순한 구분자, 짧은 형식을 사용하세요. 예약 문장부호, 긴 제목, 누락 필드와 전체 경로를 대상 컴퓨터에서 시험합니다.

파일명 템플릿이 중복 다운로드를 막아 주나요?

아니요. 템플릿은 로컬 이름만 제어합니다. 반복 실행 기록을 유지하려면 안정적인 --download-archive 파일을 사용하고 파일명에 ID를 남기세요.

공식 자료

gallery-dl 공식 설정 문서gallery-dl 공식 명령줄 옵션gallery-dl 소스 코드와 이슈
다음 단계

관련 자료