gotk4 Examples

This repository provides examples on using GTK4 and GTK3 using the gotk4 bindings.

Examples

GTK4 examples are in ./gtk4. A simple Hello World example is in ./gtk4/simple.

Getting Started

Before running any of these examples, you must grab the dependencies in your operating system or distribution.

Installing GTK

Below are instructions for getting the needed dependencies for GTK on certain distros. Most distros and operating systems will be missing from this list, so PRs are welcomed.

Linux/macOS - Nix

# Nix channels:
nix-shell -p gtk4 gtk3 gobject-introspection pkg-config

# Nix flakes (very slow):
nix shell nixpkgs#gtk4 nixpkgs#gtk3 nixpkgs#gobject-introspection nixpkgs#pkg-config

Linux - Arch

sudo pacman -S gtk4 gobject-introspection

Linux - Ubuntu

sudo apt install libgtk-3-dev # 18.04 (bionic) or later
sudo apt install libgtk-4-dev # 21.04 (hirsuit) or later

Linux - Fedora

sudo dnf install gtk4-devel gobject-introspection-devel

Linux - openSUSE

sudo zypper install gtk4-devel gobject-introspection-devel

macOS

brew install gtk4 gtk+3 gobject-introspection pkg-config

Windows - Msys2

pacman -S mingw-w64-x86_64-toolchain mingw-w64-x86_64-gtk4 mingw-w64-x86_64-gobject-introspection

Installing Go

The minimum Go version required to run gotk4 is 1.21. If your distribution or operating system does not have 1.21, follow the steps under the "Other OS/distros" section.

Linux/macOS - Nix

# Installing just Go:
nix-env -iA nixpkgs.go

# Dropping into a shell with Go:
nix-shell -p go

# Using gotk4-nix's shell, which will also grab GTK dependencies:
nix-shell

Linux - Ubuntu

Snippet taken from the Go wiki:

sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
sudo apt install golang-go # or golang-1.17

Linux - Fedora

sudo dnf install golang

The packaged version of Go on Fedora is usually a few versions behind upstream on non-rawhide branches, so you might want to manually install Go using the installation instructions mentioned below.

Linux - openSUSE

sudo zypper install go

Other OS/distros

Follow doc/install for more information.

Running Examples

This snippet assumes that you've already cloned this repository down and are currently inside the repository.

go run -v ./gtk4/simple

Important: if you don't run with -v, you might start wondering if go run is hung or not. Always keep in mind that building gotk4 will be very slow at first, and the slow building is normal.