# TrickWork

TrickWork is a self-hosted media applications app. TrickWork turns your images into proportional-font-aware ASCII art - a rebuild of the abandoned ASCII Gen 2, with a live interactive preview and TXT/XHTML/RTF/PNG export. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2371/trickwork

## Description

TrickWork turns your images into proportional-font-aware ASCII art - a rebuild of the abandoned ASCII Gen 2, with a live interactive preview and TXT/XHTML/RTF/PNG export. Characters are picked by how much visual "ink" they actually cover at your chosen font, not just by brightness, so proportional (non-monospace) fonts render correctly instead of looking stretched or squashed. Nine of ASCII Gen 2's own original character ramps are built in, weighting mechanic included: repeat a character in the ramp and it claims proportionally more of the brightness range, exactly like the original. Fully stateless - no database, no accounts, nothing to configure beyond the port.

## Platform availability

Available on 3 of 10 platforms: Unraid, Mac, Windows.

## Desktop and other devices

Mac, Windows.

## Health score

60/100 (Good), based on 4 of 4 factors.
- Maintained: 100 (last commit 9 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 55 (3 install platforms, install notes, Docker image)
- Light to run: 40 (4 GB minimum RAM, runs on ARM)

## Links

- Official website: https://junkerderprovinz.github.io/trickwork/
- Docker Hub: https://hub.docker.com/r/junkerderprovinz/trickwork
- GitHub: https://github.com/junkerderprovinz/trickwork
- desktop: https://github.com/junkerderprovinz/trickwork/releases/latest
- Unraid: https://ca.unraid.net/apps/trickwork-0h072450hg59wx?q=TrickWork
- Documentation: https://junkerderprovinz.github.io/trickwork/installing/

## Common questions

### Do I need a database or user accounts to run TrickWork?

No; it is fully stateless, has no database or accounts, and requires nothing to configure beyond the port.

### Which export formats are available for the ASCII art?

TrickWork can export TXT, XHTML, RTF, and PNG.

### Does TrickWork work correctly with proportional, non-monospace fonts?

Yes; it selects characters based on how much visual ink they cover at the chosen font, not just brightness, so proportional fonts render without looking stretched or squashed.

### Does TrickWork include ASCII Gen 2 character ramps?

Yes, nine original ASCII Gen 2 character ramps are built in, including the weighting mechanic where repeating a character claims a larger share of the brightness range.

---
Source: Our Local Host (https://ourlocalhost.com/app/2371/trickwork), the self-hosted and open-source app directory.
