프로젝트 소개

gallery-dl은 다양한 이미지 호스팅 사이트에서 이미지 갤러리와 컬렉션을 다운로드하도록 설계된 명령줄 프로그램입니다. Windows, Linux, macOS를 지원하는 크로스 플랫폼 도구이며, Python으로 작성되었습니다(Python 3.8+ 및 Requests 라이브러리 필요). 주요 기능은 다음과 같습니다: - **멀티 사이트 지원**: danbooru, Twitter, Pixiv, MangaDex, Tumblr, Instagram, Patreon, Flickr, Reddit, DeviantArt 등 수많은 이미지 호스팅 플랫폼을 위한 추출기를 제공합니다. 지원되는 사이트의 전체 목록은 프로젝트 문서에 유지됩니다. - **광범위한 구성**: 다운로드 동작, 파일 이름 지정, 인증, 쿠키 등을 다루는 많은 옵션을 제공하는 JSON 기반 구성 파일. 여러 구성 파일을 병합할 수 있으며, 나중 파일이 이전 파일을 재정의합니다. 구성 파일은 플랫폼 특정 위치에서 검색됩니다(예: Windows의 %APPDATA%, Linux/macOS의 ~/.config/gallery-dl/). - **강력한 파일 이름 지정**: 사용자 지정 이름 패턴으로 다운로드한 파일을 구성하기 위한 유연한 형식 지정 기능. - **인증 지원**: 사용자 이름/비밀번호 쌍, 브라우저 쿠키 추출(Chromium 기반 브라우저, Firefox, Safari), 그리고 Pixiv, Flickr, Reddit, DeviantArt, Mastodon 인스턴스 같은 사이트를 위한 OAuth를 포함한 여러 인증 방법. - **필터링 및 옵션**: 콘텐츠 필터링(예: 장 번호 및 언어), 특정 추출기 강제, 원격 리소스에서 URL 검색을 위한 명령줄 옵션. - **비디오 지원**: HLS/DASH 비디오 다운로드를 위한 yt-dlp 또는 youtube-dl과의 선택적 통합, Pixiv Ugoira 변환을 위한 FFmpeg. - **다중 설치 방법**: pip(PyPI), Windows 및 Linux용 독립 실행형 실행 파일, Snap, Chocolatey, Scoop, Homebrew, MacPorts, Docker(Docker Hub 및 GitHub Container Registry), Nix/Home Manager를 통해 제공됩니다. - **아카이브 지원**: 이미 다운로드한 항목을 추적하기 위한 Psycopg를 통한 선택적 PostgreSQL 아카이브 지원. - **프록시 및 압축**: PySocks를 통한 선택적 SOCKS 프록시 지원, brotli/brotlicffi를 통한 Brotli 압축, zstandard를 통한 Zstandard 압축. 이 도구는 URL을 인수로 전달하여 호출합니다: `gallery-dl [OPTIONS]... URLS...`. 또한 원격 리소스에 나열된 URL에서 이미지를 찾아 다운로드하기 위해 원격 URL 검색 모드(`r:` 접두사)를 지원합니다. 사이트 주소가 비표준인 경우 특정 추출기를 강제하기 위해 URL 앞에 추출기 이름을 붙일 수 있습니다. 활발한 개발은 Codeberg로 이동했으며, 프로젝트는 https://codeberg.org/mikf/gallery-dl에서 호스팅되고 있습니다.