GitHub - Aresga/Camtty: Camtty is a fun command-line tool that captures video from your webcam, converts each frame into ASCII characters, and displays the result in real-time in your terminal.

Camtty 📸 -> 💻 -> 🎨

Turn your webcam feed into live ASCII art directly in your terminal!

Camtty is a fun command-line tool that captures video from your webcam, converts each frame into ASCII characters, and displays the result in real-time in your terminal.

✨ Features

Live Webcam Feed: See the world around you rendered in ASCII.
Real-time Conversion: Fast conversion process for a smooth experience.
Terminal-Based: Runs entirely within your terminal using libraries like blessed.
Customizable (Future): (Add potential future features like character set selection, resolution adjustment, etc.)

🚀 Installation

Prerequisites:
- Python 3.7+
- pip (Python package installer)
- A connected webcam recognized by your system.

Install using pip: (Assuming your package is or will be published on PyPI)

Alternatively, for local development:

# Clone the repository (if you haven't already)
# git clone https://github.com/Aresga/Camtty.git
# cd camtty
pip install .

🎮 Usage

Simply run the following command in your terminal:

Press Ctrl+C to stop the stream.

🔧 How it Works

Camtty uses:

OpenCV (opencv-python): To capture video frames from the webcam.
NumPy: For efficient numerical operations on image data.
Blessed: To control the terminal and display the ASCII art smoothly.

The core logic involves:

Capturing a frame from the webcam.
Resizing the frame (optional, for performance/fit).
Converting the frame to grayscale.
Mapping pixel intensity values to ASCII characters.
Printing the resulting ASCII string to the terminal using blessed for positioning.

🤝 Contributing

Contributions are welcome! Please feel free to open an issue or submit a pull request.

📄 License

see the LICENSE file for details.