zaffre
A fast Clojure library for emulating a terminal with OpenGL rendering and Unicode support.
What is zaffre?
Zaffre is a fast Clojure library for emulating a terminal and drawing characters to a screen. It provides high-performance text rendering using OpenGL and supports Unicode characters, multiple fonts, and tileset loading. The library solves the need for efficient, flexible terminal emulation in Clojure applications.
Clojure developers building text-based applications, terminal emulators, or roguelike games who need high-performance character rendering.
Developers choose Zaffre for its exceptional speed through OpenGL rendering, thread-safe design, and support for professional tilesets like those used in Dwarf Fortress, without unnecessary GUI or animation features.
Overview
A fast clojure console library
Use Cases
Best For
- Building roguelike games with custom tilesets
- Creating terminal emulators in Clojure
- Developing text-based user interfaces with Unicode support
- Implementing high-performance console rendering
- Loading and displaying CP437 format tilesets
- Projects requiring thread-safe terminal operations
Not Ideal For
- Projects requiring built-in GUI widgets or controls
- Applications needing animation or visual effects out-of-the-box
- Developers seeking high-level abstractions without OpenGL setup
- Teams preferring libraries with extensive documentation and community support
Pros & Cons
Pros
Uses LWJGL and OpenGL for maximum rendering performance, enabling high-speed character drawing as highlighted in the features section.
Supports Unicode characters excluding CJK code points, allowing for broad international text display in terminal applications.
Enables loading tilesets from sources like the Dwarf Fortress repository, ideal for game developers using custom assets.
Designed for concurrent usage, making it suitable for multi-threaded Clojure applications without race conditions.
Supports multiple fonts, glyph stacking, and non-character tiles (sprites), as per the features, allowing for creative text-based interfaces.
Cons
The library explicitly omits animation features, requiring developers to manually implement dynamic effects, which adds complexity.
Focuses solely on terminal emulation, so projects needing buttons, menus, or other GUI elements must build them from scratch.
Requires LWJGL and OpenGL dependencies, which can be cumbersome for developers unfamiliar with low-level graphics programming.
Prioritizes performance over convenience, missing higher-level abstractions common in other UI libraries, as admitted in the 'Not Features' section.
Frequently Asked Questions
Related Projects
closhBash-like shell based on Clojure
clojure-lanternaA Clojurey wrapper around the Lanterna terminal output library.
triklTerminal UI library for Clojure
malli-cliConfiguration powertool with `metosin/malli`
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.