This project was built using an STM32-F303ZE with a simple ssd1306 OLED display. It draws 21x10 with (almost perfectly) stable 8 frames per second and was designed and built to play Bad Apple, but anything else would also work. Frame timings and length of the video can be adjusted, too high frames per second can lead to slowed down playback due to the render time being larger than the desired one. Faster render times are being adjusted for.

How to use

Convert a video to an ASCII file, using video-to-ascii.py
Adjust frame timing in the main program (draw time per picture, width, height, total frames)
Flash and enjoy!

Input format

The screen renders video through ASCII characters. It takes in a long text file, containing all the images in a contiguous stream, which is then read in IMAGE_LEN-sized (height * width + newline chars) chunks in the main program. If these parameters don't match up, the end result won't either.

Dependencies

The video-to-ascii.py conversion script uses image-to-ascii for the conversion in the background. It is assumed to be located on the same height as this project and that it is build in release-mode (due to performance).

TODO

Fix timing in draw
Rewrite ascii conversion in Rust or Haskell (with an own implementation of ascii-to-text)