2 releases
0.1.1 | Sep 30, 2024 |
---|---|
0.1.0 | Sep 18, 2024 |
#191 in Video
57 downloads per month
25KB
330 lines
ASCII Webcam
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.
Features
- Real-time webcam capture and ASCII conversion
- Terminal-based user interface with Ratatui
- FPS counter
- Resizable ASCII output adapting to terminal dimensions
- Help menu
Requirements
- OpenCV 4.x
- A compatible webcam
Installation
-
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
Usage
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
q
to quit the application.
License
Dependencies
~12–41MB
~626K SLoC