최근 치지직의 일부 API가 기능이 약간 추가되어 Chzzk Downloader Suite도 이에 대응하기 위해 새로운 버전을 공개하였습니다. 그런데 그 과정에서 변경된 일부 코드로 인해 Chzzk Downloader Suite 사용 시 빈번하게 발생하고 있는 문제 유형과 해결 방안 몇 가지를 알려드리고자 합니다.
채널 추가가 안 되는 문제 유형과 해결 방안
대부분의 경우 Windows Defender, Windows Security, Windows SmartScreen을 비롯한 안티 바이러스 솔루션에서 ChzzkLiveDownloader.exe, ChzzkVideoDownloader.exe, ChzzkClipDownloader.exe가 차단된 경우입니다. 최근 버전에서 치지직 API의 기능 추가에 따라 일부 코드가 갱신되었는데, 이것이 안티 바이러스 솔루션의 심기를 건드렸는지, 다시 차단되는 등의 문제가 빈번하게 보이고 있습니다.
물론 차단된 프로그램을 그대로 사용하시는 것이 껄끄러우신 분들은 어쩔 수 없이 다른 솔루션을 사용하시라고 권해드릴 수 밖에 없는 상황이지만, Chzzk Downloader Suite가 유용하다고 생각하시는 경우에는 Chzzk Downloader Suite가 설치된 디렉터리를 안티 바이러스 솔루션에서 예외로 지정하시면 문제 없이 사용하실 수 있습니다. 참고로 기본 설치 디렉터리는 다음과 같습니다.
C:\Users\<사용자이름>\AppData\Roaming\ChzzkDownloaderSuite
자세한 내용과 대응 방안은 다운로드 시 바이러스 오탐지 관련 공지에서 확인하실 수 있습니다.
만약 위에서 언급된 파일들이 차단되거나 삭제되지 않았음에도 채널 추가가 되지 않는다면, 설정에서 성능 수준을 한 단계 아래로 낮춰서 다시 시도해 보시기 바랍니다.
실행 도중에 갑자기 모든 채널에 주의 아이콘이 표시되는 문제 유형과 해결 방안
치지직 라이브 관리자의 경우, 실행 도중에 다운로드 도구와 연결이 끊어지면 다음 그림과 같이 주의 아이콘이 표시됩니다.
특정 채널만 연결이 끊어진 경우라면, 채널 복구하기 기능을 사용하여 재연결하면 되지만, 때로는 모든 채널이 동시에 끊어지는 경우가 있습니다. 이 경우는 대부분 첫 번째 문제와 같이 안티 바이러스 솔루션이 차단한 경우입니다. 따라서 이런 문제가 자주 발생하신다면 다른 다운로드 도구를 찾아보시거나 혹은 위의 방법을 사용하여 차단을 해제하고 예외 처리를 하시면 정상적으로 사용하실 수 있습니다.
바이러스나 위협이라고 표시되는 이유
Chzzk Downloader Suite는 일부 코드를 Python으로 작성하고 있습니다. 물론 여러분께 제공해 드리는 앱의 최종 코드는 이미 C/C++을 이용해 컴파일된 결과지만, 내부에는 여전히 Python 관련 코드와 DLL이 함께 포함되어 있는 상태입니다. 그런데 이러한 Python 관련 코드가 작성이 쉽고, 그 특성 상 사용자의 코드를 변형할 수 있는 기능을 제공하기 때문에 일부 안티 바이러스 솔루션은 Python 코드를 컴파일했다는 이유만으로 잠재적인 위협(Potentially Threats)으로 간주하고 있습니다.
만약 검사 결과가 다음과 같은 이름의 위협인 경우, 실제 위협이라기 보다는 위의 상황에 해당하는 경우가 많습니다.
Trojan:Win32/Wacatac.B!ml(관련 정보)
위의 링크에 따르면 단순히 공격자가 선택한 몇 가지 작업을 수행할 가능성이 있다고 나오지만, 그 작업이 무엇인지 그리고 왜 위협이 되는지에 대해서는 언급하고 있지 않아 추가적인 대응이 불가능합니다. 따라서 많은 코드가 이러한 문제를 겪고 있으며, 이는 긴 시간동안 다운로드와 실행이 반복되어 평판이 쌓이면서 해결됩니다만, 치지직의 API가 지속적으로 변경되고 있다 보니 다운로드 도구들은 이를 따라갈 수 밖에 없고, 그러다 보면 평판이 쌓일 시간이 주어지지 않게 됩니다. (설마 일부러 그러는 거니?)
이러한 점을 고려하셔서 사용 여부를 신중히 결정하시고, 다운로드하신 파일에 이상이 있는지도 꼭 확인하시기 바랍니다.
‘An error occurred while initializing internal modules.’ 오류 문제 유형과 해결 방안
Chzzk Downloader Suite에 포함된 모든 다운로드 도구는 실행 시 별도의 전용 내부 모듈을 적재하여 사용합니다. 이 때 현재 지역 환경에 해당 모듈이 설치되어 있지 않거나, 모듈이 여러 가지 이유로 손상되어 있으면 서버에서 모듈을 다시 다운로드하려고 시도합니다. 이 때 다운로드를 할 수 없으면 이 메시지와 함께 도구의 실행이 종료됩니다. 다운로드를 할 수 없는 원인 중에 다음의 몇 가지가 대다수를 차지하고 있습니다.
첫 번째는 인터넷을 사용할 수 없는 경우입니다. 당연한 이야기지만, Chzzk Downloader Suite는 인터넷에서 실시간 스트림, 다시 보기 비디오, 클립을 다운로드하는 도구이기 때문에 인터넷을 사용할 수 없으면 사용할 수 없습니다. 따라서 인터넷을 사용할 수 있는지 확인해 주세요.
두 번째는 download.choonholic.com의 서버가 점검 중일 경우입니다. 서버는 여러 가지 이유로 가동에 문제가 발생할 수 있으며, 이럴 경우 어쩔 수 없이 짧은 시간이라도 서버의 점검이 필요할 수 있습니다. 하지만 최초 실행이 아니라면 대부분의 경우 지역 환경에 설치된 모듈을 사용하기 때문에 너무 걱정하실 필요는 없습니다. 0.80 버전부터는 다운로드 서버를 이중화하여 해당 문제를 조금이나마 줄일 수 있도록 개선하였습니다.
세 번째는 너무 오래된 버전을 실행하고 있을 경우입니다. 이전 버전인 경우 실행에 문제가 없으면 그대로 사용하셔도 문제 없으나, 새 버전은 대부분 치지직의 API 변경이나 보안 문제 등을 해결하기 위한 것으로, 가급적 새로운 버전이 갱신되면 바로 설치하시는 것을 권장합니다. 새 버전이 갱신되어도 구 버전의 모듈이 곧바로 삭제되는 것은 아니며, 보안 상 문제가 없을 경우 당분간 유지됩니다.
네 번째는 잘못된 버전을 실행하고 있을 경우입니다. 이는 매우 희귀한 경우이긴 하지만, 설치 파일의 배포 서버에 저장되어 있는 버전과 모듈 배포 서버에 저장되어 있는 버전이 일치하지 않는 경우가 발생할 수 있습니다. 이런 경우에는 다운로드 페이지를 다시 방문하여 동일한 버전이라고 하더라도 다시 한 번 다운로드하여 설치하면 해결됩니다.
Python 버전 충돌 관련 문제 유형과 해결 방안
Python 기반의 프로그램이 여러 개 실행되는 환경에서, 각자 참조하고 있는 Python 번역기의 버전이 서로 다른 경우 문제가 발생할 수 있습니다. 뿐만 아니라 각 프로그램이 사용하고 있는 서드 파티 모듈의 버전이 충돌하는 경우도 비일비재하며, 특정 프로그램이 갱신되거나 환경을 갱신하면서 서드 파티 모듈을 업데이트하면 갑자기 다른 프로그램이 실행되지 않는 경우도 어렵지 않게 발견할 수 있습니다.
물론 Python 개발자는 이러한 문제를 회피하기 위해 Anaconda나 venv와 같은 가상 환경을 통해 이 문제를 해결하지만, 일반적인 사용자의 경우 이를 알 방법도 실행할 방법도 없습니다. 더군다나 프로그램을 배포하는 쪽에서도 이러한 내용에 대해서는 누구 하나 제대로 알려주지 않습니다. 너무 방대하고 복잡하거든요. 따라서 개발자가 아닌 분들이 소스 코드나 스크립트 형태로 배포되는 프로그램을 사용할 경우 시스템 환경이 박살날 가능성도 충분히 고려하셔야 합니다.
이에 대해서는 Python 코드 배포의 늪이라는 글에서 자세히 설명하고 있으니, 관심 있으신 분들께서는 한 번 읽어 보시기 바랍니다.
Chzzk Live Downloader의 경우 Python의 영향을 받는 부분이 딱 한 군데 존재하는데, 바로 Streamlink 호출 관련 부분입니다. Streamlink 역시 Python으로 개발되어 있으며, 실제로 내부에 Streamlink가 자체적으로 필수 기능만 담아 컴파일한 Python 버전 3.12의 실행 파일이 포함된 상태로 배포됩니다. 이 실행 파일은 플러그인을 적재할 때 사용되며, 만약 별도로 Python이 설치되지 않은 상태라면 내부에 포함되어 있는 Python 실행 파일이 사용되고, 별도로 Python이 설치되어 있다면 해당 파일을 사용하기 때문에 버전이 다를 경우, Streamlink는 실행되나 플러그인 파일이 제대로 적재되지 않아 오류가 발생하는 문제가 발생할 수 있습니다.
물론 Chzzk Live Downloader는 이러한 문제를 미연에 방지하고자 실행되는 Python 번역기의 버전을 인식하여 적절하게 처리하지만, 이미 Python을 사용하는 다른 프로그램이 실행 중이라면 문제가 발생할 가능성을 배제할 수는 없습니다.
따라서 이런 경우에는 다른 프로그램의 실행을 모두 종료하고 실행해 보시고, 문제가 발생하지 않는다면 Python 실행 환경을 정리할 필요가 있습니다. 이에 대해서는 문의하기 항목을 참고하여 문의해 주시기 바랍니다.
문의하기
치지직 다운로드 도구에 대해 궁금한 사항, 제보할 오류, 개선 요청 사항 등이 있을 때는 GitHub의 Issues 기능을 통해 제보해 주세요. 모든 언어에 대응 가능하나, 직접 대응 가능한 언어는 한국어, 영어, 일본어, 중국어이며, 다른 언어는 기계 번역을 통하기 때문에 100% 대응이 불가능할 수 있습니다.
If you have any questions, bug reports, or improvement requests regarding the Chzzk Downloader Suite, 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%正確に対応できない場合があります。