Create GUI dialogs in one line of code
Finding a Little Zen
![© Lead Image © Martin Capek, 123RF.com © Lead Image © Martin Capek, 123RF.com](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/123rf_33427219_steampunk-zen_martincapek_resized.png/785990-1-eng-US/123rf_33427219_Steampunk-zen_MartinCapek_resized.png_medium.png)
© Lead Image © Martin Capek, 123RF.com
The Zenity command-line utility lets you create simple dialog boxes with your own data or with the output of utilities and applications.
Zenity is a command-line GUI creator that has been around since 2012 and is pre-installed on most versions of Linux, including Raspberry Pis. Zenity isn't designed to be a high-level GUI development tool, but if you just need some basic scripting with dialogs, then Zenity might be a perfect fit.
I was amazed that in one line of Bash code I was able to show:
- stats in a message dialog
- a web page in a dialog
- CSV data or SQL queries in a list dialog
After looking at slightly more complex applications, I found I was able to create:
- a progress bar with dynamic values (about seven lines)
- a form to insert user data into an SQL database (about eight lines)
- a four-button dialog to control a Rasp PI Rover (~20 lines)
In this article, I introduce Zenity with some examples.
Getting Started
The Zenity [1] command-line utility is supported on Linux, macOS, and Windows. Zenity can display calendar, color selector, file selector, form, list, message, notification, progress, scale, and text dialogs.
The Zenity message dialog can be used like a Bash echo statement; for example, to show an information message, enter:
zenity --info --text="Some text" --title="My Title"
Information from command-line tools and utilities can be passed to Zenity. For example, the instantaneous CPU idle time from the top
utility can be parsed and passed to a Zenity dialog (Figure 1):
zenity --info --text=$(top -n 1 | grep %Cpu | awk '{print $8}') --title="CPU Idle Time"
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-1/785993-1-eng-US/Figure-1_large.png)
Text font and size can be modified in message dialogs in Pango markup language syntax [2]. Pango is similar to HTML, and the <span>
… </span>
set of tags is typically used to encode font and color definitions (Figure 2):
zenity --warning --text=' HIGH Temperature' --title="HDD Check"
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-2/785996-1-eng-US/Figure-2_large.png)
For scripting applications that need to pass more information to users, text-info
dialogs can pass text files and URL links (Figure 3):
zenity --text-info --title="Background Reading" --html --url="https://developer.gnome.org" --checkbox="I read it...and I'm good to go"
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-3/785999-1-eng-US/Figure-3_large.png)
For dialogs with OK and Cancel buttons, Zenity returns a
to confirm and a 1
to cancel. Zenity will not process JavaScript on a web page.
Simple dialogs like the info, warning and error dialogs will only have an OK button. All the other dialogs will have Cancel buttons, as well. The button text can be changed with the --ok-label
and the --cancel-label
options. More buttons can be added with the --extra-button
option.
Dynamic Values
A Zenity progress dialog can show dynamic updates with scripts that use subshells. A subshell is configured with parentheses. Step executions within the subshell are paused by sleep statements.
The following code shows a three-step example of a subshell with a Zenity progress dialog (Figure 4):
( echo "33"; echo "# 1/3 done" ; sleep 5; echo "66"; echo "# 2/3 done" ; sleep 5; echo "100";echo "# Finished" ) | zenity --progress --title="3 step test"
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-4/786002-1-eng-US/Figure-4_large.png)
When a step outputs a value, the progress bar updates. The text on the progress dialog is changed by outputting a text string that starts with a #
character.
Listing 1 and Figure 5 show an example of current seconds with the progress bar rescaled from 0 to 60.
Listing 1
Scaled Progress Bar
#!/bin/bash # show_seconds.sh - progress dialog to show seconds echo "Press [CTRL+C] to stop..." ( while :; do echo "# $(date +'%S')" # Scale 0-60 to 0-100 echo "$(date +'%S')*100/60" | bc sleep 1 done ) | zenity --progress --title="Show Time in Seconds"
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-5/786005-1-eng-US/Figure-5_large.png)
The Bash while
statement lets you show dynamic values continuously until the Cancel button is pressed.
CSV Data in List Dialogs
For simple text files and known datasets, the list
dialog works quite well. The dialog expects the data to be sequential. The following code creates a two-column example (Figure 6) with inline data:
zenity --list --title="2 Column Example" --column="Month" --column="Sales" Jan 100 Feb 95 Mar 77 Apr 110 May 111
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-6/786008-1-eng-US/Figure-6_large.png)
To pass a data file (CSV or text) into Zenity, the text needs to be reformatted. The tr
command can replace CSV field separators like commas with a newline (\n) character (Listing 2).
Listing 2
Reformatting Data
$ cat pidata.csv 10:00,12,running 10:20,14,stopped 10:30,13,running $ cat pidata.csv | tr ',' '\n' 10:00 12 running 10:20 14 stopped 10:30 13 running
The output can then be passed to a Zenity list with column headings (Figure 7):
cat pidata.csv | tr ',' '\n' | zenity --list --title="Pi Data" --column="Time" --column="Temp" --column="Pump"
![](/var/linux_magazin/storage/images/issues/2021/247/zenity-dialogs/figure-7/786011-1-eng-US/Figure-7_large.png)
Once you have some Zenity and Bash basics down, you can start doing more advanced operations, such as:
awk -F "\"*,\"*" '{print $3 "\n" $1}' pidata.csv | zenity --list --column="field3" --column="field1"
This one-line example uses Awk to parse specific data (fields 1 and 3) in the CSV file.
Buy this article as PDF
(incl. VAT)
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you’ve found an article to be beneficial.
![Learn More](https://www.linux-magazine.com/var/linux_magazin/storage/images/media/linux-magazine-eng-us/images/misc/learn-more/834592-1-eng-US/Learn-More_medium.png)
News
-
NVIDIA Released Driver for Upcoming NVIDIA 560 GPU for Linux
Not only has NVIDIA released the driver for its upcoming CPU series, it's the first release that defaults to using open-source GPU kernel modules.
-
OpenMandriva Lx 24.07 Released
If you’re into rolling release Linux distributions, OpenMandriva ROME has a new snapshot with a new kernel.
-
Kernel 6.10 Available for General Usage
Linus Torvalds has released the 6.10 kernel and it includes significant performance increases for Intel Core hybrid systems and more.
-
TUXEDO Computers Releases InfinityBook Pro 14 Gen9 Laptop
Sporting either AMD or Intel CPUs, the TUXEDO InfinityBook Pro 14 is an extremely compact, lightweight, sturdy powerhouse.
-
Google Extends Support for Linux Kernels Used for Android
Because the LTS Linux kernel releases are so important to Android, Google has decided to extend the support period beyond that offered by the kernel development team.
-
Linux Mint 22 Stable Delayed
If you're anxious about getting your hands on the stable release of Linux Mint 22, it looks as if you're going to have to wait a bit longer.
-
Nitrux 3.5.1 Available for Install
The latest version of the immutable, systemd-free distribution includes an updated kernel and NVIDIA driver.
-
Debian 12.6 Released with Plenty of Bug Fixes and Updates
The sixth update to Debian "Bookworm" is all about security mitigations and making adjustments for some "serious problems."
-
Canonical Offers 12-Year LTS for Open Source Docker Images
Canonical is expanding its LTS offering to reach beyond the DEB packages with a new distro-less Docker image.
-
Plasma Desktop 6.1 Released with Several Enhancements
If you're a fan of Plasma Desktop, you should be excited about this new point release.