Sales & Dungeons (snd) is a utility for tabletop role-playing games, enabling users to create and print custom handouts, reference sheets, and character notes using thermal printers. It targets Dungeon Masters and players seeking portable, on-the-fly game aids, offering extensive customization and integration capabilities.

How It Works

The application leverages Nunjucks templating with HTML and CSS to define print layouts, allowing for rich formatting and integration of CSS frameworks. Rendered HTML is converted to an image via Chrome's Debug Protocol, which is then translated into ESC/POS commands for thermal printer output. This approach maximizes compatibility with modern web standards for template design while ensuring broad thermal printer support.

Quick Start & Requirements

• Installation: Download pre-compiled binaries from the releases page or use Docker (ghcr.io/bigjk/snd:master).
• Prerequisites: Thermal printer supporting ESC/POS command set. For Docker, USB device access (/dev/bus/usb) and appropriate group permissions are required.
• Setup: Minimal for binaries; Docker setup requires understanding device mapping and group IDs.
• Documentation: Wiki

Highlighted Details

• Cross-platform support: Windows, macOS (Intel/M1), Linux (x64/ARM64), Raspberry Pi.
• Extensive data source integration: Open5e, CSV, FoundryVTT, Fight Club 5e, 5eTools.
• AI LLM support for generating and translating content via OpenAI, OpenRouter, or local endpoints.
• Cloud sync for templates, generators, and data sources.

Maintenance & Community

• Active development with community contributions.
• Discord server available for support and discussion.
• JetBrains Open Source Support Program sponsorship.

Licensing & Compatibility

• License: MIT.
• Compatibility: Permissive, suitable for commercial use and integration with closed-source projects.

Limitations & Caveats

macOS bundles are not signed, requiring manual user intervention to bypass security warnings. The HTML-to-image conversion relies on Chrome, which may be resource-intensive for a simple task.