An open API service indexing awesome lists of open source software.

https://github.com/pshycodr/phosphor-cam

Real-time ASCII art camera that transforms your webcam feed into glowing terminal aesthetics. Built with React + Canvas API.
https://github.com/pshycodr/phosphor-cam

Last synced: 5 months ago
JSON representation

Real-time ASCII art camera that transforms your webcam feed into glowing terminal aesthetics. Built with React + Canvas API.

Awesome Lists containing this project

README

          


Project Logo

# Phosphor Cam


Transform your camera feed into real-time ASCII art

[![GitHub stars](https://img.shields.io/github/stars/pshycodr/phosphor-cam?style=social)](https://github.com/pshycodr/phosphor-cam/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/pshycodr/phosphor-cam?style=social)](https://github.com/pshycodr/phosphor-cam/network/members)
[![GitHub watchers](https://img.shields.io/github/watchers/pshycodr/phosphor-cam?style=social)](https://github.com/pshycodr/phosphor-cam/watchers)

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![React](https://img.shields.io/badge/React-20232A?logo=react&logoColor=61DAFB)](https://reactjs.org/)
[![Vite](https://img.shields.io/badge/Vite-646CFF?logo=vite&logoColor=white)](https://vitejs.dev/)

[![GitHub issues](https://img.shields.io/github/issues/pshycodr/phosphor-cam)](https://github.com/pshycodr/phosphor-cam/issues)
[![GitHub pull requests](https://img.shields.io/github/issues-pr/pshycodr/phosphor-cam)](https://github.com/pshycodr/phosphor-cam/pulls)
[![Last commit](https://img.shields.io/github/last-commit/pshycodr/phosphor-cam)](https://github.com/pshycodr/phosphor-cam/commits/main)

---

## โœจ Features

- **Real-Time Rendering** โ€“ Live ASCII conversion with performance optimization (60+ FPS)
- **High-Quality Capture** โ€“ Export 4K resolution ASCII art images
- **Customizable Settings**
- 5 character sets (standard, simple, blocks, matrix, edges)
- Adjustable font size/resolution (6-30px)
- Contrast and brightness controls
- Color mode and invert options
- **Camera Controls**
- Front/back camera switching
- High-quality snapshot export
- ASCII text copy to clipboard
- Video recording capability
- **Performance Monitoring** โ€“ Real-time FPS and render time display

## ๐Ÿ“ธ Demo


ASCII Camera Demo 1
ASCII Camera Demo 2

## ๐Ÿš€ Quick Start

```bash
# Clone the repository
git clone https://github.com/pshycodr/phosphor-cam.git
cd phosphor-cam

# Install dependencies
npm install

# Start development server
npm run dev
```

Visit `http://localhost:5173` to see the app in action!

## ๐Ÿ“– Usage

1. **Grant Camera Access** โ€“ Allow browser to access your camera when prompted
2. **Adjust Settings** โ€“ Click the settings icon (โš™๏ธ) to customize the ASCII effect
3. **Capture Images** โ€“ Press the shutter button for high-quality exports
4. **Switch Cameras** โ€“ Use the flip button (๐Ÿ”„) to toggle between front/back cameras
5. **Record Video** (COMMING SOON) โ€“ Click the record button (๐Ÿ“น) to start/stop video capture

## ๐Ÿ› ๏ธ Tech Stack

- **React 18** โ€“ UI framework
- **TypeScript** โ€“ Type safety
- **Vite** โ€“ Build tool
- **Canvas API** โ€“ Real-time rendering
- **MediaStream API** โ€“ Camera access
- **Tailwind CSS** โ€“ Styling
- **Lucide React** โ€“ Icons

## ๐ŸŒ Browser Support

Requires a modern browser with support for:
- `getUserMedia` API
- `Canvas 2D` rendering context
- ES6+ JavaScript features

โœ… Chrome 90+ | โœ… Firefox 88+ | โœ… Safari 14+ | โœ… Edge 90+

## ๐Ÿ“ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## ๐Ÿค Contributing

Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## โญ Show Your Support

If you found this project helpful, please consider giving it a star! It helps others discover the project.

[![Star this repo](https://img.shields.io/github/stars/pshycodr/phosphor-cam?style=social)](https://github.com/pshycodr/phosphor-cam)

## ๐Ÿ“ฌ Contact

Have questions or suggestions? Open an issue or reach out!

---


Made with โค๏ธ using React and Canvas API

[Report Bug](https://github.com/pshycodr/phosphor-cam/issues) ยท [Request Feature](https://github.com/pshycodr/phosphor-cam/issues)