zenity-rs

A lightweight, pure Rust implementation for displaying GUI dialogs from the command line. Designed for shell scripts and CLI tools that need simple user interaction.

Features

• Message dialogs: Info, warning, error, and question dialogs
• Input dialogs: Text entry and password input
• Progress dialog: With stdin control and pulsating mode
• File selection: Open/save dialogs with directory navigation
• List selection: Single-select, checklist, and radiolist modes
• Calendar: Date picker dialog

Highlights

• Pure Rust with no GTK/Qt dependencies
• Native X11 and Wayland support
• Small static binary (~1.5MB with musl)
• Automatic theme detection (light/dark)
• Respects system keyboard layout

Installation

cargo install zenity-rs

Or build from source:

git clone https://github.com/user/zenity-rs
cd zenity-rs
cargo build --release

Usage

Message Dialogs

# Information dialog
zenity-rs --info --text="Operation completed successfully"

# Warning dialog
zenity-rs --warning --text="This action cannot be undone"

# Error dialog
zenity-rs --error --text="Failed to save file"

# Question dialog (Yes/No)
zenity-rs --question --text="Do you want to continue?"

Input Dialogs

# Text entry
zenity-rs --entry --text="Enter your name:" --entry-text="Default"

# Password input
zenity-rs --password --text="Enter password:"

Progress Dialog

# Static progress
zenity-rs --progress --text="Processing..." --percentage=50

# Pulsating progress
zenity-rs --progress --text="Please wait..." --pulsate

# Controlled via stdin
(
  echo "10"
  sleep 1
  echo "50"
  sleep 1
  echo "100"
) | zenity-rs --progress --text="Working..." --auto-close

File Selection

# Open file
zenity-rs --file-selection --title="Select a file"

# Save file
zenity-rs --file-selection --save --filename="output.txt"

# Select directory
zenity-rs --file-selection --directory

List Selection

# Simple list
zenity-rs --list --column="Name" --column="Size" file1 10KB file2 20KB

# Checklist (multi-select)
zenity-rs --list --checklist --column="Select" --column="Item" FALSE "Option A" TRUE "Option B"

# Radiolist (single-select)
zenity-rs --list --radiolist --column="Select" --column="Item" FALSE "Option A" TRUE "Option B"

Calendar

# Date picker
zenity-rs --calendar --text="Select a date"

# With initial date
zenity-rs --calendar --year=2024 --month=12 --day=25

Common Options

--title=TEXT      # Set dialog title
--text=TEXT       # Set dialog text/prompt
--timeout=N       # Auto-close after N seconds

Exit Codes

Building

Default (X11 + Wayland)

cargo build --release

X11 only

cargo build --release --no-default-features --features x11

Wayland only

cargo build --release --no-default-features --features wayland

Static binary (musl)

cargo build --release --target x86_64-unknown-linux-musl

License

MIT