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

---

Generated by Discord ASCII Image Generator