MansionNET ASCII Art Generator

A privacy-first, browser-based ASCII art generator. Convert images to ASCII art or generate text banners in various FIGlet-style fonts.

Live: ascii.inthemansion.com

Features

Image → ASCII

• Drag & drop or file picker for image upload
• Live preview with real-time regeneration
• Adjustable output width (40–200 characters)
• 5 character sets: Standard, Detailed, Blocks, Binary, Minimal
• Brightness inversion toggle
• Contrast adjustment
• Color mode (preserves original image colors as ANSI)
• Randomize button for quick experimentation

Text → Banner

• Real-time ASCII banner generation as you type
• 7 distinct FIGlet-style fonts: Standard, Banner (block), Shadow, Slant, Big, Small, Small Slant, Mini
• Auto-regenerates on font change

Export

• Copy to clipboard (plain text)
• Download as .txt
• Download as .png (rendered on dark terminal background)
• Download as .jpg
• Download as .svg (vector, scales infinitely)

Privacy

All processing happens entirely in your browser. No images or text are uploaded to any server. Zero tracking, zero data collection.

Deployment

This is a static site — just HTML, CSS, and JavaScript. No build step, no dependencies, no backend.

Quick start

# Clone the repo
git clone https://github.com/MansionNET/ascii-art-generator.git

# Serve with any static file server
cd ascii-art-generator
python3 -m http.server 8080

Then open http://localhost:8080 in your browser.

Production (with Caddy)

ascii.inthemansion.com {
    root * /var/www/ascii.inthemansion.com
    file_server
}

Font

The UI uses VT323 for the terminal aesthetic. The font path in css/styles.css defaults to /fonts/vt323/VT323-Regular.ttf. Adjust this path to match your setup, or swap in the Google Fonts CDN:

@font-face {
    font-family: "VT323";
    src: url("https://fonts.gstatic.com/s/vt323/v17/pxiKyp0ihIEF2isRFJXGdg.ttf") format("truetype");
}

ASCII art output uses Courier New / Liberation Mono for precise character alignment.

Structure

ascii-art-generator/
├── index.html      # Main application (HTML + JS)
├── css/
│   └── styles.css  # MansionNET terminal theme
└── README.md

License

MIT — use it, fork it, host your own.

Credits

Part of the MansionNET ecosystem — self-hosted services for private, resilient communities.

Built with care in Serbia.