지난 4월 말에 공개한 치지직 라이브 다운로드 도구인 Chzzk Live Downloader에 이어서 치지직의 다시보기 영상을 초고속으로 다운로드해 주는 치지직 비디오 다운로드 도구 Chzzk Video Downloader를 공개합니다.
공지사항
- 2024년 8월부터 실시되는 Microsoft의 SmartScreen 관련 인증서 정책의 변화로 인해 바이러스나 멀웨어로 오탐지될 가능성이 대폭 증가한 관계로 반드시 다운로드 시 바이러스 오탐지 관련 공지를 먼저 읽고 다운로드하시기 바랍니다.
choonholic.com사설 인증서로 서명이 되어 있으니 안전한 사용을 위해 서명 여부를 확인하시기 바랍니다.
다운로드
다운로드 페이지를 통해 버전 0.86부터 제공되는 향상된 설치 프로그램을 다운로드하실 수 있으며, 기존의 무설치 버전 역시 다운로드 페이지를 통해 다운로드하실 수 있습니다.
치지직 비디오 다운로드 특징
- 현재 네트워크 전송 환경에서 사용 가능한 전송 속도를 최대한으로 사용합니다. 1Gbps 라인 기준으로 사용자 수가 적고 라인과 서버 상태가 양호한 시간대라면 최대 100MiB/s 이상의 전송 속도로 다운로드할 수 있습니다.
- 여러 개의 비디오를 목록 파일에 담아 순차적으로 다운로드할 수 있습니다.
- 프로필 이미지를 다운로드합니다.
- 미리보기 이미지를 다운로드할 수 있습니다.
.mp4형식으로 다운로드되며,Streamlink를 통해 다운로드하는 영상과는 아주 미세하게 다를 수 있습니다.- 다운로드 품질을 지정할 수 있습니다. (
144p,720p,1080p) - JSON-RPC 통신 기능을 사용하여 외부에서 제어할 수 있습니다.
- Python과 같은 별도의 개발 환경을 설치할 필요가 없습니다.
치지직 비디오 다운로드 갱신 내역
Chzzk Downloader Suite 갱신 내역 페이지를 참고하세요.
치지직 비디오 다운로드 사용하기
Chzzk Video Downloader는 엉성한 GUI보다는 단단한 CUI를 목표로 하고 있기 때문에 사용 방법이 일견 복잡해 보이지만, 익숙해지면 쉽게 사용하실 수 있습니다. 물론 CUI의 사용이 어려운 분들을 위해 가능성이 그리 높지는 않지만 추후 여력이 되면 GUI Frontend의 개발도 고려하고 있습니다. 일단 버전 0.84에서 JSON-RPC 기반의 통신 기능이 추가되었으니 이를 활용하시는 것을 권장합니다.
더 자세한 내용이 필요하실 경우, 배포되는 파일 안의 chzzk_video_downloader_manual.pdf 파일을 참조하시는 것을 권장합니다. 아직까지는 블로그에서 대부분의 사용 방법을 설명하고 있지만, 추후 기능이 더 확장되면 블로그에 모든 설명을 담는 것이 어려울 수 있기 때문입니다.
다운로드할 비디오 지정
다시보기 비디오를 다운로드하려면 해당 비디오의 번호 또는 전체 URL을 알고 있어야 합니다.
예를 들면 비디오의 URL이 https://chzzk.naver.com/video/1602969일 경우 비디오 번호는 1602969입니다. 이 비디오를 다운로드하려면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader 1602969
ChzzkVideoDownloader https://chzzk.naver.com/video/1602969여러 개의 비디오를 순차적으로 다운로드하려면, 다음과 같이 목록 파일을 생성하고, UTF-8 인코딩의 텍스트 파일로 저장합니다. 여기서는 list.txt라는 이름으로 저장했다고 가정합니다.
# List Samples
https://chzzk.naver.com/video/2676946
2555164
https://chzzk.naver.com/video/2631744
https://chzzk.naver.com/video/2620211
https://chzzk.naver.com/video/2590216
2453109이 때 # 로 시작하는 줄은 주석(Comment)으로 인식되어 처리 대상에서 제외됩니다.
파일을 생성했으면, 다음 명령어를 사용하여 다운로드할 수 있습니다.
ChzzkVideoDownloader -i list.txt
ChzzkVideoDownloader --input list.txt인증 정보 재설정하기
성인 전용 컨텐츠처럼 NAVER 인증이 필요한 라이브 스트리밍을 다운로드하려면 반드시 다음 정보를 지정해야 합니다.
- 네이버 ID 인증 값 (
NID_AUT) - 네이버 ID 세션 값 (
NID_SES)
필요한 인증 정보를 찾을 수 없으면, 인증 정보를 입력할 수 있는 지시어가 활성화됩니다.
이 값을 한 번 입력해 두면, 기본 인증 정보로 설정되며, 이후 실행 시에는 별도의 입력 없이 이 값을 사용해 실행합니다. 인증 정보를 얻는 방법은 how_to_get_chzzk_credential.pdf 문서를 참조하시기 바랍니다.
인증 정보가 변경되거나 또는 다른 아이디로 로그인하여 인증 정보를 재설정해야 할 경우 다음의 명령어를 사용합니다.
ChzzkVideoDownloader video_no 또는 url -a
ChzzkVideoDownloader video_no 또는 url --auth-y나 --yes 매개 변수를 지정하면, 확인 절차 없이 필요할 때 인증 정보 지시어가 자동으로 활성화됩니다.
ChzzkVideoDownloader video_no 또는 url -y
ChzzkVideoDownloader video_no 또는 url --yes[참고]NID_AUT 값은 웹 브라우저의 쿠키와 캐시가 완전히 삭제되는 등의 이유로 아이디와 비밀번호를 전부 입력하여 로그인할 때마다 변경되며, NID_SES 값은 인증 정보 저장 여부와 관계없이 로그인할 때마다 변경됩니다. 하지만 NID_SES 값만 바뀌는 경우에는 굳이 새로 인증 정보를 설정하지 않아도 되므로, NID_AUT 값이 바뀔 때만 다시 설정해도 무방합니다.
다운로드 품질 지정하기
기본적으로 모든 스트리밍을 최상의 품질로 다운로드합니다. 하지만 저장 공간이나 여러 가지 이유로 다른 품질로 저장하고 싶을 경우에는 다음의 명령어를 사용합니다.
ChzzkVideoDownloader video_no 또는 url -q 720p
ChzzkVideoDownloader video_no 또는 url --quality 720p만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 -q 또는 --quality 매개 변수만 지정하면 됩니다.
ChzzkVideoDownloader video_no 또는 url -q
ChzzkVideoDownloader video_no 또는 url --quality다운로드 파일 이름 형식 지정하기
기본적으로 모든 비디오와 미리보기 이미지 파일은 [{live_date}][{name}] {title} 형식의 이름으로 저장됩니다. 이 형식을 변경하려면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader video_no 또는 url -n "[{name}][{category}] {title}"
ChzzkVideoDownloader video_no 또는 url --name "[{name}][{category}] {title}"만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 형식 정보 없이 --name 매개 변수만 지정하면 됩니다.
ChzzkVideoDownloader -i n 또는 url -n
ChzzkVideoDownloader --input n 또는 url --name파일 이름에 사용할 수 있는 태그
다음과 같이 미리 정의된 태그를 파일 이름 지정에 사용할 수 있습니다.
{name}– 채널 이름.{verified}– 인증된 채널일 경우[✓]가 설정되며, 그렇지 않은 경우 빈 문자열이 반환됩니다.{title}– 라이브 스트리밍 제목.{category}– 라이브 스트리밍 분류.{live_date...}– 라이브 스트리밍 시작 날짜와 시각 관련 태그.{publish_date...}– 다시보기 비디오 게시 날짜와 시각 관련 태그.{media...}– 미디어 정보 관련 태그.
미디어 정보 관련 태그는 다음과 같은 세부 요소 태그를 사용할 수 있습니다.
{media_quality}– 비디오 인코딩 품질. (예:1080p){media_video_width}– 픽셀 단위의 비디오 가로 크기. (예:1920){media_video_height}– 픽셀 단위의 비디오 세로 크기. (예:1080){media_video_framerate}– fps 단위의 비디오 프레임 레이트 값. (예:60.0){media_bitrate}– bps 단위의 비디오 비트레이트 값. (예:8192000){media_video_codec}– 비디오 코덱. (예:H264)
또한 날짜와 시각 관련 태그는 다음과 같이 확장된 세부 요소 태그를 사용할 수 있습니다.
{..._date}– ‘YYYYMMDDhhmmss‘ 형식의 날짜와 시각. (예:20240607014327){..._date_year}또는{..._date_year_full}– 세기가 포함된 년을 나타내는 숫자. (예:2024){..._date_year_short}-세기가 포함되지 않은 년을 나타내는 두 자리 숫자. (예:24){..._date_month}– 월을 나타내는 두 자리 숫자. (01,02, …,12){..._date_month_full}– 월을 나타내는 전체 이름. (January,February, …,December){..._date_month_short}– 월을 나타내는 축약 이름. (Jan,Feb, …,Dec){..._date_day}– 날을 나타내는 두 자리 숫자. (01,02, …,31){..._date_hour}– 24시간제의 시를 나타내는 두 자리 숫자. (00,01, …,23){..._date_minute}– 분을 나타내는 두 자리 숫자. (00,01, …,59){..._date_second}– 초를 나타내는 두 자리 숫자. (00,01, …,59)
미리보기 이미지 저장하기
미리보기 이미지를 별도로 저장하려면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader video_no 또는 url --thumb이 설정을 다시 초기화하려면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader video_no 또는 url --thumb skip다운로드 상세 정보 표시 방식 지정하기
기본적으로 다운로드 상세 정보를 표시하도록 설정되어 있습니다. 하지만 상세 정보가 굳이 필요하지 않다면 다음의 명령어를 사용하여 정보가 출력되지 않도록 할 수 있습니다.
ChzzkVideoDownloader video_no 또는 url -d quiet
ChzzkVideoDownloader video_no 또는 url --display quiet이 설정을 다시 초기화하려면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader video_no 또는 url -d
ChzzkVideoDownloader video_no 또는 url --display작업 디렉터리 지정하기
다음의 명령어를 사용하여 실행에 필요한 파일이 저장되는 디렉터리를 지정할 수 있습니다.
ChzzkVideoDownloader video_no 또는 url --work work만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 디렉터리 없이 --work 매개 변수만 지정하면 됩니다.
ChzzkVideoDownloader video_no 또는 url --work저장 디렉터리 지정하기
다음의 명령어를 사용하여 다운로드한 파일이 최종적으로 저장되는 디렉터리를 지정할 수 있습니다. 다운로드된 파일들은 채널별로 구분되어 저장됩니다.
ChzzkVideoDownloader video_no 또는 url --out out만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 디렉터리 없이 --out 매개 변수만 지정하면 됩니다.
ChzzkVideoDownloader video_no 또는 url --out임시 디렉터리 지정하기
다음의 명령어를 사용하여 다운로드 중인 파일이 임시로 저장되는 디렉터리를 지정할 수 있습니다.
ChzzkVideoDownloader video_no 또는 url --temp temp만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 디렉터리 없이 --temp 매개 변수만 지정하면 됩니다.
ChzzkVideoDownloader video_no 또는 url --temp다운로드 방식 설정하기
경량 다운로드 모듈이 추가로 포함되어 있습니다. 새 모듈을 사용하려면 다음 옵션을 사용합니다.
ChzzkVideoDownloader video_no 또는 url --download alter설정 적용 방식 지정하기
모든 설정은 기본적으로 항상 설정 파일에 저장됩니다. 만약 매개 변수로 지정된 설정을 저장하지 않고 현재 세션에만 적용하고 싶다면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader --settings skip단, 다음 정보는 이 매개 변수와 관계 없이 항상 저장됩니다.
- 네이버 ID 인증 값 (
NID_AUT) - 네이버 ID 세션 값 (
NID_SES)
만약 다운로드 작업 없이 설정만 변경하고 싶을 때는 다음의 명령어를 사용합니다.
ChzzkVideoDownloader --settings quit설정 초기화
사용하다 보면 여러 가지 정보가 뒤섞여서 설정을 초기화하고 싶을 수 있습니다. 모든 설정을 초기화하려면 다음의 명령어를 사용합니다.
ChzzkVideoDownloader --reset이 때 초기화되는 정보는 다음과 같습니다.
- 네이버 ID 인증 값 (
NID_AUT) - 네이버 ID 세션 값 (
NID_SES) - 다운로드 품질 지정 정보
- 미리보기 이미지 저장 설정
- 다운로드 상태 상세 출력 설정
- 저장 디렉터리와 임시 디렉터리 설정
치지직 비디오 다운로드 버전 정보 확인하기
다음의 명령어를 사용하여 버전 정보를 확인할 수 있습니다.
ChzzkVideoDownloader --version치지직 비디오 다운로드 도움말 확인하기
다음의 명령어를 사용하여 간단한 매개 변수 도움말을 확인할 수 있습니다.
ChzzkVideoDownloader -h
ChzzkVideoDownloader --help매개 변수 우선 순위
설정을 초기화하는 --reset 매개 변수, 도움말을 확인하는 -h 매개 변수, 버전 정보를 확인하는 --version 매개 변수를 제외하면 매개 변수끼리 상성이 존재하지 않으므로 다음처럼 순서에 상관없이 사용할 수 있습니다. 단, 동일한 매개 변수를 여러 개 사용할 수는 없습니다.
ChzzkVideoDownloader 1602969 -x --out out-h, --version 매개 변수는 먼저 사용된 매개 변수만 처리되고 곧바로 종료됩니다. 따라서 다음의 명령어는 버전 정보만 출력됩니다.
ChzzkVideoDownloader --version -h--reset 매개 변수는 기존에 설정된 모든 값을 무시하고 설정을 초기화하고 종료됩니다. 따라서 다음의 명령어에서 비디오 번호는 무시됩니다.
ChzzkVideoDownloader 1602969 --reset추천 초기 설정
매개 변수 중에 첫 실행 시 지정해 두면 편한 설정은 다음과 같습니다. 아래와 같이 실행하면 작업 디렉터리(--work), 저장 디렉터리(--out), 임시 디렉터리(--temp)가 한꺼번에 지정되므로 다운로드되는 영상 파일들을 쉽게 정리할 수 있습니다.
ChzzkVideoDownloader video_no 또는 url --work work --out out --temp tempJSON-RPC 통신 기능을 사용하여 외부에서 제어하기
how_to_control_chzzk_video_downloader.pdf 파일을 참고하세요.
치지직 비디오 다운로드 도구에 대한 문의
사용 시 궁금하신 점이나 문제가 있으실 경우에는 아래 메일로 문의주시기 바랍니다.
E-mail: choonholic at outlook dot com
3 thoughts on “치지직 비디오 다운로드: Chzzk Video Downloader”