치지직 다운로드 도구는 버전 0.86부터 치지직 라이브 다운로드 도구인 Chzzk Live Downloader의 괸리 도구인 치지직 라이브 다운로드 관리자 Chzzk Launcher를 포함하고 있습니다.
치지직 라이브 다운로드 도구가 콘솔 기반의 문자 사용자 인터페이스(CUI, Character User Interface)이다 보니 사용에 어려움을 느끼는 분들이 계실 것이라고 생각합니다. 이러한 상황을 개선하기 위해 버전 0.84부터는 외부에서 관리할 수 있는 JSON-RPC 통신 기능과 이 기능을 활용하는 예제 소스 코드를 공개하고 있습니다. 이를 활용하면 누구나 쉽게 치지직 라이브 다운로드 도구를 외부에서 제어할 수 있습니다.
하지만 개발자가 아닌 분들에게는 역시 실제로 활용할 수 있는 도구가 필요하다는 의견이 많아, 일주일 가량 시간적 여유가 생긴 틈을 타서 라이브 관리 도구를 개발하게 되었습니다.
공지사항
- 초기 버전에 해당하는 버전 0.8x는 기능이 계속 추가되고 개선되고 있기 때문에, 채널 목록 파일이나 설정 파일과 같이 관리자에서 사용하는 데이터 파일의 형식을 최적화하는 단계입니다. 따라서 이전 버전에서 사용했던 파일을 열려고 하면 파일의 형식이 맞지 않는다는 오류가 발생할 수 있습니다. 당분간은 번거로우시겠지만 채널을 다시 추가하여 채널 목록 파일을 다시 저장하시거나 설정을 다시 해 주시기 바랍니다.
- 2024년 8월부터 실시되는 Microsoft의 SmartScreen 관련 인증서 정책의 변화로 인해 바이러스나 멀웨어로 오탐지될 가능성이 대폭 증가한 관계로 반드시 다운로드 시 바이러스 오탐지 관련 공지를 먼저 읽고 다운로드하시기 바랍니다.
choonholic.com사설 인증서로 서명이 되어 있으니 안전한 사용을 위해 서명 여부를 확인하시기 바랍니다.
다운로드
다운로드 페이지를 통해 버전 0.86부터 제공되는 향상된 설치 프로그램을 다운로드하실 수 있으며, 기존의 무설치 버전 역시 다운로드 페이지를 통해 다운로드하실 수 있습니다.
치지직 라이브 다운로드 관리자 특징
- 기존의 Chzzk Live Downloader에서 제공하던 기능을 대부분 지원합니다.
- 외부에서 이미 실행 중인 다운로더를 가져와 관리하는 방식과 직접 실행하는 방식을 모두 지원합니다.
- 여러 개의 채널을 동시에 관리할 수 있습니다.
- 채널 정보를 여러 벌 저장해 두었다가 상황에 따라 선택해 불러올 수 있습니다.
- Python과 같은 별도의 개발 환경을 설치할 필요가 없습니다.
치지직 라이브 다운로드 관리자 갱신 내역
Chzzk Downloader Suite 갱신 내역 페이지를 참고하세요.
치지직 라이브 다운로드 관리자 사용 방법
상세한 내용은 추후 갱신할 예정이며, 현 시점의 문서에서는 간단한 사용 방법만 정리하니 양해 바랍니다.
선행 요건
- 치지직 라이브 다운로드 관리자는 치지직 라이브 다운로드 도구의 GUI 프론트엔드로서, 치지직 라이브 다운로드 도구가 함께 설치되어 있어야 합니다.
- 치지직 라이브 다운로드 관리자와 치지직 라이브 다운로드 도구가 같은 디렉터리에 설치되어 있으면 실행 시 자동으로 감지히게 되며, 그렇지 않으면 뒤의 선행 요건 확인하기 항목의 내용을 따라 치지직 라이브 다운로드 도구를 지정해 주어야 합니다.
- 수동으로 설치할 경우,
ChzzkLauncher.exe실행 파일을ChzzkLiveDownloader.exe실행 파일이 있는 디렉토리로 복사하면 편리하게 사용할 수 있으며, 설치 프로그램을 사용할 경우, Chzzk Live Downloader와 Chzzk Launcher를 선택하면 자동으로 같은 디렉터리에 설치됩니다.
실행하기
- 시작 메뉴에서 Chzzk Launcher 항목을 실행하거나
ChzzkLauncher.exe파일을 실행합니다.
선행 요건 확인하기
치지직 라이브 다운로드 관리자가 제대로 실행되려면, 치지직 라이브 다운로드 도구가 제대로 설정되어 있어야 합니다. 이와 더불어 치지직 라이브 다운로드 도구는 Streamlink와 FFmpeg이 제대로 설치되어 있어야 정상적으로 동작합니다. 치지직 라이브 다운로드 관리자가 처음 실행될 때 이와 같은 선행 요건을 모두 확인하는 과정을 거치며, 이를 만족하지 못할 경우 다음 그림과 같은 대화 상자가 표시됩니다.
Settings… 버튼을 클릭하면 치지직 라이브 다운로드 도구의 위치를 지정할 수 있으며, Download 버튼을 클릭하면 Streamlink와 FFmpeg을 다운로드할 수 있으므로, 필요할 경우 설치를 진행합니다.
… 버튼을 누르고 다음 그림과 같이 파일 선택 대화 상자가 열리면 올바른 ChzzkLiveDownloader.exe 파일을 찾아 지정합니다.
올바른 파일이 지정되면 다음 그림과 같이 인식된 버전 정보가 표시됩니다.
설정이 완료되면 다음 그림과 같은 초기 화면이 표시됩니다.
주 메뉴 열기
창의 왼쪽 위에 있는 ☰ 아이콘을 누르면 다음 그림과 같이 주 메뉴(Main Menu)가 실행됩니다.
채널 추가하기
관리할 채널을 추가하려면 ☰ 아이콘을 클릭하고, Add Channel… 항목을 선택하면 다음 그림과 같이 채널의 UID 또는 라이브 스트리밍 주소를 입력할 수 있는 대화 상자가 열립니다.
Streamer UID / Live URL – 다음과 같은 세 가지 정보 중 하나를 입력하면 자동으로 UID를 인식합니다.
| 스트리밍 URL | https://chzzk.naver.com/live/UID |
| 채널 URL | https://chzzk.naver.com/UID |
| 스트리머 UID | UID |
Target Quality – 목표 해상도를 입력합니다.
best,1080p,720p와 같은 값을 입력할 수 있습니다.- Chzzk Live Downloader와 마찬가지로 변형된 해상도를 사용하는 경우, 예상되는 해상도보다 큰 값을 입력해 두면 자동으로 가장 가까운 해상도로 설정됩니다. (예:
1200p→1080p)
LINE Notification Level – LINE 알림 수준을 입력합니다.
None– 알림을 발송하지 않습니다.Brief information and critical errors– 기본 정보와 치명적 오류에 대한 알림을 발송합니다.Brief information and all errors– 기본 정보와 모든 오류에 대한 알림을 발송합니다.Verbose information and critical errors– 상세 정보와 치명적 오류에 대한 알림을 발송합니다.All information and all errors– 모든 정보와 오류에 대한 알림을 발송합니다.
채널 상태 확인하기
채널의 프로필 이미지 우측 하단에는 채널의 연결 상태를 표시하는 작은 아이콘이 표시됩니다.
아이콘에 따른 상태는 다음 표와 같습니다.
| 아이콘 | 의미 |
|---|---|
 | 채널이 연결 중임을 표시합니다. |
 | 채널이 다운로드 중임을 표시합니다. |
 | 채널의 연결이 끊어졌거나 내부적으로 중지된 상태임을 표시합니다. |
채널 삭제하기
더 이상 관리하지 않는 채널을 삭제하려면, 목록에서 삭제할 채널을 선택한 다음 ☰ 아이콘을 클릭하고 Remove Channel 항목을 선택합니다. 채널 삭제 여부를 확인하는 대화 상자에서 OK 버튼을 클릭하면 채널이 삭제됩니다.
삭제한 채널이 다운로드 중이었을 경우, 다운로드는 삭제 시점에서 중단되며, 최종 단계의 처리까지 완료된 후 저장됩니다.
채널 복구하기
만약 Chzzk Live Downloader의 프로세스가 외부의 영향으로 비정상 종료되는 등의 이유로 Launcher와의 연결이 끊어졌을 경우, 프로세스를 재시작하여 연결할 수 있습니다.
만약 연결이 끊어진 상태에서 다운로드가 계속 이루어지고 있었을 경우, 다운로드가 해당 시점에서 일단 종료된 후 다시 시작됩니다.
현재 라이브 스트리밍을 다운로드하지 않고 넘기기
현재 다운로드 중인 스트리밍을 더 이상 다운로드하지 않고 넘기려면, 목록에서 넘길 채널을 선택한 다음 ☰ 아이콘을 클릭하고 Skip Current 항목을 선택합니다.
채널 등록 정보 확인하기
목록에서 등록 정보를 확인할 채널을 선택한 다음 ☰ 아이콘을 클릭하고 Properties… 항목을 선택합니다.
상황에 따른 메뉴
목록에서 채널을 선택한 후 마우스 오른쪽 버튼을 클릭하면 다음 그림과 같이 해당 채널의 상황에 따른 메뉴(Context Menu)가 열립니다.
채널 목록 저장하기
현재 관리 중인 채널 목록은 목록 파일로 저장했다가 다음에 필요할 때 불러올 수 있습니다.
목록에 채널이 하나 이상 존재하는 상태에서 ☰ 아이콘을 클릭하고 Save Channels… 항목을 선택하면 다음 그림과 같이 파일을 저장할 디렉터리와 이름을 변경할 수 있는 대화 상자가 열립니다.
채널 목록 불러오기
매번 채널을 추가하는 대신 저장했던 채널 목록을 불러와서 추가할 수 있습니다.
☰ 아이콘을 클릭하고 Load Channels… 항목을 선택하면 다음 그림과 같이 채널 목록 파일을 선택할 수 있는 대화 상자가 열립니다.
채널 목록 갱신하기
☰ 아이콘을 클릭하고 Refresh 항목을 선택하면 채널 목록이 즉시 갱신됩니다.
시작할 때 채널 목록 자동으로 불러오기
주로 관리하는 채널이 고정되어 있는 경우 매번 불러오는 작업이 번거로울 수 있습니다. 설정에서 다음 항목을 설정하면 시작할 때 지정된 채널 목록을 자동으로 불러옵니다.
- ☰ 아이콘을 클릭하고 Settings… 항목을 선택해 설정 대화 상자를 엽니다.
- Features 탭에서 Load Channels at Startup 항목을 활성화한 다음 Path: 항목 옆의 … 버튼을 눌러 불러올 채널 목록 파일을 선택합니다.
- 다음 시작 시부터 다음 그림과 같이 지정된 채널 목록을 자동으로 불러옵니다.
외부에서 실행 중인 치지직 라이브 다운로드 도구 인스턴스 관리하기
치지직 라이브 다운로드 도구는 치치직 다운로드 관리자 없이도 단독 실행이 가능한 도구이기 때문에, 관리자를 통하지 않고 실행하는 경우가 있을 수 있습니다. 하지만 이렇게 별도로 실행 중인 경우에도 다음 설정을 통해 시작 시에 실행 여부를 확인하여 채널 목록에 자동으로 추가하여 관리할 수 있습니다.
- Features 탭에서 Scan Running Instances at Startup 항목을 활성화합니다.
- ID Ranges to Scan 항목에 탐색할 ID의 범위를 지정합니다. 이 때 ID는 Chzzk Live Downloader를 실행할 때 다음과 같이
-i또는--id매개 변수를 통해 지정하는 값으로, 아래와 같이 실행했다면 탐색 범위에 3을 지정하면 됩니다.
ChzzkLiveDownloader -i 3- 탐색할 ID의 범위에는 0부터 31까지의 값을 지정할 수 있으며 ID 또는 ID의 범위를 다음과 같이 입력할 수 있습니다.
~3, 6, 8-10, 13~15- 위의 예와 같이 지정했을 경우 탐색하는 ID의 범위는 0, 1, 2, 3, 6, 8, 9, 10, 13, 14, 15입니다.
- 채널 탐색과 채널 목록 불러오기 기능을 함께 설정했을 경우에는, 먼저 채널을 탐색한 후, 채널 목록을 불러와 빈 자리를 채우면서 추가됩니다.
치지직 다운로드 도구 환경 열기
☰ 아이콘을 클릭하고 Downloader 항목 안의 Open Environment 항목 중 원하는 것을 선택하면 각각의 설정에 맞는 치지직 다운로드 도구 환경이 열립니다.
다운로드 결과 디렉터리 열기
☰ 아이콘을 클릭하고 Downloader 항목 안의 Open Output Directory 항목을 누르면 다운로드가 왼료된 스트리밍 영상이 저장되는 결과 디렉터리가 열립니다.
Chzzk Live Downloader 설정 확인하기
☰ 아이콘을 클릭하고 Downloader 항목 안의 View Configuration… 항목을 누르면 Chzzk Live Downloader의 설정을 확인할 수 있습니다.
종료 시 Chzzk Live Downloader 종료 방식 설정하기
관리자를 종료할 때, 백그라운드에서 Chzzk Live Downloader가 다운로드를 계속 하도록 설정하거나, 관리자 종료와 함께 모든 다운로드 도구를 함께 종료하도록 설정할 수 있습니다.
종료 시 다음 조건을 만족하면 위와 같은 대화 상자가 표시됩니다.
- 채널 목록에 관리 중인 채널이 존재하는 경우
- 관리자와 별도로 외부에서 하나 이상의 Chzzk Live Downloader의 인스턴스가 실행 중인 경우
외부에서 실행 중인 인스턴스를 포함한 모든 인스턴스를 강제로 종료하려면:
- Forcefully shutdown all instances (Administrator privileges may be required) 항목을 선택하고 Yes 버튼을 클릭합니다.
- 이 종료 방식이 기본 설정입니다.
채널 목록에서 현재 관리 중인 채널만 종료하려면:
- Requests shutdown gracefully (for managed instances only) 항목을 선택하고 Yes 버튼을 클릭합니다.
백그라운드에서 다운로드를 계속하려면:
- No 버튼을 클릭합니다.
종료 단계를 취소하고 계속 관리자를 사용하려면:
- Cancel 버튼을 클릭합니다.
기타 설정
Features
- Update Interval (Seconds) – 목록의 화면 갱신 주기를 설정합니다. 이는 화면에만 영향을 미치며, 다운로드 확인 주기와는 관계가 없습니다. Chzzk Live Downloader의 다운로드 확인 주기는 기본적으로 60초로 설정되어 있으며, 다른 도구와 달리 API의 호출 제한에 영향받지 않도록 설계되어 있습니다.
- Performance Level – Chzzk Live Downloader가 실행 중인 시스템의 성능을 지정합니다. 채널을 추가하거나 삭제할 때 시간 초과로 인한 오류가 발생한다면, 이 설정을 한 단계 아래로 낮춰 볼 수 있습니다.
Downloader
- JSON-RPC Server: Host Address – JSON-RPC 서버 호스트 주소를 설정합니다.
- JSON-RPC Server: Port – JSON-RPC 서버 포트 번호를 설정합니다.
- Instance Shutdown Methods – 종료 대화 상자에서 매번 종료 방법을 설정하는 대신 이 곳에서 미리 설정해 둘 수 있습니다.
Directory
- Working Directory – Chzzk Live Downloader의 작업 설정 파일이 저장되는 디렉터리를 지정합니다.
- Output Directory – 다운로드가 완료된 영상 파일이 저장되는 디렉터리를 지정합니다.
- Temporary Directory – 임시로 생성되는 파일이 저장되는 디렉터리를 지정합니다.
About
- 치지직 다운로드 관리자의 버전 정보를 확인하거나 제작자의 SNS에 연결할 수 있습니다.
문의하기
궁금하신 점이나 문제가 있으실 경우에는 아래 메일로 문의주시기 바랍니다.
E-mail: choonholic at outlook dot com
2 thoughts on “치지직 라이브 다운로드 관리자: Chzzk Launcher”