ascii-webcam

Crates.ioascii-webcam
lib.rsascii-webcam
version0.1.1
sourcesrc
created_at2024-09-18 06:58:16.059808
updated_at2024-09-30 02:47:35.118817
descriptionA webcam that visualizes its output as ASCII art directly in the terminal
homepagehttps://github.com/nubilfi/ascii-webcam
repositoryhttps://github.com/nubilfi/ascii-webcam
max_upload_size
id1378842
size64,580
Muh Ibnu Habil Hanafi (nubilfi)

documentation

https://docs.rs/ascii-webcam/latest/ascii-webcam

README

ASCII Webcam

version Build Status Documentation codecov

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

  1. Install OpenCV 4.x. The installation process varies depending on your operating system:

  2. Build the project:

    cargo b -r
    
  3. Run test:

    cargo t
    
  4. 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

MIT

Commit count: 23

cargo fmt