live-rec: 치지직·유튜브 방송 예약 녹화

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 12:23:09 +09:00
commit f0da6f724a
@@ -0,0 +1,122 @@
+# live-rec
+
+치지직·유튜브 방송을 **미리 대기 걸어 두면 켜지는 순간 녹화**하는 Docker 컨테이너.
+yt-dlp + ffmpeg 기반이고, 웹 화면과 CLI를 함께 제공한다.
+
+- 치지직 채널: 30초마다 방송 확인 → 켜지면 녹화
+- 유튜브 채널: 2분마다 확인, 예약 방송은 시작까지 대기
+- 다시보기·클립·일반 영상 주소는 바로 받기
+- **예약**: 정한 시각(기본 한국시간)부터 N시간 동안 방송을 기다린다
+- 녹화가 끊겨도 방송이 계속되면 다시 연결해 이어 녹화 (파일이 나뉨)
+- 웹 화면: 등록·예약·화질 선택, 녹화 용량·속도·경과, 정체 경고, 로그, 중지, 쿠키 입력
+- 여유 공간이 부족하면 지금까지 분량을 저장하고 멈춤
+- yt-dlp는 컨테이너 시작 시와 매일 05시(녹화가 없을 때) 자동 업데이트
+
+> 개인 시청 목적으로만 사용하세요. 저작권과 각 플랫폼 이용약관을 지키는 것은 사용자 책임입니다.
+
+## 설치
+
+Docker Compose가 필요하다 (Synology는 Container Manager).
+
+```bash
+git clone <이 저장소 주소> live-rec
+cd live-rec
+cp .env.example .env      # 저장 위치(REC_DIR), PUID/PGID 등 수정
+mkdir -p data recordings  # REC_DIR을 바꿨다면 그 폴더를 만든다
+docker compose up -d --build
+```
+
+웹 화면: `http://<서버 IP>:8790`
+
+- **PUID/PGID**: 녹화 파일 소유자. 호스트에서 `id`로 확인해 `.env`에 넣는다.
+  이 값은 이미지 빌드에 쓰이므로 바꾸면 `docker compose up -d --build`.
+- **폴더 권한**: `data/`와 저장 폴더는 PUID 사용자가 쓸 수 있어야 한다.
+  Docker가 대신 만들면 root 소유가 되니 미리 만들어 둔다.
+- **Synology**: 공유 폴더의 ACL이 상속되면 컨테이너 안에서 읽기 전용으로 보인다.
+  그럴 때는 해당 폴더만 ACL을 지우고 일반 권한으로 바꾼다.
+  ```bash
+  sudo synoacltool -del /volume1/<공유폴더>/live && sudo chmod 755 /volume1/<공유폴더>/live
+  ```
+
+## 사용법
+
+### 웹 화면
+
+주소를 넣고 **확인**을 누르면 방송 중인지 미리 볼 수 있다. 시작을 **지금부터** 또는 **예약**으로 고르고, 기다릴 시간과 화질을 정해 등록한다.
+
+### CLI
+
+```bash
+R="docker exec live-rec rec"
+$R add https://chzzk.naver.com/<채널ID> -H 6 -m "메모"   # 지금부터 6시간 대기
+$R add https://www.youtube.com/@핸들 -a "21:00" -H 3      # 21시부터 3시간 대기 (지난 시각이면 내일)
+$R add <URL> -a "10-05 20:30" -q 1080                     # 날짜 지정, 1080p 이하
+$R ls                # 목록
+$R st <ID>           # 상세 + 로그
+$R stop <ID>         # 대기 취소 / 녹화 중지 (분량 저장)
+$R rm <ID>           # 끝난 작업 기록 삭제 (녹화 파일은 그대로)
+$R check <URL>       # 등록 없이 방송 여부 확인
+$R update            # yt-dlp 수동 업데이트
+```
+
+ID는 앞부분만 써도 된다. 저장 파일: `<REC_DIR>/<채널명>/<시작시각> <제목> [<id>].mp4`
+
+### 쿠키 (성인 방송·연령 제한 영상)
+
+치지직 성인 방송은 네이버 로그인 쿠키(`NID_AUT`, `NID_SES`)가 있어야 받을 수 있다.
+웹 화면 아래 **쿠키**에 붙여넣거나, 터미널에서 입력한다 (입력 내용은 화면에 보이지 않음).
+
+```bash
+docker exec -it live-rec rec cookies set chzzk     # NID_AUT=...; NID_SES=... 한 줄
+docker exec -it live-rec rec cookies set youtube   # 유튜브는 Netscape cookies.txt 내용
+docker exec live-rec rec cookies                   # 상태 확인 (값은 출력하지 않음)
+```
+
+쿠키는 계정 로그인 정보다. `data/cookies/`는 다른 사람과 공유하지 말 것.
+브라우저에서 로그아웃하면 쿠키도 무효가 되니 다시 넣어야 한다.
+
+## 외부 공개 (선택)
+
+웹 화면을 인터넷에 열 때는 리버스 프록시(Caddy, Nginx 등)로 HTTPS를 붙이고 **OIDC 로그인**을 켠다.
+로그인 설정 전에는 프록시를 거친 요청(`X-Forwarded-For` 있음)을 모두 거부하고, 같은 네트워크에서 포트로 직접 들어온 접속만 허용한다.
+
+1. OIDC 제공자(Gitea, Authentik, Keycloak 등)에 OAuth2 앱을 만든다.
+   - 리디렉션 URI: `https://<공개 주소>/auth/callback`
+   - 기밀(confidential) 클라이언트
+2. `.env`에 `REC_OIDC_ISSUER`, `REC_OIDC_CLIENT_ID`, `REC_PUBLIC_URL`, `REC_ALLOWED_USERS`를 채우고 `docker compose up -d`
+3. 클라이언트 시크릿을 넣는다: `docker exec -it live-rec rec auth secret`
+4. 상태 확인: `docker exec live-rec rec auth`
+
+허용 계정은 OIDC `preferred_username`으로 확인한다. 세션은 30일 유지된다.
+
+Caddy 예시:
+
+```
+rec.example.com {
+	reverse_proxy 127.0.0.1:8790
+}
+```
+
+## 구조
+
+| 파일 | 내용 |
+|---|---|
+| `rec.py` | 데몬(작업마다 스레드, yt-dlp 실행·감시)과 CLI |
+| `web.py` | 웹 서버 (표준 라이브러리), OIDC 로그인 |
+| `index.html` | 웹 화면 |
+
+상태는 `data/` 아래 파일로만 주고받는다.
+
+| 경로 | 내용 |
+|---|---|
+| `jobs/<ID>/job.json` | 요청 |
+| `jobs/<ID>/state.json` | 상태 (데몬만 씀) |
+| `jobs/<ID>/log.txt` | 데몬 이벤트와 yt-dlp 출력 |
+| `cookies/` | 쿠키 |
+| `auth/` | 세션 키, OIDC 시크릿 |
+
+녹화 중 파일은 `<REC_DIR>/.rec-tmp/<ID>/`에 있다가 끝나면 이동한다.
+
+참고:
+- 유튜브용 JS 런타임 deno를 포함한다.
+- 치지직 라이브의 fMP4 조각(`.m4s`) 때문에 ffmpeg에 `-extension_picky 0`을 넘긴다.