KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

Chzzk-Rekoda

★ 49 Open GitHub ↗

치지직 방송을 자동 녹화하는 도구

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 치지직 레코다 (Chzzk-Rekoda)

**언어:** [한국어](README.md) | [English](README.en.md) | [简体中文](README.zh-CN.md) | [繁體中文](README.zh-TW.md) | [日本語](README.ja.md)

Streamlink와 ffmpeg를 활용하여 만들어진 Windows, macOS, Linux를 지원하는 치지직 자동 녹화 프로그램입니다.

또한 컴퓨터를 잘 모르는 분들도 쉽게 사용할 수 있는 **치지직 자동 녹화 프로그램**입니다.  
방송이 켜지면 자동으로 녹화를 시작하고, 방송이 꺼지면 알아서 저장해줍니다.

[[튜토리얼] 안드로이드 휴대폰에 프로그램 설치하기](https://github.com/munsy0227/Chzzk-Rekoda/discussions/17)

[[TUTORIAL] How to Install Chzzk-Rekoda in Android Systems](https://github.com/munsy0227/Chzzk-Rekoda/discussions/18)

---

## 1. 설치하기 (다운로드)

사용하고 계신 운영체제(윈도우, 맥, 리눅스)에 맞는 설명을 읽고 따라해주세요.
설치 중 언어 선택 화면이 나오면 원하는 언어를 먼저 선택하세요.

### 🪟 윈도우 (Windows) 사용자

**1단계: 프로그램 다운로드**
1. 이 페이지 위쪽에 있는 초록색 **[Code]** 버튼을 누르세요.
2. 메뉴에서 **[Download ZIP]** 을 눌러 압축 파일을 다운받으세요.
3. 다운로드한 파일의 압축을 풀어주세요. (찾기 쉬운 '바탕화면' 등을 추천합니다.)

(Git을 사용하실 수 있다면 Git을 사용하세요.)

**2단계: 설치 프로그램 실행**
1. 압축을 푼 폴더 안으로 들어갑니다.
2. `install.bat` 파일을 찾아 더블 클릭해서 실행하세요.
3. 검은 창이 뜨고 필요한 파일들을 자동으로 설치합니다. 시간이 조금 걸릴 수 있으니 기다려주세요.
4. 설치가 완료되면 자동으로 설정 화면이 나옵니다.

---

### 🍎 맥(macOS) / 🐧 리눅스(Linux) 사용자

**1단계: 터미널 열기**
- **Mac:** `Command` + `Space` 키를 누르고 "터미널"이라고 검색해서 실행하세요.
- **Linux:** 사용하시는 터미널 앱을 실행하세요.

**2단계: 명령어 입력하기**
아래 명령어들을 한 줄씩 복사해서 터미널에 붙여넣고 엔터(Enter)를 누르세요.

1. **프로그램 다운로드**
   ```bash
   git clone https://github.com/munsy0227/Chzzk-Rekoda.git
   cd Chzzk-Rekoda
   ```

2. **FFmpeg 설치 (녹화에 꼭 필요해요)**
   - **Mac 사용자 (Homebrew 필요):**
     ```bash
     brew install ffmpeg
     ```
   - **Ubuntu/Debian 사용자:**
     ```bash
     sudo apt install ffmpeg -y
     ```
   - **Arch Linux 사용자:**
     ```bash
     sudo pacman -S ffmpeg uv
     ```

3. **설치 스크립트 실행**
   ```bash
   ./install
   ```

---

## 2. 설정하기 (채널 추가)

녹화하고 싶은 스트리머를 등록해야 녹화가 됩니다.  
설치 직후 설정 화면이 꺼졌다면 `settings.bat`(윈도우) 또는 `./settings`(맥/리눅스)를 실행하세요.

1. 메뉴가 나오면 키보드 숫자를 눌러 선택합니다.
   - **`1` 입력 후 엔터**: 채널 설정 (Channel Settings)
   - **`1` 입력 후 엔터**: 채널 추가 (Add Channel)

2. **채널 추가 방식**을 선택하세요.
   - **채널 이름으로 검색**: 검색어를 입력하고 이름과 ID가 함께 표시된 결과에서 추가할 채널을 선택합니다.
   - **채널 ID로 직접 추가**: 치지직 채널 URL 끝의 ID를 입력하면 공식 채널 이름을 자동으로 조회합니다.

3. 검색되거나 조회된 **채널 이름과 ID를 확인**하세요.
   - 이미 등록된 ID는 검색 결과에 표시되며 중복 추가되지 않습니다.
   - 같은 이름의 다른 ID가 등록되어 있으면 기존 ID를 보여 주므로 동명이인 채널을 구분할 수 있습니다.

4. **저장 경로**를 입력하세요.
   - 아무것도 입력하지 않고 엔터를 치면 프로젝트 안에 공식 채널 이름의 폴더가 생성되고 그곳에 저장됩니다.
   - 필요한 경우 다른 폴더 이름이나 경로를 직접 입력할 수 있습니다.

5. 표시된 채널 이름, ID, 저장 경로가 맞다면 `Y`를 입력하세요.

> **팁:** 성인 인증이나 멤버십 인증이 필요한 방송을 녹화하려면 설정 메뉴의 **5번 (네이버 쿠키 설정)** 에서 Chrome, Microsoft Edge 또는 Firefox로 NAVER에 직접 로그인해 쿠키(NID_AUT, NID_SES)를 가져오거나 쿠키값을 수동으로 입력하세요. 브라우저 로그인 방식은 새 브라우저 창을 사용하며, 첫 실행 시 호환 드라이버 준비를 위해 인터넷 연결이 필요할 수 있습니다.
> 저장 확장자는 설정 메뉴의 **2번 (Recording Settings)** 에서 `ts`, `mkv`, `webm` 중 선택할 수 있고, 같은 메뉴에서 녹화 파일을 몇 시간 또는 몇 분마다 분할할지도 설정할 수 있습니다. AV1 인코딩은 **4번 (AV1 Settings)** 에서 켤 수 있습니다. DNS 문제가 있을 때는 **6번 (DNS-over-HTTPS Settings)** 에서 DoH 주소를 설정하고 켤 수 있습니다. 언어는 **8번 (Language Settings)** 에서 한국어, 영어, 중국어 간체/정체, 일본어 중 선택할 수 있습니다.

---

## 3. 녹화 시작하기

이제 프로그램을 켜두기만 하면 됩니다.

### 🪟 윈도우
폴더에 있는 `chzzk_record.bat` 파일을 더블 클릭하세요.

### 🍎 맥 / 🐧 리눅스
터미널에서 다음 명령어를 입력하세요.
```bash
./chzzk_record
```

검은 창이 떠 있고 글자들이 나온다면 정상적으로 작동 중인 것입니다.  
**이 창을 끄면 녹화가 멈추니 켜두세요!** (최소화 해두셔도 됩니다.)

---

## ❓ 자주 묻는 질문 (FAQ)

**Q. 녹화된 파일은 어디에 있나요?**
A. 저장 경로를 따로 지정하지 않았다면, 프로젝트 안의 공식 채널 이름 폴더에 저장됩니다.

**Q. 프로그램을 끄려면 어떻게 하나요?**
A. 실행 중인 검은 창(터미널)을 닫거나, 창을 클릭한 상태에서 키보드의 `Ctrl` + `C`를 누르면 종료됩니다.

**Q. 오류가 발생해요!**
A. [이곳(Issues)](https://github.com/munsy0227/Chzzk-Rekoda/issues)에 들어가서 증상을 알려주시면 도와드릴 수 있습니다.

---

## ⚖️ 면책사항 (Disclaimer) 및 주의사항

- 본 프로그램은 **MIT 라이선스** 하에 배포되는 오픈소스 소프트웨어입니다.
- 소프트웨어는 **"있는 그대로(AS IS)"** 제공되며, 프로그램 사용으로 인해 발생하는 모든 결과에 대한 법적 책임은 전적으로 **사용자 본인**에게 있습니다.
- **녹화한 영상은 사적인 용도 및 스트리머가 지정한 범위 외로는 무단으로 사용할 수 없으며, 영상 사용에 대한 모든 책임은 녹화한 사용자에 있습니다.**
- **동영상 전체를 업로드하는 행위(공개 또는 비공개 여부와 무관)는 저작권법 위반**으로, 저작권자가 소송을 제기할 수 있습니다.
- 딥페이크 방지를 위해, **AI 학습 자료로 사용하는 행위 역시 금지될 수 있습니다.**

### 📌 저작권 관련 예시 (라디유)
- 저작권은 라디유의 의사로 샌드박스 네트워크에 위임되었습니다.
- AI 학습 자료로 사용하는 행위 역시 저작권 침해입니다.
- 클립은 공식 팬 커뮤니티를 제외하고는 다른 곳에 올릴 수 없습니다. (공개 또는 비공개에 국한되지 않음)
- 가이드라인을 준수했다 해도 라디유 또는 샌드박스 네트워크 측의 판단으로 삭제될 수 있습니다.

### 🚫 비공식 프로젝트 안내
본 프로젝트와 기여자는 **네이버(NAVER)**, **치지직(CHZZK)** 또는 그 계열사 및 자회사와 어떠한 제휴, 권한 부여, 승인 또는 공식적인 연결 관계도 없음을 밝힙니다. 본 프로젝트는 편의를 제공할 목적으로 개발된 독립적이고 비영리적인 비공식 프로그램입니다.

### ™️ 상표권 안내
"치지직(CHZZK)", "네이버(NAVER)"라는 명칭을 포함하여 관련 명칭, 마크, 엠블럼 및 이미지는 해당 소유자의 등록 상표입니다. 이러한 상표의 사용은 식별 및 참조 목적으로만 사용되며, 상표권자와의 어떠한 연관성도 시사하지 않습니다. 본 프로젝트는 해당 상표권을 침해하거나 상표권자에게 피해를 줄 의도가 없음을 명시합니다.

### 📜 저작권 및 약관 준수
본 프로젝트는 스트리밍 영상, 오디오 또는 기타 제3자 콘텐츠의 소유권을 주장하지 않으며, 해당 콘텐츠에 대한 라이선스를 부여하지도 않습니다. 사용자는 관련 저작권법, 플랫폼 정책(치지직 이용약관 등), 현지 법령을 직접 확인하고 준수할 책임이 있으며, 본 프로젝트를 이용한 저장, 복제, 배포, 송신 또는 상업적 이용에 대한 책임은 전적으로 사용자에게 있습니다.

Chzzk-Rekoda

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README