FAQ

자주 하시는 질문 및 답변 (FAQ) 묶음입니다.

Q1. 이 아이들이 하는 일은 무엇인가요?

치지직의 실시간 방송과 다시보기 그리고 클립을 다운로드하는 도구입니다. 치지직의 기본 설정 상, 실시간 방송을 놓쳤더라도 다시보기로 볼 수 있는 영상이 대다수지만, 다음과 같은 일부 방송은 다시보기가 제공되지 않습니다.

12시간 이상 진행된 방송은 12시간까지만 다시 보기가 저장됩니다.
스트리머가 다시 보기를 설정하지 않은 방송은 다시 보기가 불가능합니다.

치지직에서는 추적 녹화가 불가능하기 때문에 녹화를 시작한 시점부터만 녹화가 가능합니다. (물론 클립을 생성할 때 사용되는 타임머신 API를 사용하면 10분 전부터 녹화가 가능하며, Chzzk Live Downloader도 이를 이용하고 있습니다.) 따라서 방송을 시작하기 전에 미리 대기하고 있다가 방송의 시작을 감지하여 녹화를 시작하는 도구가 필요합니다.

Chzzk Live Downloader는 일부 다른 도구와 달리 다음과 같은 채널도 방송 시작 감지가 가능합니다.

개설은 되어 있으나 한 번도 방송을 하지 않은 신규 채널
30일 이상 방송을 하지 않은 채널

Chzzk Video Downloader는 치지직의 다시보기 비디오를 가장 빠르게 다운로드할 수 있는 다운로드 도구이며, Chzzk Clip Downloader는 치지직의 클립을 편리하게 다운로드할 수 있는 몇 안 되는 도구 중 하나입니다.

Q2. 다운로드하려고 하면 바이러스라고 하는데, 혹시 진짜 바이러스나 멀웨어인가요?!

다운로드 시 바이러스 오탐지 관련 공지에서 이에 대한 내용을 자세히 확인하실 수 있습니다.

Q3. 갱신 내역은 어떻게 확인하나요?

배포 바이너리에는 별도의 갱신 내역 문서가 포함되어 있지 않습니다. 대신 Chzzk Downloader Suite 갱신 내역에서 상세 내역을 확인하실 수 있습니다.

Q4. 다운로드하기 번거로운데 갱신이 너무 잦은 것 아닌가요?

먼저 너무 잦은 갱신으로 인해 불편을 끼쳐 드린 점 양해 말씀 드립니다.

사용하시는 분들이 극소수였던 예전에는 치지직도 초기여서 시행착오가 많았고, 기능 개선도 사실 상 점진적으로 이루어지다 보니 자체적인 오류나 문제점을 수정하는 것으로 충분했고, 그러다 보니 너무 치명적인 오류가 아닌 이상 갱신을 서두를 필요가 없었습니다. 물론 그 때도 최소 한 달에 한 번, 평균 2주에 한 번씩은 새로운 기능을 추가하거나 불편한 점을 개선하기 위한 갱신을 진행해 왔습니다.

하지만 치지직이 오픈한지도 어언 1년이 넘어가고, 어느 정도 사용자들이 늘어가면서 저희가 미처 알아채지 못했던 문제점도 많이 드러나고, 영상의 제목을 짓는 스트리머의 성향이나 영상을 다운로드하는 사용자의 성향처럼 수정 필요성이 매우 다양하게 늘어나면서 오류와 문제점의 수정 뿐만 아니라 새로운 기능에 대한 요청 역시 기하급수적으로 늘어나게 되었습니다.

버전 1.0 이후로는 로드맵(Roadmap)에 따라 미리 예정되어 있던 기능을 추가하거나 개선할 때는 기능의 복잡도에 따라 2주에서 한 달에 한 번 갱신하며, 버전 번호 중 중간 번호가 변경됩니다. (예: 버전 1.2.x → 버전 1.3.0) 반면에, 예정에 없던 치지직 API의 변경으로 인한 오류 수정, 사용이 불가능하거나 매우 어려워지는 문제점과 오류 대응 수정과 같은 사항이 존재할 때는 비정기적으로 갱신하며, 기능 변경 범위에 따라 버전 번호의 중간 번호나 말단 번호가 변경됩니다. (예: 버전 1.3.1 → 버전 1.3.2 또는 버전 1.3.x → 버전 1.4.0)

하지만 너무 잦은 갱신이 불편하시거나 사정 상 직접 페이지를 방문하여 갱신하고 싶으신 경우에는 갱신 알림을 꺼두고 싶으실 수 있습니다. 문자 기반 사용자 인터페이스 버전의 도구에서는 새 버전이 있을 경우 메시지만 출력되기 때문에 별도의 갱신 확인 중지 기능이 없습니다. 하지만 그래픽 기반 사용자 인터페이스 버전의 도구에서는 매번 새로운 대화 상자가 열리기 때문에, 이를 끌 수 있도록 확인 여부 지정 설정을 제공합니다.

Q5. 실행하면 ‘`An error occurred while initializing internal modules.`‘ 메시지와 함께 종료되는데요?

Chzzk Downloader Suite에 포함된 모든 다운로드 도구는 실행 시 별도의 전용 내부 모듈을 적재하여 사용합니다. 이 때 현재 지역 환경에 해당 모듈이 설치되어 있지 않거나, 모듈이 여러 가지 이유로 손상되어 있으면 서버에서 모듈을 다시 다운로드하려고 시도합니다. 이 때 다운로드를 할 수 없으면 이 메시지와 함께 도구의 실행이 종료됩니다. 다운로드를 할 수 없는 원인 중에 다음의 몇 가지가 대다수를 차지하고 있습니다.

첫 번째는 인터넷을 사용할 수 없는 경우입니다. 당연한 이야기지만, Chzzk Downloader Suite는 인터넷에서 실시간 스트림, 다시 보기 비디오, 클립을 다운로드하는 도구이기 때문에 인터넷을 사용할 수 없으면 사용할 수 없습니다. 따라서 인터넷을 사용할 수 있는지 확인해 주세요.

두 번째는 download.choonholic.com의 서버가 점검 중일 경우입니다. 서버는 여러 가지 이유로 가동에 문제가 발생할 수 있으며, 이럴 경우 어쩔 수 없이 짧은 시간이라도 서버의 점검이 필요할 수 있습니다. 하지만 최초 실행이 아니라면 대부분의 경우 지역 환경에 설치된 모듈을 사용하기 때문에 너무 걱정하실 필요는 없습니다. 0.80 버전부터는 다운로드 서버를 이중화하여 해당 문제를 조금이나마 줄일 수 있도록 개선하였습니다.

세 번째는 너무 오래된 버전을 실행하고 있을 경우입니다. 이전 버전인 경우 실행에 문제가 없으면 그대로 사용하셔도 문제 없으나, 새 버전은 대부분 치지직의 API 변경이나 보안 문제 등을 해결하기 위한 것으로, 가급적 새로운 버전이 갱신되면 바로 설치하시는 것을 권장합니다. 새 버전이 갱신되어도 구 버전의 모듈이 곧바로 삭제되는 것은 아니며, 보안 상 문제가 없을 경우 당분간 유지됩니다.

네 번째는 잘못된 버전을 실행하고 있을 경우입니다. 이는 매우 희귀한 경우이긴 하지만, 설치 파일의 배포 서버에 저장되어 있는 버전과 모듈 배포 서버에 저장되어 있는 버전이 일치하지 않는 경우가 발생할 수 있습니다. 이런 경우에는 다운로드 페이지를 다시 방문하여 동일한 버전이라고 하더라도 다시 한 번 다운로드하여 설치하면 해결됩니다.

Q6. 오픈 소스로 공개하면 안 되나요?

다음과 같은 몇 가지 이유로 인해 오픈 소스로 공개하고 있지 않으며, 앞으로도 공개할 예정이 없습니다.

개발에 오픈 소스를 활용하고 있지 않기 때문에 오픈 소스 라이센스 정책에 해당하지 않습니다.
실행 파일 생성을 위해 상용 라이브러리를 사용하고 있기 때문에 오픈 소스로 공개가 불가능합니다.

Q7. 다운로드 속도가 다른 도구보다 빠른 이유가 무엇인가요?

간단하게 설명드리면 두 가지 이유가 있습니다.

첫 번째로, 다운로드할 데이터를 DASH 스트림 형태로 요청하는 대신, 서버에 저장되어 있는 파일을 직접 가져옵니다. 이를 통해 최대 1.6 MiB/s라는 속도 제한을 회피할 수 있습니다. 이 방식은 Hitomi Downloader와 같은 도구에서도 사용하고 있습니다.

두 번째로, 서버에 다운로드를 요청하는 방식을 개선하여 요청 당 전송 속도를 끌어올리고 있습니다. 이러한 개선을 통해 Aria2와 비교하더라도 4배 이상, Hitomi Downloader와 비교하더라도 30% 이상 빠른 속도를 구현할 수 있었습니다.

또한 버전 0.79부터 새로운 경량 다운로드 모듈의 개발을 완료하였고, 이 모듈을 사용할 경우에도 거의 동일한 속도를 보여줍니다. 다운로드 속도 측정 결과는 치지직 비디오 다운로드 성능 측정에서 더 자세히 살펴보실 수 있습니다.

Q8. 개발 언어와 개발 도구는 어떤 것을 사용하고 있나요?

처음 몇 개의 버전은 빠른 개발이 가능한 Python으로 개발을 시작하였습니다. 그러나 이후 Chzzk Video Downloader의 개발을 시작하면서 빠른 다운로드 기능의 구현을 위해 C11/C++03 기반의 C/C++ 언어로 일부 코드를 개발하기 시작했으며, 지금은 Python과 C11/C++03 기반의 C/C++ 코드가 혼재되어 있습니다. 특히 Chzzk Live Manager, Chzzk Video Manager, Chzzk Clip Manager는 C++ 기반의 코드로만 구성되어 있습니다.

개발에 사용하고 있는 도구 목록은 다음과 같습니다.

Visual Studio 2022 (C11/C++03 Compiler 14.3)
Visual Studio Code
Miniconda with Python 3.13.0

Q9. Windows 전용 애플리케이션으로 개발하는 이유가 있나요? Linux나 MacOS용 애플리케이션으로 개발할 의향은 없나요?

안정성을 위해 Windows 콘솔 기반의 사용자 환경에서만 동작하는 기능을 도입하게 되었고, 이 시점을 기준으로 Windows 전용으로 전환하게 되었습니다. MacOS를 사용하는 분들은 대부분 개발자이실테니 비공식적으로 알려진 치지직의 API와 streamlink를 이용하여 기본적인 다운로드 기능에 국한하면 이와 유사한 도구를 매우 쉽게 구현하실 수 있을 것으로 생각됩니다. 또한 안타깝게도 제 입장에서 완벽한 도구는 아직 발견하지 못했지만, 오픈 소스로 공개된 도구도 몇 가지 있으므로 해당 도구를 참고하셔도 좋은 결과가 있을 것입니다.

또한 Python 기반으로 배포되는 다른 도구들을 사용하는데 있어 개발 도구나 개발 시스템에 대해 알지 못하거나 알 필요가 없는 많은 분들이 어려움을 겪고 있으며, 개발자가 아님에도 개발 도구를 설치해야 하는 점을 해소하기 위해 Windows 실행 파일 형식으로 최적화하여 배포하고 있습니다.

Q10. 다운로드한 라이브 영상의 크기가 너무 큰데, 줄일 수 있는 방법은 없나요?

라이브 스트림 데이터 특성 상 프레임 보간(Frame Interpolation)이 되지 않은 비압축에 가까운 데이터가 그대로 저장되기 때문에 파일의 크기가 매우 큽니다. 이를 해결하려면 받은 영상을 다시 외부 인코딩 도구를 사용하여 재인코딩하거나, 치지직 라이브 최종 처리 확장 도구인 Chzzk Live Finalizer를 사용하여 파일의 크기를 줄일 수 있습니다.

애초에 동영상 인코딩은 많은 시스템 자원을 필요로 하므로, 다운로드 채널의 수가 많다면, 다운로드에 사용하는 장치와 최종 처리나 재인코딩에 사용하는 장치를 분리하시는 것을 강력하게 권장합니다.

Q11. 삭제는 어떻게 하나요?

설치 파일을 사용하여 설치한 경우에는 다른 일반적인 앱과 동일한 방법으로 시작 메뉴 → 설정 → 앱 → 설치된 앱 (Start Menu → Settings → Apps → Installed Apps) 목록에서 Chzzk Downloader Suite 항목을 통해 삭제할 수 있습니다.

무설치 파일을 사용하는 경우에는 압축을 푼 디렉터리 자체를 삭제하거나, 디렉터리의 내용을 전부 삭제하는 것만으로도 깔끔하게 제거할 수 있습니다.

Q12. 인증 서명은 어떻게 확인하나요?

Chzzk Downloader Suite의 모든 실행 파일과 DLL 파일은 모두 choonholic.com 사설 인증서로 서명이 되어 있으며, 서명 여부는 다음과 같이 확인하실 수 있습니다.

File Explorer(파일 탐색기)를 열어서 Chzzk Downloader Suite가 설치된 경로로 이동합니다. 설치 파일의 서명을 확인하려면 설치 파일을 다운로드한 경로로 이동합니다.
ChzzkLiveDownloader.exe와 같이 서명을 확인하려는 파일을 선택하고 마우스 오른쪽 버튼을 누릅니다.
상황에 따른 메뉴에서 등록 정보(Properties) 항목을 선택합니다.
디지털 서명(Digital Signatures) 탭을 선택합니다.
포함된 서명(Embedded Signatures) 목록에서 choonholic.com을 선택하고, 자세히(Details) 버튼을 클릭합니다.
아래 그림과 같이 올바르게 서명되어 있는지 확인합니다.

이외에 자주 하시는 질문 및 답변 (FAQ)

Q. 어떤 파일을 받아야 하나요?

일반적으로는 설치 파일인 ChzzkDownloaderSetup_x.y.z.exe 파일을 받아 설치하시면 되며, 실행 파일을 바로 다운로드하지 못하도록 차단된 환경에서는 압축 파일인 ChzzkDownloaderSetup_x.y.z.zip 파일을 받으시면 됩니다.

설치 없이 직접 특정 기능만 사용하실 분들께서는 기능별 압축 파일인 Chzzk...Downloader_x.y.z.zip 파일을 다운로드하셔서 압축을 풀어 사용하시면 됩니다.

사용자 안내서를 비롯한 각종 PDF 문서 파일은 언어별로 ChzzkDownloaderSuite_aa-BB_x.y.z.zip 파일을 받아 확인하실 수 있습니다.

Q. 치지직 개발자 센터가 오픈했는데 어떤 것들이 달라질까요?

안타깝게도 2024년 12월 20일에 열린 베타 버전 기준으로 치지직 개발자 센터에서 제공하는 API는 치지직 다운로드 도구가 활용하고 있는 기능들과 관계가 거의 없었습니다.

개발자 센터의 목적은 서드 파티를 통해 치지직으로의 유입을 늘리는 것이 목적이기에 채팅과 스트리머 본인이 활용하는 기능을 위한 앱들이 등장할 가능성이 높습니다. 물론 추후 새로운 API가 추가로 개발된다면 어떤 것들을 지원하는지 살펴보고 추가하거나 개선할 수 있는 부분이 있다면 적극 적용해 나갈 예정입니다.

문의하기

아래에 나열된 질문과 답변 내용 이외에 치지직 다운로드 도구에 대해 궁금한 사항, 제보할 오류, 개선 요청 사항 등이 있을 때는 GitHub의 Issues 기능을 통해 제보해 주세요. 모든 언어에 대응 가능하나, 직접 대응 가능한 언어는 한국어, 영어, 일본어, 중국어이며, 다른 언어는 기계 번역을 통하기 때문에 100% 대응이 불가능할 수 있습니다.

If you have any questions, bug reports, or improvement requests regarding the Chzzk Downloader Suite except the following Q&A, please submit them through GitHub‘s Issues feature. We can respond to all languages; however, the languages we directly support are Korean, English, Japanese, and Chinese. For other languages, responses may not be fully accurate due to the use of machine translation.

Chzzk Downloader Suiteに関するご質問、バグ報告、または改善要望がございましたら、GitHubのIssues機能を通じてお知らせください。全ての言語に対応可能ですが、直接対応可能な言語は韓国語、英語、日本語、中国語です。他の言語については、機械翻訳を通じて対応するため、100%正確に対応できない場合があります。