gallery dl
1.27.7
gallery-dl 은 여러 이미지 호스팅 사이트에서 이미지 갤러리와 컬렉션을 다운로드하는 명령줄 프로그램입니다(지원되는 사이트 참조). 다양한 구성 옵션과 강력한 파일 이름 지정 기능을 갖춘 크로스 플랫폼 도구입니다.
내용물
종속성
선택 과목
설치
씨
독립형 실행 파일
야간 빌드
스냅
초콜릿 같은
국자
홈브류
MacPort
도커
용법
예
구성
선적 서류 비치
위치
입증
사용자 이름 및 비밀번호
쿠키
OAuth
파이썬 3.4+
요청사항
yt-dlp 또는 youtube-dl: HLS/DASH 비디오 다운로드, ytdl 통합
FFmpeg: Pixiv Ugoira 변환
mkvmerge: 정확한 Ugoira 프레임 시간 코드
PySocks: SOCKS 프록시 지원
brotli 또는 brotlicffi: Brotli 압축 지원
zstandard: Zstandard 압축 지원
PyYAML: YAML 구성 파일 지원
toml: Python<3.11에 대한 TOML 구성 파일 지원
SecretStorage: --cookies-from-browser 에 대한 그놈 키링 비밀번호
gallery-dl 의 안정적인 릴리스는 PyPI에 배포되며 pip를 사용하여 쉽게 설치하거나 업그레이드할 수 있습니다.
python3 -m pip 설치 -U 갤러리-dl
GitHub에서 직접 최신 개발 버전을 설치하는 것도 pip를 사용하여 수행할 수 있습니다.
python3 -m pip install -U -I --no-deps --no-cache-dir https://github.com/mikf/gallery-dl/archive/master.tar.gz
참고: Windows 사용자는 python3 대신 py -3 사용해야 합니다.
필수 패키지 setuptools 및 wheel 포함하여 최신 버전의 pip를 사용하는 것이 좋습니다. 이러한 패키지가 최신 상태인지 확인하려면 다음을 실행하세요.
python3 -m pip install --upgrade pip setuptools 휠
Python 인터프리터와 필수 Python 패키지가 포함된 사전 구축된 실행 파일을 다음에서 사용할 수 있습니다.
Windows(Microsoft Visual C++ 재배포 가능 패키지(x86) 필요)
리눅스
최신 커밋에서 빌드된 실행 파일은 다음에서 찾을 수 있습니다.
https://github.com/gdl-org/builds/releases
Snapd에서 지원하는 배포판을 사용하는 Linux 사용자는 Snap Store에서 gallery-dl을 설치할 수 있습니다.
스냅 설치 갤러리-DL
Chocolatey가 설치된 Windows 사용자는 Chocolatey 커뮤니티 패키지 저장소에서 gallery-dl을 설치할 수 있습니다.
초코 설치 갤러리-dl
gallery-dl은 Windows 사용자를 위한 Scoop "기본" 버킷에서도 사용할 수 있습니다.
특종 설치 갤러리-DL
Homebrew를 사용하는 macOS 또는 Linux 사용자의 경우:
양조 설치 갤러리-DL
MacPorts를 사용하는 macOS 사용자의 경우:
sudo 포트 설치 갤러리-dl
저장소에서 Dockerfile 사용:
자식 클론 https://github.com/mikf/gallery-dl.gitcd gallery-dl/ docker build -t gallery-dl:latest .
Docker Hub에서 이미지 가져오기:
도커 풀 mikf123/gallery-dl 도커 태그 mikf123/gallery-dl 갤러리-dl
GitHub Container Registry에서 이미지 가져오기:
도커 풀 ghcr.io/mikf/gallery-dl 도커 태그 ghcr.io/mikf/gallery-dl 갤러리-dl
컨테이너를 실행하려면 구성 파일과 다운로드가 실행 전반에 걸쳐 지속될 수 있도록 호스트에 일부 디렉터리를 연결해야 할 것입니다.
저장소에서 예시 구성 파일 참조를 다운로드하여 마운트된 볼륨 위치에 배치하거나 그곳에서 빈 파일을 터치하세요.
컨테이너에 다른 태그를 지정했거나 Podman을 사용하는 경우 조정해야 합니다. 확실하지 않은 경우 docker image ls 실행하여 이름을 확인하세요.
이렇게 하면 사용할 때마다 컨테이너가 제거되므로 항상 신선한 실행 환경을 유지할 수 있습니다. 컨테이너를 자동 빌드하기 위해 ci-cd 파이프라인을 설정하는 경우 --pull=newer 플래그를 추가하여 실행할 때 docker가 최신 컨테이너가 있는지 확인하고 실행하기 전에 다운로드할 수도 있습니다.
docker run --rm -v $HOME/Downloads/:/gallery-dl/ -v $HOME/.config/gallery-dl/gallery-dl.conf:/etc/gallery-dl.conf -it gallery-dl: 최신
또한 "gallery-dl"에 대한 별칭을 셸에 추가하거나 간단한 bash 스크립트를 만들어 $PATH 어딘가에 놓아 이 명령에 대한 shim 역할을 할 수도 있습니다.
gallery-dl을 사용하려면 다음에서 이미지를 다운로드하려는 URL을 사용하여 호출하세요.
gallery-dl [옵션]... URL...
모든 명령줄 옵션의 전체 목록을 보려면 gallery-dl --help 사용하거나 docs/options.md를 참조하세요.
이미지 다운로드; 이 경우 'bonocho'에 대한 태그 검색을 통해 danbooru에서:
gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"
사용자 이름과 비밀번호를 사용하여 인증을 지원하는 사이트에서 이미지의 직접 URL을 가져옵니다.
gallery-dl -g -u "<사용자 이름>" -p "<비밀번호>" "https://twitter.com/i/web/status/604341487988576256"
장 번호와 언어별로 만화 장을 필터링하세요.
gallery-dl --chapter-filter "10 <= 장 < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"
원격 리소스에서 URL을 검색하고 해당 URL에서 이미지를 다운로드하세요.
(추출기를 찾을 수 없는 URL은 자동으로 무시됩니다.)
갤러리-dl "r:https://pastebin.com/raw/FLwrCYsT"
사이트 주소가 해당 추출기에 대한 표준이 아닌 경우 URL 앞에 추출기 이름을 붙여 특정 추출기를 사용하도록 할 수 있습니다.
갤러리-dl "tumblr:https://sometumblrblog.example"
gallery-dl 의 구성 파일은 JSON 기반 파일 형식을 사용합니다.
사용 가능한 모든 구성 옵션 목록과 해당 설명은 https://gdl-org.github.io/docs/configuration.html에서 확인할 수 있습니다.
사용 가능한 옵션이 기본값으로 설정된 기본 구성 파일은 docs/gallery-dl.conf를 참조하세요.
더 관련된 설정 및 옵션 사용법이 포함된 설명이 포함된 예제는 docs/gallery-dl-example.conf를 참조하세요.
gallery-dl은 다음 위치에서 구성 파일을 검색합니다.
윈도우:
( %USERPROFILE% 일반적으로 사용자의 홈 디렉터리(예: C:Users<username> )를 나타냅니다.)
%APPDATA%gallery-dlconfig.json
%USERPROFILE%gallery-dlconfig.json
%USERPROFILE%gallery-dl.conf
리눅스, macOS 등:
/etc/gallery-dl.conf
${XDG_CONFIG_HOME}/gallery-dl/config.json
${HOME}/.config/gallery-dl/config.json
${HOME}/.gallery-dl.conf
실행 파일로 실행되면 gallery-dl은 해당 실행 파일과 동일한 디렉터리에서 gallery-dl.conf 파일도 찾습니다.
한 번에 두 개 이상의 구성 파일을 사용할 수 있습니다. 이 경우 첫 번째 파일 이후의 모든 값은 이미 로드된 설정에 병합되어 잠재적으로 이전 설정을 재정의합니다.
일부 추출기에서는 사용자 이름과 비밀번호 쌍의 형태로 유효한 로그인 자격 증명을 제공해야 합니다. 이는 nijie 에 필요하며 aryion , danbooru , e621 , exhentai , idolcomplex , imgbb , inkbunny , mangadex , mangoxo , pillowfort , sankaku , subscribestar , tapas , tsumino , twitter 및 zerochan 에는 선택 사항입니다.
구성 파일에서 필요한 정보를 설정할 수 있습니다.
{ "추출기": { "twitter": { "사용자 이름": "<사용자 이름>", "비밀번호": "<비밀번호>"
}
}
} 또는 -u/--username 및 -p/--password 또는 -o/--option 명령줄 옵션을 통해 직접 제공할 수 있습니다.
gallery-dl -u "<사용자 이름>" -p "<비밀번호>" "URL"gallery-dl -o "사용자 이름=<사용자 이름>" -o "비밀번호=<비밀번호>" "URL"
CAPTCHA 등으로 인해 사용자 이름과 비밀번호를 사용한 로그인이 불가능하거나 아직 구현되지 않은 사이트의 경우 브라우저 로그인 세션에서 쿠키를 사용하여 gallery-dl 에 입력할 수 있습니다.
이는 구성 파일의 쿠키 옵션을 통해 다음을 지정하여 수행할 수 있습니다.
브라우저 애드온이 내보낸 Mozilla/Netscape 형식의 cookie.txt 파일 경로
(예: Chrome의 경우 로컬로 cookie.txt 가져오기, Firefox의 경우 쿠키 내보내기)
브라우저의 웹 개발자 도구에서 수집된 이름-값 쌍 목록
(크롬, 파이어폭스)
쿠키를 추출할 브라우저의 이름
(지원되는 브라우저는 Chromium 기반, Firefox, Safari 입니다)
예를 들어:
{ "추출기": { "인스타그램": { "쿠키": "$HOME/path/to/cookies.txt"
}, "patreon": { "쿠키": { "session_id": "K1T57EKu19TR49C51CDjOJoXNQLF7VbdVOiBrC9ye0a"
}
}, "twitter": { "쿠키": ["firefox"]
}
}
} --cookies 명령줄 옵션을 사용하여 cookie.txt 파일을 지정할 수도 있습니다.
또는 --cookies-from-browser 사용하여 쿠키를 추출하는 브라우저:
gallery-dl --cookies "$HOME/path/to/cookies.txt" "URL"gallery-dl --cookies-from-browser firefox "URL"
gallery-dl은 일부 추출기에 대해 OAuth를 통한 사용자 인증을 지원합니다. 이는 pixiv 에 필요하며 deviantart , flickr , reddit , smugmug , tumblr 및 mastodon 인스턴스에는 선택 사항입니다.
귀하의 계정을 gallery-dl 에 연결하면 귀하의 계정을 대신하여 요청을 발행할 수 있는 능력이 부여되고 일반 사용자가 사용할 수 없는 리소스에 액세스할 수 있게 됩니다.
그렇게 하려면 oauth:<sitename> 인수로 사용하여 호출부터 시작하세요. 예를 들어:
gallery-dl oauth:flickr
사이트의 인증 페이지로 이동하고 gallery-dl 에 대한 읽기 액세스 권한을 부여하라는 메시지가 표시됩니다. 이를 승인하면 구성 파일에 추가되어야 하는 하나 이상의 "토큰"이 표시됩니다.
mastodon 인스턴스로 인증하려면 oauth:mastodon:<instance> 인수로 사용하여 gallery-dl을 실행하세요. 예를 들어:
gallery-dl oauth:mastodon:pawoo.net gallery-dl oauth:mastodon:https://mastodon.social/
