BrailleFrame displays videos in the terminal using FFmpeg and Braille characters.
Click below to see a demo with colour for each dot on youtube
- Converts videos into terminal-friendly Braille frames
- Adjustable resolution for terminal display
- Lightweight and fast, leveraging ANSI colors
- C++20 compatible compiler
- FFmpeg installed and accessible from your terminal
- A Braille-capable terminal font (e.g., DejaVu Sans Mono, Ubuntu Mono)
- Adequate terminal size or small font size for best results
- A fast terminal emulator is recommended (e.g., Kitty) for smooth playback
make./bframe <FILE> <WIDTH> <HEIGHT> [--nocolor] [--fps=]
./bframe input.mp4 300 300 --fps=24
- Make sure your terminal font supports Braille characters.
- Adjust terminal size or font size for optimal display.
- You will have a much better experience with the --nocolor version because it does not need to use 'persistence of vision' by swapping out the dots shown repeatedly to change their colors
- If your video is playing too fast you need to change the --fps value to match the content you're using
This project builds upon my Braille Conway's Game of Life:
- Blog: asherfalcon.com/blog/posts/4
- GitHub: https://github.com/ashfn/life