Discord ASCII Image Generator

➕ Invite ASCII‑Art‑Bot

A Discord bot that converts images into full‑color ASCII (or Braille) art. Supports both ANSI text output and high‑resolution PNG images.

Features

Slash command /ascii
Accepts either an uploaded image attachment or a direct image URL
Modes:
- Text (ANSI): outputs colored ASCII art inside a Discord code block
- PNG Image: uploads a generated high‑resolution PNG
Options:
- output: text or png
- quality: standard (embed) or max (full resolution, no embed)
- braille: use Braille characters for denser output
- dither: apply dithering (Braille only)
- color: ANSI color output
- width: maximum width in characters (default: 80)

Usage

### Slash Command: /ascii

Option	Type	Description
`image`	Attachment	Upload an image to convert
`url`	String	Direct link to an image to convert
`output`	String	`text` or `png`
`quality`	String	`standard` (embed) or `max` (full resolution)
`braille`	Boolean	Use Braille characters
`dither`	Boolean	Apply dithering (for Braille)
`color`	Boolean	ANSI color output
`width`	Integer	Max width in characters (default: 80)

Examples

/ascii image:<attachment> output:text braille:true color:true width:100
/ascii url:https://example.com/picture.jpg output:png quality:max

Image Embed Examples

Environment Variables

When running locally, add a .env file with:

# Bot connection settings
DISCORD_BOT_TOKEN=your-bot-token-here
NODE_ENV=development

# Terminal settings
TERM: "xterm-256color"
COLORTERM: "truecolor"
FORCE_COLOR: "1"
DISCORD_DEBUG: "1"

In production, set those via your container or hosting platform's environment settings.

Contributing & Deployment

See Dockerfile.prod and .github/workflows/ci-cd.yml for production build & deployment instructions. Make sure to populate your GitHub repository secrets:

DISCORD_BOT_TOKEN
AZURE_CREDENTIALS
(optional) other API keys