Zenity dialogs for Golang, Windows and macOS

This repo includes:

a cross-platform Go package providing Zenity-like dialogs (simple dialogs that interact graphically with the user)
a “port” of the zenity command to both Windows and macOS based on that library.

Implemented dialogs:

message (error, info, question, warning)
text entry
list (simple)
password
file selection
color selection
calendar
progress
notification

Behavior on Windows, macOS and other Unixes might differ slightly. Some of that is intended (reflecting platform differences), other bits are unfortunate limitations.

Installing

The Go package:

go get github.com/ncruces/zenity@latest

The zenity command on macOS/WSL using Homebrew 🍺:

brew install ncruces/tap/zenity

The zenity command on Windows using Scoop 🍨:

scoop install https://ncruces.github.io/scoop/zenity.json

The zenity command on macOS/Windows, if you have Go:

go install github.com/ncruces/zenity/cmd/zenity@latest

Or download the latest release.

Using

For the Go package, consult the documentation and examples.

The zenity command does its best to be compatible with the GNOME version.
Consult the documentation and man page of that command.

Why?

Benefits of the Go package:

no cgo (see benefits, mostly cross-compilation)
no main loop (or any other threading or initialization requirements)
cancelation through context
on Windows:
- no additional dependencies
  - Explorer shell not required
  - works in Server Core
- Unicode support
- High DPI (no manifest required)
- Visual Styles (no manifest required)
- WSL/Cygwin/MSYS2 support
on macOS:
- only dependency is osascript
on other Unixes:
- wraps either one of zenity, matedialog, qarma

Zenity wrappers

Zenity wrappers for languages other than Go can benefit from our zenity command. On Unix (Linux, FreeBSD, etc) they can use the original tool, and on Windows/macOS they may use the command from this repo for portability.

Examples:

NodeJS dialog-gui by @SnurfDev
Crystal zenity.cr by @kojix2

Credits

I'd like to thank all contributors, but @gen2brain in particular for dlgs, which was instrumental to the Windows port of zenity.

Name		Name	Last commit message	Last commit date
Latest commit History 379 Commits
.github		.github
cmd/zenity		cmd/zenity
internal		internal
scripts		scripts
testdata		testdata
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
color.go		color.go
color_darwin.go		color_darwin.go
color_test.go		color_test.go
color_unix.go		color_unix.go
color_windows.go		color_windows.go
date.go		date.go
date_darwin.go		date_darwin.go
date_test.go		date_test.go
date_unix.go		date_unix.go
date_windows.go		date_windows.go
entry.go		entry.go
entry_darwin.go		entry_darwin.go
entry_test.go		entry_test.go
entry_unix.go		entry_unix.go
entry_windows.go		entry_windows.go
file.go		file.go
file_darwin.go		file_darwin.go
file_filter_test.go		file_filter_test.go
file_test.go		file_test.go
file_unix.go		file_unix.go
file_util_test.go		file_util_test.go
file_windows.go		file_windows.go
go.mod		go.mod
go.sum		go.sum
list.go		list.go
list_darwin.go		list_darwin.go
list_test.go		list_test.go
list_unix.go		list_unix.go
list_windows.go		list_windows.go
main_test.go		main_test.go
msg.go		msg.go
msg_darwin.go		msg_darwin.go
msg_test.go		msg_test.go
msg_unix.go		msg_unix.go
msg_windows.go		msg_windows.go
notify.go		notify.go
notify_darwin.go		notify_darwin.go
notify_test.go		notify_test.go
notify_unix.go		notify_unix.go
notify_windows.go		notify_windows.go
progress.go		progress.go
progress_darwin.go		progress_darwin.go
progress_test.go		progress_test.go
progress_unix.go		progress_unix.go
progress_windows.go		progress_windows.go
pwd.go		pwd.go
pwd_darwin.go		pwd_darwin.go
pwd_test.go		pwd_test.go
pwd_unix.go		pwd_unix.go
pwd_windows.go		pwd_windows.go
util.go		util.go
util_darwin.go		util_darwin.go
util_test.go		util_test.go
util_windows.go		util_windows.go
zenity.go		zenity.go
zenity_darwin.go		zenity_darwin.go
zenity_test.go		zenity_test.go
zenity_unix.go		zenity_unix.go
zenity_windows.go		zenity_windows.go

License

ncruces/zenity

Folders and files

Latest commit

History

Repository files navigation

Zenity dialogs for Golang, Windows and macOS

Installing

Using

Why?

Benefits of the Go package: