gallery-dl로 Twitter / X 사용하는 방법

gallery-dl의 Twitter / X 추출기는 단일 게시물, 사용자의 /media 페이지, 타임라인, 좋아요, 북마크, 목록, 검색 등 여러 URL 형식을 인식합니다. 첫 작업에서는 공개 게시물이나 프로필의 미디어 페이지를 선택하세요. 브라우저에서 표준 x.com URL을 복사해 따옴표로 감싸고, 파일을 만들기 전에 시뮬레이션을 실행합니다.

시뮬레이션은 설치된 버전이 충분히 최신인지, URL이 올바른 추출기에 연결되는지, 로그인이 필요한지, 어떤 파일이 선택되는지 보여 줍니다. 타임라인에는 재게시, 답글, 인용, 동영상과 반복 미디어가 섞일 수 있습니다. URL이 인식되더라도 기본 범위가 실제 목적과 일치하는지 별도로 확인해야 합니다.

gallery-dl --simulate "https://x.com/USERNAME/status/POST_ID"

gallery-dl --simulate "https://x.com/USERNAME/media"

gallery-dl -K "https://x.com/USERNAME/status/POST_ID"

Twitter는 익명 타임라인 접근을 제한할 수 있습니다. gallery-dl이 인증 쿠키를 요구하면 본인이 관리하는 브라우저 프로필에서 정상적으로 로그인하고, 대상 페이지가 그 프로필에서 열리는지 확인한 뒤 로컬 프로필을 명령에 지정합니다. 쿠키 원문을 이 사이트에 붙여 넣거나 다른 사람에게 보낼 필요가 없습니다.

쿠키 데이터베이스가 잠겨 있다면 브라우저를 완전히 종료하고, 실제 X 세션이 활성화된 프로필을 선택하세요. 만료된 세션, 추가 계정 확인, 비공개 콘텐츠, 연령 제한이나 계정별 권한 때문에 추출이 계속 차단될 수 있습니다. 쿠키는 원래 계정이 이미 가진 접근 권한만 재현합니다.

gallery-dl --cookies-from-browser firefox --simulate "https://x.com/USERNAME/media"

gallery-dl --cookies-from-browser chrome --simulate "https://x.com/USERNAME/media"

gallery-dl --cookies-from-browser edge --simulate "https://x.com/USERNAME/media"

시뮬레이션이 성공하면 예측 가능한 저장 폴더와 다운로드 아카이브를 정합니다. 아카이브는 성공한 추출기 ID를 기록하고 이후 실행에서 같은 항목을 건너뜁니다. 첫 실제 다운로드는 작은 범위로 제한하고, 폴더 구조와 파일명, 이미지와 동영상 선택을 확인한 다음 범위를 늘리세요.

Twitter 추출기는 답글, 재게시, 인용 게시물, 카드, 기사, 미리보기, 텍스트 전용 게시물과 동영상의 포함 여부를 설정할 수 있습니다. 기본값은 릴리스에 따라 바뀔 수 있습니다. 파일명이나 필터를 만들기 전에 -K로 필드를 확인하고, 정기 작업에는 같은 아카이브를 유지하며 브라우저 프로필 경로나 세션 정보를 공유하지 마세요.

gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "twitter.sqlite3" "https://x.com/USERNAME/media"

gallery-dl --destination "D:/Media/X" --download-archive "twitter.sqlite3" "https://x.com/USERNAME/media"

gallery-dl --write-metadata --download-archive "twitter.sqlite3" "https://x.com/USERNAME/media"

명령줄에서 동작을 확인한 후 안정된 옵션만 설정 파일로 옮기세요. 공식 예제에는 include, replies, retweets, quoted, videos, 크기 우선순위, API 재시도와 요청 제한 처리 등이 있습니다. 모든 항목을 복사하는 것보다 목적에 필요한 작은 블록을 검토해 사용하는 편이 변경 원인을 추적하기 쉽습니다.

아래 예시는 동영상을 유지하고 답글, 재게시와 인용을 제외하며 제한 시 기다리고 고정 아카이브를 사용합니다. 여러 기기에서 다른 프로필을 쓴다면 쿠키 선택은 명령줄에 남겨도 됩니다. JSON에는 주석이나 마지막 쉼표를 넣을 수 없고 Windows 역슬래시는 이스케이프해야 합니다.

{
  "extractor": {
    "twitter": {
      "replies": false,
      "retweets": false,
      "quoted": false,
      "videos": true,
      "ratelimit": "wait",
      "archive": "D:/gallery-dl/twitter.sqlite3"
    }
  }
}

gallery-dl --config-ignore --simulate "https://x.com/USERNAME/media"

gallery-dl --config-status

인증, 요청 제한, 빈 결과와 중복 건너뛰기를 서로 다른 문제로 다루세요. AuthRequired는 쿠키가 없거나 만료되었을 가능성이 높습니다. HTTP 429는 공격적으로 다시 시도하지 말고 기다려야 한다는 뜻입니다. 결과가 비어 있다면 URL 형식, 접근 권한, 너무 강한 필터나 이미 ID가 기록된 아카이브를 확인합니다.

--config-ignore를 붙인 깨끗한 시뮬레이션과 평소 설정을 비교하고, 쿠키, 범위, 아카이브와 필터를 하나씩 추가하세요. gallery-dl은 처음 설치한 채널로 업데이트하고 버전을 확인합니다. X 측 변경이 의심되면 반복 요청 대신 공식 issue와 추출기 업데이트 상황을 확인하세요.

gallery-dl은 로컬 다운로더이지 권한을 부여하는 시스템이 아닙니다. 합법적으로 접근하고 사용할 수 있는 미디어만 저장하고, 개인정보, 저작권, 적용되는 규칙과 법률을 지키세요. 쿠키, 토큰, 비공개 아카이브나 내려받은 개인 데이터를 공유하지 마세요.

2026년 7월 30일 이 사이트는 공식 PyPI 메타데이터에서 gallery-dl 1.32.8을 확인했고, Codeberg의 공식 Windows와 Linux 파일이 HTTP 200과 예상된 파일명 및 크기로 응답하는 것을 확인했습니다. X의 동작은 바뀔 수 있으므로 문제가 생기면 공식 릴리스와 문서를 다시 확인하세요.