How infinc/ascii-generator works
This repository combines a Python CLI for image/ASCII-art conversion and two chat modes, plus a browser-based converter and Achex chat client. The main workflow is image input → ASCII-art generation or restoration; users can also join an Achex room or use nearby BLE chat. The graph preserves documented GIF playback, file-sharing, HEIC, and BLE capabilities. Some subsystem links rely on README descriptions or the SOURCE INDEX; unsampled internals are not expanded beyond that evidence.
Main entry points: main.js App Controller · commands.js Chat Commands · main.py Python CLI · chat_functions.py Chat Commands
Components 21
Python Art Tools
- Python CLI
main.py - Art Operations
functions.py
Python Chat
- Chat Commands
chat_functions.py - Transport API
chat_transport.py - BLE Chat
ble_chat.py - BLE Link
ble_link.py
Browser App
- App Controller
web/public/js/main.js - Landing UI
web/public/js/landing.js - Chat Commands
web/public/js/commands.js - Chat Protocol
web/public/js/protocol.js - Achex Client
web/public/js/achex.js - Image Pipeline
web/public/js/image.js - HEIC Decoder
web/public/js/heic.js - ASCII Conversion
web/public/js/ascii.js - Chat UI
web/public/js/ui.js - ANSI Renderer
web/public/js/ansi.js
BLE Security
- Room Crypto
ios/BLEChat/BLEChat/Protocol/RoomCrypto.swift
Other components
- CLI User
- Chat User
- Achex Service
- Browser User
Connections 29
- CLI User → Python CLI: starts
README.md - Python CLI → Art Operations: uses
main.py - Python CLI → Chat Commands: starts chat
main.py - Python CLI → BLE Chat: starts BLE
main.py - Python CLI → Art Operations: requests conversion
README.md - Chat User → Chat Commands: sends commands
README.md - Chat Commands → Transport API: uses transport
chat_functions.py - Transport API → Achex Service: connects by WebSocket
README.md - Chat Commands → Art Operations: generates or restores
chat_functions.py - BLE Chat → Chat Commands: reuses commands
ble_chat.py - BLE Chat → Transport API: implements transport
ble_chat.py - BLE Chat → BLE Link: uses BLE link
ble_chat.py - Browser User → App Controller: uses app
README.md - App Controller → Landing UI: starts landing
web/public/js/main.js - App Controller → Chat Commands: dispatches commands
web/public/js/main.js - App Controller → Chat Protocol: routes incoming data
web/public/js/main.js - App Controller → Achex Client: connects and authenticates
web/public/js/main.js - App Controller → Chat UI: updates interface
web/public/js/main.js - App Controller → Image Pipeline: checks image files
web/public/js/main.js - Chat Commands → Chat Protocol: sends payloads
web/public/js/commands.js - Chat Commands → Image Pipeline: converts images
web/public/js/commands.js - Chat Commands → ASCII Conversion: restores PNG
web/public/js/commands.js - Chat Commands → HEIC Decoder: checks HEIC
web/public/js/commands.js - Chat Commands → Chat UI: renders command results
web/public/js/commands.js - Chat Protocol → Chat UI: renders incoming messages
web/public/js/protocol.js - Image Pipeline → ASCII Conversion: generates art
web/public/js/image.js - Image Pipeline → HEIC Decoder: decodes HEIC
web/public/js/image.js - Chat UI → ANSI Renderer: renders ANSI
web/public/js/ui.js - Achex Client → Achex Service: connects by WebSocket
README.md