giu

A rapid cross-platform GUI framework for Go based on Dear ImGui and the great Go binding cimgui-go.

Any contribution (features, widgets, tutorials, documents, etc...) is appreciated!

Sponsor

(This library is available under a free and permissive license, but needs financial support to sustain its continued improvements. In addition to maintenance and stability there are many desirable features yet to be added. If you are using giu, please consider reaching out.)

Businesses: support continued development and maintenance via invoiced technical support, maintenance, sponsoring contracts:

E-mail: allengnr@gmail.com

Individuals: support continued development and maintenance here.

Documentation

For documentation refer to our wiki, examples, GoDoc, or just take a look at comments in code.

Supported Platforms

giu is built upon GLFW v3.3, so ideally giu could support all platforms that GLFW v3.3 supports. It is also restricted by cimgui-go (which at the moment builds only for linux, windows and mac).

• Windows (Windows 10 x64 and Windows 11 x64)
• macOS (macOS v10.15 and macOS Big Sur)
• Linux (thanks remeh for testing it)
• Raspberry Pi 3B (thanks sndvaps for testing it)

[!note] Because giu relays on C++ code, you need to have C/C++ compiler set up.

Features

Compared to other Dear ImGui golang bindings, giu has the following features:

• Small executable file size (<3MB after UPX compression for the example/helloworld demo).
• Live-updating during the resizing of the OS window (implemented on GLFW 3.3 and OpenGL 3.2).
• Support for displaying various languages without any font setting. Giu will rebuild font atlas incrementally according to texts in UI between frames.
• Redraws only when user event occurs. Costs only 0.5% CPU usage with 60FPS.
• Declarative UI (see examples for more details).
• DPI awareness (auto scaling font and UI to adapt to high DPI monitors).
• Drop in usage; no need to implement render and platform.
• OS clipboard support.

Hello world

package main

import (
        "fmt"

        g "github.com/AllenDang/giu"
)

func onClickMe() {
        fmt.Println("Hello world!")
}

func onImSoCute() {
        fmt.Println("Im sooooooo cute!!")
}

func loop() {
        g.SingleWindow().Layout(
                g.Label("Hello world from giu"),
                g.Row(
                        g.Button("Click Me").OnClick(onClickMe),
                        g.Button("I'm so cute").OnClick(onImSoCute),
                ),
        )
}

func main() {
        wnd := g.NewMasterWindow("Hello world", 400, 200, g.MasterWindowFlagsNotResizable)
        wnd.Run(loop)
}

Here is the result:

Install

The backend of giu depends on OpenGL 3.3, make sure your environment supports it (as far as I know, some Virtual Machines like VirtualBox doesn't support it).

MacOS

xcode-select --install
go get github.com/AllenDang/giu

Windows

1. Install mingw download here. Thanks @alchem1ster!
2. Add the binaries folder of mingw to the path (usually is \mingw64\bin).
3. go get github.com/AllenDang/giu in your project

Linux

First you need to install the required dependencies:

sudo apt install libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev libglx-dev libgl1-mesa-dev libxxf86vm-dev

sudo dnf install libX11-devel libXcursor-devel libXrandr-devel libXinerama-devel libXi-devel libGL-devel libXxf86vm-devel

sudo pacman -Sy glfw

you may also need to install C/C++ compiler (like g++) if it isn't already installed. Follow go compiler prompts.

Then, a simple go build will work.

Cross-compiling is a bit more complicated. Let's say that you want to build for arm64. This is what you would need to do:

sudo dpkg --add-architecture arm64
sudo apt update
sudo apt install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu \
    libx11-dev:arm64 libxcursor-dev:arm64 libxrandr-dev:arm64 libxinerama-dev:arm64 libxi-dev:arm64 libglx-dev:arm64 libgl1-mesa-dev:arm64 libxxf86vm-dev:arm64
GOOS=linux GOARCH=arm64 CGO_ENABLED=1 CC=aarch64-linux-gnu-gcc CXX=aarch64-linux-gnu-g++ HOST=aarch64-linux-gnu go build -v

Deploying

MacOS -> MacOS

go build -ldflags "-s -w" .

Windows -> Windows

go build -ldflags "-s -w -H=windowsgui -extldflags=-static" .

MacOS/Linux -> Windows

Install mingw-64.

[!warning] You must use mingw32-w64 version v12.0.0 or later!

Otherwise you'll get

undefined reference to `__imp_isblank'

Explaination

From https://www.mingw-w64.org/changelog/:

Important: UCRT is now the default CRT runtime instead of MSVCRT, check the mingw-w64-doc/howto-build/ucrt-vs-msvcrt.txt document for details. Both header set and CRT must be configured and built with the same settings consistently for proper functionality. Switching runtimes requires all libraries to be rebuilt, including GCC.

Currently, it is tested, that the following linux distros ship with the right version:

• Fedora (>= 42)
• Arch Linux

Generally if you have gcc 14+, it should work fine.

More details and discussion in #992.

brew install mingw-w64

sudo dnf install mingw64-gcc mingw64-gcc-c++ mingw64-winpthreads-static

pacman -Sy mingw-w64-gcc

1. Prepare and embed the application icon into the executable and build.

cat > YourExeName.rc << EOL
id ICON "./res/app_win.ico"
GLFW_ICON ICON "./res/app_win.ico"
EOL

x86_64-w64-mingw32-windres YourExeName.rc -O coff -o YourExeName.syso
GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ HOST=x86_64-w64-mingw32 go build -ldflags "-s -w -H=windowsgui -extldflags=-static" -p 4 -v -o YourExeName.exe

rm YourExeName.syso
rm YourExeName.rc

Contribution

All kinds of pull requests (document, demo, screenshots, code, etc.) are more than welcome!

Star History