asciinema-streaming-backup

Back up asciinema recordings by chunking idle periods into zstd-compressed segments, then archiving them with brotli on an isolated GitHub orphan branch. The workflow detects inactivity, streams data efficiently, and recompresses chunks via GitHub Actions for long-running sessions on macOS and Linux.

Zstd handles real-time streaming compression during recording with fast concatenation of chunks. Brotli provides final-stage recompression for maximum archival density. Together they balance streaming performance with compact long-term storage on GitHub.

Yes. Idle-based chunking automatically segments long-running asciinema sessions into manageable zstd chunks during inactive periods, preventing large monolithic uploads and enabling incremental backups to GitHub without manual intervention.

Fswatch is optional. Core dependencies—asciinema, zstd, brotli, git, and gh—are required. Fswatch enhances file-watching capabilities but isn't mandatory for idle-detection-based chunking and GitHub archival on macOS and Linux.

An orphan branch isolates backup history from your main repository history, keeping archives separate and avoiding clutter. This structure supports independent retention policies and makes recompression workflows via GitHub Actions cleaner and more manageable.

Idle detection monitors asciinema recording activity and automatically segments data into zstd chunks when inactivity is detected. This approach reduces per-chunk size, enables parallel GitHub uploads, and ensures efficient streaming without requiring manual segment boundaries.