v0.2.0

Native libraries

Windows

Linux

macOS

Additional architectures

Windows

macOS

Linux

Debug libraries

For debugging desktop applications, see the Debugging guide.

Mobile (iOS & Android): drop-in libraries

For shipping on mobile, see the mobile deploy guide.

C / C++ headers

Linux packages

apt (Debian / Ubuntu)

# option 1: self-hosted apt repository (amd64 + arm64; unsigned, hence [trusted=yes])
echo 'deb [trusted=yes] https://azul.rs/ui/apt stable main' | sudo tee /etc/apt/sources.list.d/azul.list
sudo apt update
sudo apt install azul

# option 2: install the .deb straight from the GitHub release
curl -LO https://github.com/fschutt/azul/releases/download/0.2.0/azul_0.2.0_amd64.deb
sudo apt install ./azul_0.2.0_amd64.deb

Homebrew (macOS)

# self-hosted tap: a bare git repo served from azul.rs (installs libazul.dylib + azul.h)
brew tap fschutt/azul https://azul.rs/ui/homebrew-azul.git
brew install fschutt/azul/azul

Demos

• Linux
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzulVault
  • AzGamepad
  • AzCamera
  • AzScreenShare
  • AzVideo
  • AzMeet
  • AzSelfTest
• macOS
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzulVault
  • AzGamepad
  • AzCamera
  • AzScreenShare
  • AzVideo
  • AzMeet
  • AzSelfTest
• Windows
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzulVault
  • AzGamepad
  • AzCamera
  • AzScreenShare
  • AzVideo
  • AzMeet
  • AzSelfTest
• iOS device (.ipa, signed)
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzulVault
  • AzGamepad
  • AzCamera
  • AzScreenShare
  • AzVideo
  • AzMeet
  • AzSelfTest
• iOS device (.app, sign-it-yourself)
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzulVault
  • AzGamepad
  • AzCamera
  • AzScreenShare
  • AzVideo
  • AzMeet
  • AzSelfTest
• iOS Simulator (.app, unsigned)
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzulVault
  • AzGamepad
  • AzCamera
  • AzScreenShare
  • AzVideo
  • AzMeet
  • AzSelfTest
• Android (.apk, sideload)
  • AzulPaint
  • AzWidgets
  • AzulMaps
  • AzSelfTest
• Web (Docker, experimental)
  • AzulPaint

    docker build https://azul.rs/ui/release/0.2.0/azul-paint.Dockerfile -t azul-paint
    docker run -p 8080:8080 azul-paint

  • AzWidgets

    docker build https://azul.rs/ui/release/0.2.0/azul-widgets.Dockerfile -t azul-widgets
    docker run -p 8080:8080 azul-widgets

  • AzulMaps

    docker build https://azul.rs/ui/release/0.2.0/azul-maps.Dockerfile -t azul-maps
    docker run -p 8080:8080 azul-maps

  • AzulVault

    docker build https://azul.rs/ui/release/0.2.0/azul-vault.Dockerfile -t azul-vault
    docker run -p 8080:8080 azul-vault

  • AzGamepad

    docker build https://azul.rs/ui/release/0.2.0/azul-gamepad.Dockerfile -t azul-gamepad
    docker run -p 8080:8080 azul-gamepad

  • AzCamera

    docker build https://azul.rs/ui/release/0.2.0/azul-camera-app.Dockerfile -t azul-camera-app
    docker run -p 8080:8080 azul-camera-app

  • AzScreenShare

    docker build https://azul.rs/ui/release/0.2.0/azul-screenshare-app.Dockerfile -t azul-screenshare-app
    docker run -p 8080:8080 azul-screenshare-app

  • AzVideo

    docker build https://azul.rs/ui/release/0.2.0/azul-video-app.Dockerfile -t azul-video-app
    docker run -p 8080:8080 azul-video-app

  • AzMeet

    docker build https://azul.rs/ui/release/0.2.0/azul-meet.Dockerfile -t azul-meet
    docker run -p 8080:8080 azul-meet

  • AzSelfTest

    docker build https://azul.rs/ui/release/0.2.0/azul-self-test.Dockerfile -t azul-self-test
    docker run -p 8080:8080 azul-self-test

macOS note: if macOS complains it cannot verify the developer, run sh unquarantine.sh <binary-name> (unquarantine.sh).

Building, installing and debugging these — and going from Rust to a final .apk / .ipa cross-platform — is covered in the Mobile guide.

Installation instructions

Azul is NOT published to PyPI, npm, RubyGems, NuGet, Maven Central or crates.io (same-named packages there are unrelated projects). Instead, azul.rs self-hosts its own distribution channels, regenerated from this exact release by CI (a channel whose package did not build in a given run is simply absent):

# macOS - Homebrew tap (self-hosted bare git repo, see above)
brew tap fschutt/azul https://azul.rs/ui/homebrew-azul.git
brew install fschutt/azul/azul

# Debian / Ubuntu - self-hosted apt repository (unsigned, hence [trusted=yes])
echo 'deb [trusted=yes] https://azul.rs/ui/apt stable main' | sudo tee /etc/apt/sources.list.d/azul.list
sudo apt update
sudo apt install azul

# Python - self-hosted PEP 503 index (NOT pypi.org); pip fetches https://azul.rs/ui/azul/
pip install azul --index-url https://azul.rs/ui

# Java / Kotlin - self-hosted maven2 repository
#   repository https://azul.rs/ui/maven + dependency rs.azul:azul:0.2.0

# Node - install the npm tarball straight from its stable URL
npm install https://azul.rs/ui/npm/azul-0.2.0.tgz

# C# / Ruby - stable file URLs (use as a local NuGet feed / local gem install)
#   https://azul.rs/ui/nuget/flatcontainer/azul/0.2.0/azul.0.2.0.nupkg
#   https://azul.rs/ui/gems/gems/azul-0.2.0.gem

Every binding file is also served directly from this page:

# grab one binding file directly (no examples.zip needed):
curl -O https://azul.rs/ui/release/0.2.0/Azul.cs
curl -O https://azul.rs/ui/release/0.2.0/Azul.hs
curl -LO https://azul.rs/ui/release/0.2.0/azul-java.zip

Use Azul as a Rust dependency

# Cargo.toml (azul is NOT on crates.io; the crate in the repo is azul-dll,
# renamed to `azul` for use)
[dependencies.azul]
package = "azul-dll"
git = "https://github.com/fschutt/azul"
tag = "0.2.0"

# Dynamic linking against a prebuilt azul.dll / libazul.so:
# features = ["link-dynamic"], default-features = false
# export AZ_LINK_PATH=/path/to/libazul

Docs & guide

Agentic

Deploy a web app (pre-lifted WASM base image: experimental preview)

Guide: deploying azul web apps

# prebuilt web base image (experimental; the web backend is not yet stable)
docker pull ghcr.io/fschutt/azul:0.2.0

Statistics

• Code coverage report (grcov HTML, generated by CI)
• Dependency justifications (why each crate is in the tree)
• Supply-chain audit (cargo-deny: advisories, bans, licenses, sources)
• Unsafe-code audit (cargo-geiger)
• Clippy lint summary
• Sanitizers (ASan / UBSan / TSan on the C examples)
• Language binding status board (Linux)
• Language binding status board (macOS)
• Language binding status board (Windows)
• Dependency tree (Linux)
• Dependency tree (macOS)
• Dependency tree (Windows)

License

Source

• Git repository
• Source tree at tag 0.2.0
• GitHub release page
• Crates.io
• Docs.rs