ASCII Webcam is an application that captures video from your webcam and displays it as ASCII art in real-time within your terminal. This project demonstrates the use of OpenCV for video capture, image processing techniques, and terminal-based UI rendering using the Ratatui library.
- Real-time webcam capture and ASCII conversion
- Terminal-based user interface with Ratatui
- FPS counter
- Resizable ASCII output adapting to terminal dimensions
- Help menu
- OpenCV 4.x
- A compatible webcam
-
Install OpenCV 4.x. The installation process varies depending on your operating system:
- On Archlinux:
sudo pacman -Sy opencv - For other systems, please refer to the OpenCV installation guide.
- On Archlinux:
-
Build the project:
cargo b -r -
Run test:
cargo t -
Run benchmark:
cargo bench
Run the application with:
cargo r
Once the application starts:
- The main window displays the ASCII representation of your webcam feed.
- The top bar shows the current FPS.
- Press
?to toggle the help menu. - Press
qto quit the application.