How 4z0n4s/callisto works
Project type and purpose
• This is an open‑source, containerized automation tool that records live streams from the Naver 치지직(CHZZK) platform.
• It comprises two cooperating micro‑services: one to detect and record live streams, and another to post‑process the recordings.
File structure
• Dockerfile: builds a Python 3.12.2 environment with Streamlink and FFmpeg
• callisto.py: “recorder” service that polls the CHZZK API, starts/stops Streamlink sessions, produces .ts + .lock files
• callisto_ffmpeg.py: “post‑processor” service that runs FFmpeg every 5 minutes to correct stream duration, outputs final .mp4, cleans up intermediates
• docker-compose.yml: defines two services (callisto, callisto‑ffmpeg) sharing a volume
• default.env: CHANNEL_ID, NID_AUT, NID_SES environment variables
• requirements.txt: Python dependencies (Streamlink)
README for additional insights
• Poll CHZZK API every 1 min for stream start; during recording poll every 10 sec for stop
• callisto‑ffmpeg polls for .lock files every 5 min to trigger FFmpeg correction
• Final .mp4 stored; intermediate .ts/.lock files removed