How henrisallila/hccapet works
HccaPET is a command-line MP4-to-PETSCII-art video converter. The workflow opens and samples source frames, converts each selected frame to a configurable character grid and palette, writes the video, then optionally muxes the original audio with ffmpeg. The graph separates orchestration, conversion, and C64 visual data. The README documents palette modes and audio fallback; implementation details are based on the shown source excerpts.
Main entry points: converter.py Frame converter · hccapet.py Conversion CLI · petscii_data.py PETSCII font
Components 15
Video workflow
- Conversion CLI
hccapet.py - Frame reader
hccapet.py - Frame selection
hccapet.py - Video writer
hccapet.py - Audio mux
hccapet.py
PETSCII conversion
- Frame converter
converter.py - Palette matching
converter.py - Character matching
converter.py - Frame rendering
converter.py
C64 visual data
- PETSCII font
petscii_data.py - C64 palette
petscii_data.py
Other components
- CLI user
- Input video
- ffmpeg
- Output video
Connections 18
- CLI user → Conversion CLI: runs conversion
README.md - Input video → Frame reader: video frames
hccapet.py - Conversion CLI → Frame reader: opens input
hccapet.py - Frame reader → Frame selection: reads frames
hccapet.py - Conversion CLI → Frame selection: sets output rate
hccapet.py - Frame selection → Frame converter: converts selected frames
hccapet.py - Conversion CLI → Frame converter: configures palette
hccapet.py - Frame converter → Palette matching: maps pixel colors
converter.py - Frame converter → Character matching: matches characters
converter.py - Frame converter → Frame rendering: renders cells
converter.py - Frame converter → PETSCII font: loads bitmaps
converter.py - Frame converter → C64 palette: loads colors
converter.py - Frame rendering → Video writer: returns rendered frame
hccapet.py - Conversion CLI → Video writer: writes frames
hccapet.py - Video writer → Audio mux: temporary video
hccapet.py - Input video → Audio mux: source audio
hccapet.py - Audio mux → ffmpeg: runs mux command
hccapet.py - Audio mux → Output video: saves muxed or silent video
hccapet.py