A Discord bot that converts images into full‑color ASCII (or Braille) art. Supports both ANSI text output and high‑resolution PNG images.
-
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:textorpngquality:standard(embed) ormax(full resolution, no embed)braille: use Braille characters for denser outputdither: apply dithering (Braille only)color: ANSI color outputwidth: maximum width in characters (default: 80)
### 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:maxWhen 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.
See Dockerfile.prod and .github/workflows/ci-cd.yml for production build & deployment instructions. Make sure to populate your GitHub repository secrets:
DISCORD_BOT_TOKENAZURE_CREDENTIALS- (optional) other API keys
Generated by Discord ASCII Image Generator