Metadata-Version: 2.4
Name: camtty
Version: 0.1.1
Summary: A CLI tool to display webcam feed as ASCII art in the terminal
Author-email: Abderrahman Gaga <agaga@student.hive.fi>
Keywords: webcam,ascii-art,terminal,cli,video,camera,ascii,tty
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python
Requires-Dist: numpy
Requires-Dist: blessed
Dynamic: license-file

# 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.

![Camtty in Action 1](screenshots/Screenshot%202025-05-01%20at%2021.10.30.png)

## ✨ 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.)

![Camtty Feature Example](screenshots/Screenshot%202025-05-01%20at%2021.13.52.png)

## 🚀 Installation

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

2.  **Install using pip:**
    *(Assuming your package is or will be published on PyPI)*
    ```bash
    pip install camtty
    ```
    *Alternatively, for local development:*
    ```bash
    # 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:

```bash
camtty
```

Press `Ctrl+C` to stop the stream.

![Camtty Usage Example](screenshots/Screenshot%202025-05-01%20at%2021.15.08.png)

## 🔧 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:
1.  Capturing a frame from the webcam.
2.  Resizing the frame (optional, for performance/fit).
3.  Converting the frame to grayscale.
4.  Mapping pixel intensity values to ASCII characters.
5.  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](LICENSE) file for details.


