# ASCII Camera ๐นโจ
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฅ ASCII CAMERA ๐น ใโ
โ Real-time Retro Video Art โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
Transform your webcam feed into retro ASCII art in real-time! ASCII Camera brings back the nostalgic charm of text-based graphics while showcasing your creativity in the terminal.
## Features
๐ฅ **Real-time conversion**: Live webcam feed to ASCII art
๐ **Colorful output**: Support for colored ASCII art with ANSI escape codes
โก **High performance**: Optimized for smooth real-time rendering
๐๏ธ **Customizable**: Multiple ASCII character sets and color schemes
๐ **Adaptive resolution**: Automatically adjusts to your terminal size
๐ง **Easy to use**: Simple command-line interface
## Installation
### From PyPI (recommended)
```bash
pip install ascii-camera
```
### From source
```bash
git clone https://github.com/masashimorita/ascii_camera.git
cd ascii_camera
pip install -e .
```
## Usage
### Basic usage
```bash
ascii-camera
```
### With custom options
```bash
# High detail ASCII characters
ascii-camera --charset detailed
# Colored output
ascii-camera --color
# Custom resolution
ascii-camera --width 80 --height 24
# Different FPS
ascii-camera --fps 15
# Retro green terminal theme
ascii-camera --color --theme matrix
```
### Available options
- `--width, -w`: Terminal width (default: auto-detect)
- `--height, -h`: Terminal height (default: auto-detect)
- `--fps`: Frames per second (default: 12)
- `--charset`: ASCII character set (simple/detailed/block)
- `--color`: Enable colored output
- `--theme`: Color theme (matrix/amber/cyan/rainbow)
- `--camera`: Camera device index (default: 0)
- `--help`: Show help message
## ASCII Character Sets
- **Simple**: ` .:-=+*#%@` (10 levels)
- **Detailed**: ` .,'~!;<>+*xvXGM#8@` (16 levels)
- **Block**: ` โโโโ` (4 levels, bold look)
## Color Themes
- **Matrix**: Classic green-on-black terminal
- **Amber**: Retro amber terminal
- **Cyan**: Cool cyan blue
- **Rainbow**: Dynamic color mapping
## Requirements
- Python 3.8+
- OpenCV (opencv-python)
- NumPy
- Colorama (for Windows color support)
- Webcam/camera device
## How it works
1. **Capture**: Uses OpenCV to grab frames from your webcam
2. **Process**: Converts each frame to grayscale and resizes to terminal dimensions
3. **Map**: Maps pixel brightness values to ASCII characters
4. **Display**: Renders the ASCII frame in your terminal with optional colors
5. **Repeat**: Continues the process for real-time video
## Troubleshooting
### Camera not found
```bash
# Try different camera indices
ascii-camera --camera 1
ascii-camera --camera 2
```
### Performance issues
```bash
# Lower FPS for better performance
ascii-camera --fps 8
# Smaller resolution
ascii-camera --width 60 --height 20
```
### Terminal compatibility
- Works best with modern terminals that support ANSI escape codes
- For Windows: Use Windows Terminal, ConEmu, or enable ANSI support
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
MIT License - see LICENSE file for details.
## Inspiration
Inspired by classic ASCII art and retro terminal aesthetics. Perfect for developers who love the intersection of modern technology and nostalgic computing.
Raw data
{
"_id": null,
"home_page": null,
"name": "ascii-camera",
"maintainer": "Eraxel.Dev",
"docs_url": null,
"requires_python": "<3.12,>=3.11",
"maintainer_email": "contact@eraxel.dev",
"keywords": "ascii, art, webcam, terminal, realtime, video",
"author": "Eraxel.Dev",
"author_email": "contact@eraxel.dev",
"download_url": "https://files.pythonhosted.org/packages/36/28/f573353d108720f6092de0f32b977a278ebd319add56283d82c3fe9f4f3b/ascii_camera-0.1.0.tar.gz",
"platform": null,
"description": "# ASCII Camera \ud83d\udcf9\u2728\n\n```\n\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557\n\u2551 \ud83c\udfa5 ASCII CAMERA \ud83d\udcf9 \u3000\u2551\n\u2551 Real-time Retro Video Art \u2551\n\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255d\n```\n\nTransform your webcam feed into retro ASCII art in real-time! ASCII Camera brings back the nostalgic charm of text-based graphics while showcasing your creativity in the terminal.\n\n\n## Features\n\n\ud83c\udfa5 **Real-time conversion**: Live webcam feed to ASCII art \n\ud83c\udf08 **Colorful output**: Support for colored ASCII art with ANSI escape codes \n\u26a1 **High performance**: Optimized for smooth real-time rendering \n\ud83c\udf9b\ufe0f **Customizable**: Multiple ASCII character sets and color schemes \n\ud83d\udccf **Adaptive resolution**: Automatically adjusts to your terminal size \n\ud83d\udd27 **Easy to use**: Simple command-line interface \n\n## Installation\n\n### From PyPI (recommended)\n```bash\npip install ascii-camera\n```\n\n### From source\n```bash\ngit clone https://github.com/masashimorita/ascii_camera.git\ncd ascii_camera\npip install -e .\n```\n\n## Usage\n\n### Basic usage\n```bash\nascii-camera\n```\n\n### With custom options\n```bash\n# High detail ASCII characters\nascii-camera --charset detailed\n\n# Colored output\nascii-camera --color\n\n# Custom resolution\nascii-camera --width 80 --height 24\n\n# Different FPS\nascii-camera --fps 15\n\n# Retro green terminal theme\nascii-camera --color --theme matrix\n```\n\n### Available options\n- `--width, -w`: Terminal width (default: auto-detect)\n- `--height, -h`: Terminal height (default: auto-detect) \n- `--fps`: Frames per second (default: 12)\n- `--charset`: ASCII character set (simple/detailed/block)\n- `--color`: Enable colored output\n- `--theme`: Color theme (matrix/amber/cyan/rainbow)\n- `--camera`: Camera device index (default: 0)\n- `--help`: Show help message\n\n## ASCII Character Sets\n\n- **Simple**: ` .:-=+*#%@` (10 levels)\n- **Detailed**: ` .,'~!;<>+*xvXGM#8@` (16 levels) \n- **Block**: ` \u2591\u2592\u2593\u2588` (4 levels, bold look)\n\n## Color Themes\n\n- **Matrix**: Classic green-on-black terminal\n- **Amber**: Retro amber terminal\n- **Cyan**: Cool cyan blue\n- **Rainbow**: Dynamic color mapping\n\n## Requirements\n\n- Python 3.8+\n- OpenCV (opencv-python)\n- NumPy\n- Colorama (for Windows color support)\n- Webcam/camera device\n\n## How it works\n\n1. **Capture**: Uses OpenCV to grab frames from your webcam\n2. **Process**: Converts each frame to grayscale and resizes to terminal dimensions\n3. **Map**: Maps pixel brightness values to ASCII characters\n4. **Display**: Renders the ASCII frame in your terminal with optional colors\n5. **Repeat**: Continues the process for real-time video\n\n## Troubleshooting\n\n### Camera not found\n```bash\n# Try different camera indices\nascii-camera --camera 1\nascii-camera --camera 2\n```\n\n### Performance issues\n```bash\n# Lower FPS for better performance\nascii-camera --fps 8\n\n# Smaller resolution\nascii-camera --width 60 --height 20\n```\n\n### Terminal compatibility\n- Works best with modern terminals that support ANSI escape codes\n- For Windows: Use Windows Terminal, ConEmu, or enable ANSI support\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Inspiration\n\nInspired by classic ASCII art and retro terminal aesthetics. Perfect for developers who love the intersection of modern technology and nostalgic computing.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Real-time webcam to ASCII art converter for terminal",
"version": "0.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/masashimorita/ascii_camera/issues",
"Documentation": "https://github.com/masashimorita/ascii_camera",
"Homepage": "https://github.com/masashimorita/ascii_camera",
"Repository": "https://github.com/masashimorita/ascii_camera"
},
"split_keywords": [
"ascii",
" art",
" webcam",
" terminal",
" realtime",
" video"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1597ce49a6c358004382ad4110e97a3d88da8a556d57d6e2aaf8ce7b5d9ac5e2",
"md5": "13608855497401f2e0b160b78ca35afa",
"sha256": "1eb1cda765732a01a67edc9cb7c7f92bd5ae761426390815c1e00d293070fa89"
},
"downloads": -1,
"filename": "ascii_camera-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "13608855497401f2e0b160b78ca35afa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.11",
"size": 10967,
"upload_time": "2025-07-18T06:20:06",
"upload_time_iso_8601": "2025-07-18T06:20:06.971909Z",
"url": "https://files.pythonhosted.org/packages/15/97/ce49a6c358004382ad4110e97a3d88da8a556d57d6e2aaf8ce7b5d9ac5e2/ascii_camera-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "3628f573353d108720f6092de0f32b977a278ebd319add56283d82c3fe9f4f3b",
"md5": "538e90b490e8755d1b881045cb9e9639",
"sha256": "e462f98d403d80f04e812a05e5701117f2cb682459df4c5b9d692d3b8d53686b"
},
"downloads": -1,
"filename": "ascii_camera-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "538e90b490e8755d1b881045cb9e9639",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.11",
"size": 8665,
"upload_time": "2025-07-18T06:20:08",
"upload_time_iso_8601": "2025-07-18T06:20:08.705068Z",
"url": "https://files.pythonhosted.org/packages/36/28/f573353d108720f6092de0f32b977a278ebd319add56283d82c3fe9f4f3b/ascii_camera-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 06:20:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "masashimorita",
"github_project": "ascii_camera",
"github_not_found": true,
"lcname": "ascii-camera"
}
JSON
