A comprehensive web-based ASCII art generation and conversion tool. Transform images into ASCII art, generate artistic patterns, and create 3D ASCII objects - all in your browser!
Visit the live site: ascii-lilac.vercel.app
ASCII Camera
- Real-time webcam feed converted to ASCII art
- Live video stream with customizable settings
- Frame capture functionality
- Mirror mode for selfie-style viewing
ASCII Camera
- Real-time webcam to ASCII conversion
- Adjustable resolution (30-120 characters wide)
- Configurable FPS (5-30 frames per second)
- Detailed/Simple character sets
- Color inversion and mirror options
- Frame capture and clipboard copy
Image to ASCII
- Upload and convert images instantly
- Adjustable width (30-200 characters)
- Detailed/Simple character sets
- Color inversion option
- One-click copy to clipboard
3D Objects
- Render ASCII 3D shapes (cube, sphere, pyramid, torus)
- Interactive size controls
- Instant generation and preview
All features are also available as command-line tools for automation and scripting.
- Clone the repository:
git clone https://github.com/pistolinkr/ASKII.git
cd ASKII- Install dependencies:
pip3 install -r requirements.txt- Run the web server:
python3 app.py- Open your browser and visit:
http://localhost:5001
Generate ASCII Art:
python3 ascii_art.py banner -t "Hello World"
python3 ascii_art.py wave -s 20
python3 ascii_art.py heart -s 15Convert Image to ASCII:
python3 ascii_converter.py image -i photo.jpg -w 100
python3 ascii_converter.py image -i photo.jpg -w 150 -d --invertConvert Video to ASCII:
python3 ascii_converter.py video -i video.mp4 -w 80 --fps 15Webcam ASCII Art:
python3 ascii_converter.py webcam --fps 153D ASCII Objects:
python3 ascii_3d.py cube -s 10
python3 ascii_3d.py sphere -s 15
python3 ascii_3d.py torus -s 12- Backend: Flask (Python 3.9+)
- Frontend: Vanilla JavaScript, CSS3, HTML5
- Image Processing: OpenCV, Pillow, NumPy
- Deployment: Vercel (Serverless)
- Design: Apple-inspired minimal aesthetic
- Flask 3.0.0
- NumPy 2.0.2
- OpenCV-Python 4.12.0.88
- Pillow 11.3.0
ASKII/
├── app.py # Flask web application
├── ascii_art.py # ASCII art generator
├── ascii_converter.py # Image/video converter
├── ascii_3d.py # 3D object renderer
├── ascii_exporter.py # Export utilities
├── templates/
│ └── index.html # Web interface
├── static/
│ ├── style.css # Styles
│ └── script.js # Client-side logic
├── requirements.txt # Python dependencies
├── vercel.json # Vercel deployment config
└── README.md # This file
- Banner: Large text with ASCII styling
- Wave: Flowing wave patterns
- Circle: Perfect ASCII circles
- Spiral: Mesmerizing spiral patterns
- Heart: ASCII heart shapes
- Box Text: Text enclosed in decorative boxes
- Automatic aspect ratio preservation
- Grayscale conversion
- Customizable character density
- Multiple detail levels
- Brightness inversion
- Wireframe 3D objects
- Rotating animations
- Multiple primitive shapes
- Adjustable viewing angles
The web interface features:
- Clean, minimal Apple-inspired design
- Dark ASCII display panels
- Intuitive controls with sliders and radio buttons
- Real-time conversion and preview
- Responsive layout for mobile and desktop
- Fork this repository
- Sign up at vercel.com
- Import your GitHub repository
- Vercel will automatically detect the configuration
- Deploy!
For other platforms, ensure Python 3.9+ is available and run:
pip3 install -r requirements.txt
python3 app.pyThe app will be available at http://localhost:5001
Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Submit pull requests
MIT License - feel free to use and modify as needed.
Created by Pistol™
- Live Site: ascii-lilac.vercel.app
- GitHub: github.com/pistolinkr/ASKII
Made with ASCII ❤️