Official landing for GAV
Turn any video into an ASCII-styled MP4 or JSON frames
Terminal-first
Use the CLI to tune width, characters, FPS, and output format. (working on GUI)
Threaded conversion
Multi-threaded frame conversion for faster processing on modern CPUs.
JSON export
Export frames as plain ASCII JSON for creative uses. (got some bugs, do -thread 1 to prevent JSON bugs from happening)
Speed
Depends on your CPU.
Quick install & usage
gav -videopath input.mp4 -output out -width 120 -fps 20
Copy
CLI options
| Option | Default | Meaning |
|---|---|---|
| -videopath | video.mp4 | Path to input video |
| -output | ascii_frames | Folder to save frames |
| -ascii_video | ascii_video.mp4 | Output ASCII video |
| -fps | 20 | Target FPS |
| -width | 120 | ASCII characters per line |
| -chars | @%#*+=-:. | Characters from dark -> light |
| -json | false | Save frames as JSON instead of a video |