치지직 라이브 다운로드: Chzzk Live Downloader

치지직에서 아주 가끔 (진짜로 아주 아주 아주 가아아아아끔… 😉) 팬들과 소통 방송을 하시는 윤태진 아나운서님의 치지직 라이브 스트리밍을 다운로드하기 위해 만들기 시작한 Chzzk Live Downloader라는 이름의 치지직 라이브 다운로드 도구입니다.

공지사항

• 2024년 8월부터 실시되는 Microsoft의 SmartScreen 관련 인증서 정책의 변화로 인해 바이러스나 멀웨어로 오탐지될 가능성이 대폭 증가한 관계로 반드시 다운로드 시 바이러스 오탐지 관련 공지를 먼저 읽고 다운로드하시기 바랍니다.
• choonholic.com 사설 인증서로 서명이 되어 있으니 안전한 사용을 위해 서명 여부를 확인하시기 바랍니다.

다운로드

다운로드 페이지를 통해 버전 0.86부터 제공되는 향상된 설치 프로그램을 다운로드하실 수 있으며, 기존의 무설치 버전 역시 다운로드 페이지를 통해 다운로드하실 수 있습니다.

추가 설치 필요 프로그램

Chzzk Live Downloader를 사용하려면 다음의 프로그램이 반드시 설치되어 있어야 합니다.

• FFmpeg (https://ffmpeg.org, https://www.gyan.dev/ffmpeg/builds/)
  • 최신 안정(stable) 버전인 7.1을 권장합니다.
  • Codex ffmpeg에서 더 작은 크기의 essential 버전을 사용해도 모든 기능을 활용할 수 있습니다.
  • 직접 다운로드해도 사용에 지장은 없지만, 신규 버전 확인을 통한 갱신이나 실행 경로 등록 등의 부가 기능을 사용하려면 how_to_install_ffmpeg.pdf 문서를 참조하여 PowerShell에서 winget을 사용하여 설치하는 것이 편리합니다.
• Streamlink (https://streamlink.github.io/)
  • 최신 안정(stable) 버전인 6.11.0을 권장합니다.
  • Python 개발자가 아니라면 pip 설치보다 Windows 설치 파일을 사용한 설치를 권장합니다.

치지직 라이브 다운로드 특징

• 라이브 스트리밍의 방송 시간에 관계 없이 송출 쪽에서 끊거나 변경하지 않는 이상 연속 다운로드가 가능합니다. (8시간 30분 10초 제한 없음)
• 치지직의 타임 머신 API를 활용하여 최대한 이른 시간(녹화 시작 시간 기준 최대 10분 전부터)의 영상을 다운로드할 수 있습니다.
• 현재 방송 중인 라이브 스트리밍을 별도 설정 저장 없이 다운로드할 수 있습니다.
• 라이브 스트리밍 방송을 한 번도 하지 않거나 또는 방송을 장기간 또는 한 번도 하지 않아 라이브 정보가 없는 경우에도 정상적인 상태 확인과 방송 대기가 가능합니다.
• 프로필 이미지를 다운로드합니다.
• 미리보기 이미지를 다운로드할 수 있습니다.
• 기본적으로 .ts 형식으로 다운로드되지만, 설정에 따라 다운로드 완료 후 .mp4 형식으로 자동 변환할 수 있습니다. 단, 24시간 연속 방송을 다운로드하는 경우에는 기능을 끄고 외부에서 별도의 변환기를 사용해야 방송이 끊기지 않습니다.
• LINE 알림을 통해 다운로드 현황을 실시간 감시할 수 있습니다.
• 다운로드 품질을 지정할 수 있습니다.
• 라이브 스트리밍 시작을 감시하고 자동으로 다운로드를 시작하고 종료합니다. (최소 1초부터 최대 10분까지 1초 단위로 설정 가능)
• JSON-RPC 통신 기능을 사용하여 외부에서 제어할 수 있습니다.
• Python과 같은 별도의 개발 환경을 설치할 필요가 없습니다.

치지직 라이브 다운로드 갱신 내역

Chzzk Downloader Suite 갱신 내역 페이지를 참고하세요.

치지직 라이브 다운로드 사용하기

Chzzk Live Downloader는 엉성한 GUI보다는 단단한 CUI를 목표로 하고 있기 때문에 사용 방법이 일견 복잡해 보이지만, 익숙해지면 쉽게 사용하실 수 있습니다. 물론 CUI의 사용이 어려운 분들을 위해 가능성이 그리 높지는 않지만 추후 여력이 되면 GUI Frontend의 개발도 고려하고 있습니다. 일단 버전 0.84에서 JSON-RPC 기반의 통신 기능이 추가되었으니 이를 활용하시는 것을 권장합니다.

더 자세한 내용이 필요하실 경우, 배포되는 파일 안의 chzzk_live_downloader_manual.pdf 파일을 참조하시는 것을 권장합니다. 아직까지는 블로그에서 대부분의 사용 방법을 설명하고 있지만, 추후 기능이 더 확장되면 블로그에 모든 설명을 담는 것이 어려울 수 있기 때문입니다.

초기 설정

치지직 라이브 다운로드를 처음 설정할 때 알고 있어야 하는 정보는 다음과 같습니다.

• 라이브 스트리밍을 다운로드하거나 상태를 확인할 채널의 UID

처음 실행 시에는 다음과 같이 매개 변수 없이 실행하면 됩니다.

ChzzkLiveDownloader

추천 초기 설정은 문서 뒷부분의 추천 초기 설정 항목을 참고하시기 바랍니다.

여러 채널 동시 다운로드하기

여러 개의 채널을 동시에 다운로드하려면 Command Prompt나 PowerShell을 새로 열어서 실행하면 됩니다. 하지만 그냥 실행하면 무조건 처음에 등록한 UID만 다운로드하기 때문에, 새로운 UID를 지정하려면 다음과 같이 새로운 ID를 지정하면 됩니다.

ChzzkLiveDownloader -i n
ChzzkLiveDownloader --id n

이렇게 지정한 UID는 다음에 실행할 때 동일한 매개 변수를 지정하면 기존에 저장된 UID를 인식하여 자동으로 라이브 스트리밍 상태를 확인하고 다운로드합니다.

특정 ID의 UID 설정 또는 재설정하기

UID 설정하기

특정 ID에 UID를 설정하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader -i n -u uid or url
ChzzkLiveDownloader --id n --uid uid or url

기본 ID에 지정된 UID를 변경하려면 위에서 n 값에 0을 지정하거나 또는 다음과 같이 -u 또는 --uid 매개 변수만 지정하여 변경할 수 있습니다.

ChzzkLiveDownloader -u uid or url
ChzzkLiveDownloader --uid uid or url

UID 재설정하기

특정 ID에 지정된 UID를 재설정하려면 다음의 명령어를 사용합니다. 이 때 해당 ID에 UID가 지정되어 있지 않았더라도 재설정이 가능합니다.

ChzzkLiveDownloader -i n -u
ChzzkLiveDownloader --id n --uid

기본 ID에 지정된 UID를 변경하려면 위에서 n 값에 0을 지정하거나 또는 다음과 같이 -u 또는 --uid 매개 변수만 지정하여 변경할 수 있습니다.

ChzzkLiveDownloader -u
ChzzkLiveDownloader --uid

현재 방송 중인 라이브 스트리밍만 채널 설정 없이 다운로드하기

채널 설정 없이 특정 URL의 라이브 스트리밍을 바로 다운로드하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --once url

인증 정보 재설정하기

성인 전용 컨텐츠처럼 NAVER 인증이 필요한 라이브 스트리밍을 다운로드하려면 반드시 다음 정보를 지정해야 합니다.

• 네이버 ID 인증 값 (NID_AUT)
• 네이버 ID 세션 값 (NID_SES)

필요한 인증 정보를 찾을 수 없으면, 인증 정보를 입력할 수 있는 지시어가 활성화됩니다.

이 값을 한 번 입력해 두면, 기본 인증 정보로 설정되며, 이후 실행 시에는 별도의 입력 없이 이 값을 사용해 실행합니다. 인증 정보를 얻는 방법은 how_to_get_chzzk_credential.pdf 문서를 참조하시기 바랍니다.

인증 정보가 변경되거나 또는 다른 아이디로 로그인하여 인증 정보를 재설정해야 할 경우 다음의 명령어를 사용합니다.

ChzzkLiveDownloader -a
ChzzkLiveDownloader --auth

-y나 --yes 매개 변수를 지정하면, 확인 절차 없이 필요할 때 인증 정보 지시어가 자동으로 활성화됩니다.

ChzzkLiveDownloader -y
ChzzkLiveDownloader --yes

[참고]
NID_AUT 값은 웹 브라우저의 쿠키와 캐시가 완전히 삭제되는 등의 이유로 아이디와 비밀번호를 전부 입력하여 로그인할 때마다 변경되며, NID_SES 값은 인증 정보 저장 여부와 관계없이 로그인할 때마다 변경됩니다. 하지만 NID_SES 값만 바뀌는 경우에는 굳이 새로 인증 정보를 설정하지 않아도 되므로, NID_AUT 값이 바뀔 때만 다시 설정해도 무방합니다.

다운로드 품질 지정하기

기본적으로 모든 스트리밍을 최상의 품질로 다운로드합니다. 하지만 저장 공간이나 여러 가지 이유로 다른 품질로 저장하고 싶을 경우에는 다음의 명령어를 사용합니다. 또한, 스트리밍이 표준 해상도를 사용하고 있지 않을 경우, 자동으로 지정한 해상도와 가장 가까운 품질을 선택하여 다운로드합니다.

ChzzkLiveDownloader -q 720p
ChzzkLiveDownloader --quality 720p

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 -q 또는 --quality 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader -q
ChzzkLiveDownloader --quality

다운로드 파일 이름 형식 지정하기

기본적으로 모든 비디오와 미리보기 이미지 파일은 [{live_date}][{name}] {title} 형식의 이름으로 저장됩니다. 이 형식을 변경하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader -n "[{name}][{category}] {title}"
ChzzkLiveDownloader --name "[{name}][{category}] {title}"

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 형식 정보 없이 --name 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader -n
ChzzkLiveDownloader --name

파일 이름에 사용할 수 있는 태그

다음과 같이 미리 정의된 태그를 파일 이름 지정에 사용할 수 있습니다.

• {name} – 채널 이름.
• {verified} – 인증된 채널일 경우 [✓]가 설정되며, 그렇지 않은 경우 빈 문자열이 반환됩니다.
• {title} – 라이브 스트리밍 제목.
• {category} – 라이브 스트리밍 분류.
• {live_date...} – 라이브 스트리밍 시작 날짜와 시각 관련 태그.
• {download_date...} – 다운로드 시작 날짜와 시각 관련 태그.
• {media...} – 미디어 정보 관련 태그.

미디어 정보 관련 태그는 다음과 같은 세부 요소 태그를 사용할 수 있습니다.

• {media_quality} – 비디오 인코딩 품질. (예: 1080p)
• {media_encoding_track_id} – 인코딩 트랙 ID. (예: 1080p)
• {media_video_profile} – 비디오 프로파일. (예: high)
• {media_audio_profile} – 오디오 프로파일. (예: LC)
• {media_video_codec} – 비디오 코덱. (예: H264)
• {media_video_bitrate} – bps 단위의 비디오 비트레이트 값. (예: 8000000)
• {media_audio_bitrate} – bps 단위의 오디오 비트레이트 값. (예: 192000)
• {media_video_framerate} – fps 단위의 비디오 프레임 레이트 값. (예: 60.0)
• {media_video_width} – 픽셀 단위의 비디오 가로 크기. (예: 1920)
• {media_video_height} – 픽셀 단위의 비디오 세로 크기. (예: 1080)
• {media_audio_sampling_rate} – Hz 단위의 오디오 샘플링 레이트 값. (예: 48000)
• {media_audio_channel} – 오디오 채널 수. (예: 2)
• {media_video_dynamic_range} – 비디오의 다이내믹 레인지 설정. (예: SDR)

날짜와 시각 관련 태그는 다음과 같이 확장된 세부 요소 태그를 사용할 수 있습니다.

• {..._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)

라이브 스트리밍 상태 확인 간격 설정하기

기본적으로 라이브 스트리밍의 시작 상태를 확인하는 간격은 60초(1분)로 설정되어 있습니다. 이 값을 변경하려면 다음의 명령어를 사용합니다. n에 지정 가능한 값은 1에서 3600까지로 초 단위입니다. 즉, 상태 확인 간격은 1초에서 10분 내에서 지정 가능합니다.

ChzzkLiveDownloader --detect n

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 --detect 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader --detect

LINE 알림 설정

치지직 라이브 다운로드나 상태 확인 상황을 LINE 알림으로 확인할 수 있습니다. LINE 알림을 받으려면 LINE Notify에서 접근 토큰(Access Token)을 발급받아야 합니다. 첨부된 how_to_issue_access_token_for_line_notification.pdf 문서를 참조하여 접근 토큰을 발급받은 후 다음의 명령어를 사용하여 등록해 주세요.

ChzzkLiveDownloader --ntoken ACCESSTOKEN

접근 토큰이 설정되면 다음 그림과 같이 다운로드 상황을 LINE을 통해 실시간으로 확인할 수 있습니다.

LINE 알림 수준 설정

--nlevel 매개 변수에 선택 사항을 지정하여 LINE 알림 수준을 결정할 수 있습니다.

• reset – 접근 토큰을 재설정하고 알림 수준을 info로 설정합니다.
• remove – 접근 토큰을 삭제하고 알림 수준을 none으로 설정합니다.
• none – 알림을 발송하지 않습니다. 단, 접근 토큰이 이미 설정되어 있어도 삭제되지 않습니다.
• info – 기본 정보와 치명적 오류에 대한 알림을 발송합니다. --nlevel 매개 변수의 기본값입니다.
• error – 기본 정보와 모든 오류에 대한 알림을 발송합니다.
• verbose – 상세 정보와 치명적 오류에 대한 알림을 발송합니다.
• all – 모든 정보와 오류에 대한 알림을 발송합니다.

ChzzkLiveDownloader --nlevel error

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 --nlevel 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader --nlevel

미리보기 이미지 저장하기

미리보기 이미지를 별도로 저장하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --thumb

이 설정을 다시 초기화하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --thumb skip

후처리 단계 작업 방식 지정하기

ChzzkLiveDownloader는 기본적으로 실시간 다운로드 단계에서는 .ts 확장자를 가지는 MPEGTS 형식으로 다운로드합니다. 그리고 다운로드가 완료되면 이를 후처리 단계에서 .mp4 확장자를 가지는 MPEG4 형식으로 변환(transcoding)합니다. 이 때, 이 과정을 처리하는 방식을 --final 매개 변수를 통해 지정할 수 있습니다.

ChzzkLiveDownloader --final all

--final 매개 변수에 선택 사항을 지정하여 후처리 단계 작업 방식을 지정할 수 있습니다.

• none – .ts 중간 파일을 받은 후 변환 단계를 건너뜁니다. 이 중간 파일을 올바르게 재생하려면 외부 변환기를 사용하여 변환 과정을 따로 거쳐야 합니다.
• convert – .ts 중간 파일을 .mp4 파일로 변환합니다. 이 때 .ts 중간 파일을 삭제하지 않습니다.
• cleanup – .ts 중간 파일을 .mp4 파일로 변환한 후, .ts 중간 파일을 삭제해 정리합니다.
• all – cleanup과 동일합니다.

ChzzkLiveDownloader --final convert

설정을 다시 초기화하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --final

시작 시간 설정

다음 명령어를 사용하여 스트림의 시작 시간을 지정해 다운로드할 수 있습니다.

ChzzkLiveDownloader --offset 30

--offset 매개 변수에 기본적으로 지정되는 시간은 초 단위입니다. 하지만 다음과 같이 시, 분, 초, 밀리초를 사용하여 지정할 수도 있습니다.

ChzzkLiveDownloader --offset 1:23:45.67
ChzzkLiveDownloader --offset 1h23m45.67s

다운로드 길이 설정 및 분할 다운로드

다음 명령어를 사용하여 스트림의 길이를 지정해 다운로드할 수 있습니다. 만약 –once 매개 변수가 지정되어 있지 않으면, 스트림은 지정된 길이로 분할되어 다운로드됩니다.

ChzzkLiveDownloader --duration 3600

--duration 매개 변수에 기본적으로 지정되는 시간은 초 단위입니다. 하지만 다음과 같이 시, 분, 초, 밀리초를 사용하여 지정할 수도 있습니다.

ChzzkLiveDownloader --duration 1:23:45.67
ChzzkLiveDownloader --duration 1h30m45.67s

스트림 처리 방식 설정

ChzzkLiveDownloader는 기본적으로 최대한 이른 시간의 스트림 데이터를 받아올 수 있도록 치지직의 타임 머신 API를 활용해 스트림 정보를 확인합니다. 하지만 다음의 명령어를 사용하여 스트림 처리 방식을 원하는 방식으로 설정할 수 있습니다.

ChzzkLiveDownloader --stream standard

--stream 매개 변수에 선택 사항을 지정하여 스트림 데이터 처리 방식을 지정할 수 있습니다.

• standard – 치지직 기본 API를 통해 스트림 정보를 확인합니다.
• timemachine – 치지직 타임 머신 API를 통해 스트림 정보를 확인합니다.

ChzzkLiveDownloader --stream timemachine

설정을 다시 초기화하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --stream

다운로드 상세 정보 표시 방식 지정하기

기본적으로 다운로드 상세 정보를 표시하도록 설정되어 있습니다. 하지만 상세 정보가 굳이 필요하지 않다면 다음의 명령어를 사용하여 정보가 출력되지 않도록 할 수 있습니다.

ChzzkLiveDownloader -d quiet
ChzzkLiveDownloader --display quiet

이 설정을 다시 초기화하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader -d
ChzzkLiveDownloader --display

작업 디렉터리 지정하기

다음의 명령어를 사용하여 실행에 필요한 파일이 저장되는 디렉터리를 지정할 수 있습니다.

ChzzkLiveDownloader --work work

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 디렉터리 없이 --work 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader --work

저장 디렉터리 지정하기

다음의 명령어를 사용하여 다운로드한 파일이 최종적으로 저장되는 디렉터리를 지정할 수 있습니다. 다운로드된 파일들은 채널별로 구분되어 저장됩니다.

ChzzkLiveDownloader --out out

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 디렉터리 없이 --out 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader --out

임시 디렉터리 지정하기

다음의 명령어를 사용하여 다운로드 중인 파일이 임시로 저장되는 디렉터리를 지정할 수 있습니다.

ChzzkLiveDownloader --temp temp

만약 기본 설정으로 되돌리고 싶다면 다음과 같이 단순하게 디렉터리 없이 --temp 매개 변수만 지정하면 됩니다.

ChzzkLiveDownloader --temp

설정 적용 방식 지정하기

모든 설정은 기본적으로 항상 설정 파일에 저장됩니다. 만약 매개 변수로 지정된 설정을 저장하지 않고 현재 세션에만 적용하고 싶다면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --settings skip

단, 다음 정보는 이 매개 변수와 관계 없이 항상 저장됩니다.

• 채널 UID 정보
• 채널 UID 별 다운로드 품질 정보
• 채널 UID 별 LINE 알림 설정
• 네이버 ID 인증 값 (NID_AUT)
• 네이버 ID 세션 값 (NID_SES)

만약 다운로드 작업 없이 설정만 변경하고 싶을 때는 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --settings quit

설정 초기화

사용하다 보면 여러 가지 정보가 뒤섞여서 설정을 초기화하고 싶을 수 있습니다. 모든 설정을 초기화하려면 다음의 명령어를 사용합니다.

ChzzkLiveDownloader --reset

이 때 초기화되는 정보는 다음과 같습니다.

• 저장된 모든 채널 UID 정보
• 채널 UID 별 다운로드 품질 지정 정보
• 채널 UID 별 LINE 알림 설정
• 네이버 ID 인증 값 (NID_AUT)
• 네이버 ID 세션 값 (NID_SES)
• 라이브 스트리밍 상태 확인 간격
• 미리보기 이미지 저장 설정
• 다운로드 상태 상세 출력 설정
• 최종 단계 영상 변환 설정
• 저장 디렉터리와 임시 디렉터리 설정

치지직 라이브 다운로드 버전 정보 확인하기

다음의 명령어를 사용하여 버전 정보를 확인할 수 있습니다.

ChzzkLiveDownloader --version

치지직 라이브 다운로드 도움말 확인하기

다음의 명령어를 사용하여 간단한 매개 변수 도움말을 확인할 수 있습니다.

ChzzkLiveDownloader -h
ChzzkLiveDownloader --help

매개 변수 우선 순위

설정을 초기화하는 --reset 매개 변수, 도움말을 확인하는 -h 매개 변수, 버전 정보를 확인하는 --version 매개 변수를 제외하면 매개 변수끼리 상성이 존재하지 않으므로 다음처럼 순서에 상관없이 사용할 수 있습니다. 단, 동일한 매개 변수를 여러 개 사용할 수는 없습니다.

ChzzkLiveDownloader -i 1 -u --detect 30 --final bypass

-h, --version 매개 변수는 먼저 사용된 매개 변수만 처리되고 곧바로 종료됩니다. 따라서 다음의 명령어는 버전 정보만 출력됩니다.

ChzzkLiveDownloader --version -h

--reset 매개 변수는 기존에 설정된 모든 값을 무시하고 설정을 초기화하고 종료됩니다. 따라서 다음의 명령어에서 --detect 매개 변수는 무시됩니다.

ChzzkLiveDownloader --detect 30 --reset

추천 초기 설정

매개 변수 중에 첫 실행 시 지정해 두면 편한 설정은 다음과 같습니다. 아래와 같이 실행하면 작업 디렉터리(-w), 저장 디렉터리(-o), 임시 디렉터리(-t)가 한꺼번에 지정되므로 다운로드되는 영상 파일들을 쉽게 정리할 수 있습니다.

ChzzkLiveDownloader -work work -out out -temp temp

JSON-RPC 통신 기능을 사용하여 외부에서 제어하기

how_to_control_chzzk_live_downloader.pdf 파일을 참고하세요.

치지직 라이브 다운로드 도구에 대한 문의

사용 시 궁금하신 점이나 문제가 있으실 경우에는 아래 메일로 문의주시기 바랍니다.

E-mail: choonholic at outlook dot com