uing
Version, currently 0.6.027 versions
- 0.7.1latestNov 4, 2026
- 0.7.0Nov 2, 2026
- 0.6.0Oct 18, 2026
- 0.5.1Sep 27, 2026
- 0.5.0not indexedSep 28, 2026
- 0.4.2Sep 8, 2026
- 0.4.1not indexedSep 8, 2026
- 0.4.0not indexedSep 8, 2026
- 0.3.0not indexedSep 8, 2026
- 0.2.4not indexedSep 8, 2026
- 0.2.3Aug 30, 2026
- 0.2.2Aug 30, 2026
- 0.2.0Aug 23, 2026
- 0.1.3Aug 13, 2026
- 0.1.2Jul 4, 2026
- 0.1.1not indexedAug 6, 2026
- 0.1.0not indexedAug 6, 2026
- 0.0.9not indexedAug 6, 2026
- 0.0.8not indexedAug 6, 2026
- 0.0.7not indexedAug 6, 2026
- 0.0.6not indexedAug 6, 2026
- 0.0.5not indexedAug 6, 2026
- 0.0.4not indexedAug 6, 2026
- 0.0.3not indexedAug 6, 2026
- 0.0.2not indexedAug 6, 2026
- 0.0.1not indexedAug 6, 2026
- 0.0.0not indexedAug 6, 2026
github.com/kojix2/uing
Crystal binding for libui
Installation
# Add this to your shard.yml
dependencies:
uing:
github: kojix2/uing
version: ~> 0.6.0Then run:
shards installshard.yml
- Crystal
- no constraint declared
- License
- MIT
- Author
- kojix2
Dependencies
Development Dependencies
- crimage*github: naqvis/crimage, branch: maindev
README
This README is the one indexed from the repository at its latest ref, not from the tag for this version.
UIng
UIng is a Crystal binding for kojix2/libui-ng. You can use the Crystal language to create cross-platform native desktop apps.
Documentation: Guide · English · 日本語 · API Reference
libui-ng uses the native APIs of each platform: Win32 API, Direct2D, and DirectWrite on Windows; Cocoa (AppKit) on macOS; and GTK+ 3.10+ and Pango on Linux/Unix. You get windows, buttons, text boxes, menus, dialogs, drawing areas, and other standard widgets.
📸 Live Documentation: Gallery screenshots are automatically generated by GitHub Actions on Linux, Windows, and macOS.
Supported Platforms
- macOS: x86_64 (64-bit), ARM64 (Apple Silicon)
- Linux: x86_64 (64-bit), ARM64
- Windows: x86_64 (64-bit, MSVC and MSYS2 UCRT64)
MinGW64 is no longer supported; use the MSYS2 UCRT64 environment for GNU-style builds.
Installation
Add the dependency to your shard.yml:
dependencies:
uing:
github: kojix2/uing
Run shards install. The post-install script downloads the required libui-ng binary for the current platform. See the installation guide for platform-specific setup.
Quick Start
Create hello.cr:
require "uing"
UIng.init
window = UIng::Window.new("Hello World", 300, 200)
window.on_closing do
UIng.quit
true
end
button = UIng::Button.new("Click me")
button.on_clicked do
window.msg_box("Info", "Button clicked!")
end
window.child = button
window.show
UIng.main
UIng.uninit
Run it with:
crystal run hello.cr
To run the full control gallery from a checkout:
git clone https://github.com/kojix2/uing
cd uing
shards install
crystal run examples/crimage/control_gallery.cr
Continue with the First Steps guide. The optional block-based DSL is covered in Coding Styles.
Examples Gallery
This gallery shows screenshots of example on three platforms (Ubuntu, Windows, macOS).
Images are automatically generated and stored in the screenshots branch.
Window
Note: Toolbar is a feature specific to kojix2/libui-ng. It is experimental and may change.
If you're looking for icons under the MIT license, try Icon Viewer.
Control
Container Control
Table
Area
Menu
Dialog
Drag and Drop
Image
Image Buffer
Contributing
See testing for test commands and placement rules.
See the development and contribution guide. Bug reports, pull requests, and articles about UIng are welcome.
License
MIT License
Documentation
Built from the current release. The first visit to a release nobody has asked for starts its build.
Links
This release
- Version
0.6.0- Tagged
- Oct 18, 2026
- Commit
0e6c0aa1a45e- Indexed
- yes
Dependents
and 1 more
Repository
github.com/kojix2/uing
Metadata
- Created
- Aug 12, 2026
- Updated
- Nov 14, 2026
- Synced
- Nov 14, 2026
- Versions
- 27