README.md

ASCII Art GIF Converter

Convert GIFs to ASCII art with interactive zoom and export options.

What It Does

• Transform animated GIFs into text-based art. Zoom, pan, and export in multiple formats including GIF, ASCII, JSON, and CSV.

How to Use

Enter a GIF URL, click to zoom, scroll to adjust, drag to pan. Export the result in your preferred format.

Development Setup

1. Clone the repository:

git clone https://github.com/yourusername/ascii-gif-converter.git
cd ascii-gif-converter

2. Install dependencies:

npm install

3. Configure environment:

• Copy .env.example to .env
• Update GIPHY_API_KEY in .env with your API key
  • For development, you can use the public beta key: dc6zaTOxFJmzC
  • For production, get your key from Giphy Developers

4. Start development server:

npm run dev

The app will be available at http://localhost:3000

Tech Stack

• Vanilla JavaScript
• p5.js - For canvas rendering
• GSAP - For smooth animations
• gif.js - For GIF processing
• Webpack - For bundling and development

Analytics

View usage statistics at ascii.goatcounter.com