https://github.com/ryu-ryuk/terminal-ascii-cam
live webcam -> ascii output in terminal
https://github.com/ryu-ryuk/terminal-ascii-cam
ascii ascii-art ascii-graphics opencv python-script webcam-capture
Last synced: 3 months ago
JSON representation
live webcam -> ascii output in terminal
- Host: GitHub
- URL: https://github.com/ryu-ryuk/terminal-ascii-cam
- Owner: ryu-ryuk
- Created: 2025-07-15T09:15:02.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-15T09:23:13.000Z (3 months ago)
- Last Synced: 2025-07-15T21:01:49.695Z (3 months ago)
- Topics: ascii, ascii-art, ascii-graphics, opencv, python-script, webcam-capture
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# terminal-ascii-cam
⎔ real-time ascii webcam stream in your terminal
⋗ uses soft gamma correction with catppuccin-inspired coloring
⎔ preserves face contours without harsh contrast
---
## features
- live webcam -> ascii output in terminal
- face-preserving gamma correction (no `equalizeHist()`)
- catppuccin-inspired color palette (lavender + mauve highlights)
- temporal smoothing to reduce flicker
- terminal-size adaptive
---
## preview
https://github.com/user-attachments/assets/27246650-a1e8-4cd5-897f-cdf91d3adf9a
---
## usage
```bash
uv pip install opencv-python numpy
python3 ascii_cam.py
````
（／．＼） press `ctrl+c` to stop
## notes
* uses `cv2.VideoCapture(0)` (default webcam)
* color rendering via 24-bit ANSI codes (requires truecolor terminal)
* tweak `HIGHLIGHT_THRESHOLD` or `gamma` in code for your lighting
---
## todo (maybe)
* face outline enhancement
* optional no-color mode
---
> made this for fun — not for production