Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
Jan 16, 2021
Dec 31, 2019
Nov 4, 2020
Nov 3, 2020


Join the chat at Go Report Card Build Status Godoc Card

Cross platform rapid GUI framework for golang based on Dear ImGui and the great golang binding imgui-go.

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

Supported Platforms

giu is built upon GLFW v3.3, so idealy giu could support all platforms that GLFW v3.3 supports.

  • Windows (only tested on Windows 10 x64)
  • MacOS (only tested on MacOS v10.15)
  • Linux (thanks remeh to test it)
  • Raspberry pi 3b (thanks sndvaps to test it)


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

  • Small executable file size (<3mb after upx compression for the example/helloworld demo).
  • Live-update during the resizing of OS window (implemented on GLFW 3.3 and OpenGL 3.2).
  • Redraw only when user event occurred. Costs only 0.5% CPU usage with 60FPS.
  • Declarative UI (see examples for more detail).
  • DPI awareness (auto scale font and UI to adapte high DPI monitor).
  • Drop in usage, no need to implement render and platform.
  • Freetype font rendering support.
  • OS clipboard support.

Screenshot Screenshot1 Screenshot2

Hello world

package main

import (

    g ""

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

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

func loop() {
    g.SingleWindow("hello world").Layout(g.Layout{
        g.Label("Hello world from giu"),
            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, nil)

Here is result.



Check Wiki

Embed Lua as script language to create UI

This is a very interesting use case and it is incredibly easy.

package main

import (
	g ""
	lua ""
	luar ""

// Define a simple plugin struct
type LuaPlugin struct {
	Name   string
	Layout g.Layout

// Genreate a string pointer for lua
func GStrPtr() *string {
	var str string
	return &str

// Receive string value from pointer
func ToStr(str *string) string {
	return *str

var luaPlugin LuaPlugin

func onRunScript() {
	luaPlugin.Name = ""
	luaPlugin.Layout = g.Layout{}

	luaState := lua.NewState()
	defer luaState.Close()

	// Pass luaPlugin into lua VM.
	luaState.SetGlobal("luaPlugin", luar.New(luaState, &luaPlugin))

	// Register some method (giu widget creator)
	luaState.SetGlobal("GStrPtr", luar.New(luaState, GStrPtr))
	luaState.SetGlobal("ToStr", luar.New(luaState, ToStr))

	luaState.SetGlobal("Label", luar.New(luaState, g.Label))
	luaState.SetGlobal("Button", luar.New(luaState, g.Button))
	luaState.SetGlobal("InputText", luar.New(luaState, g.InputText))

	// Simple lua code
	luaCode := `
    luaPlugin.Name = "test"

    name = GStrPtr()
    function onGreeting()
	  print(string.format("Greeting %s", ToStr(name)))
    luaPlugin.Layout = {
      Label("Label from lua, tell me your name"),
      InputText("##name", 200, name),

	// Run lua script
	if err := luaState.DoString(luaCode); err != nil {

func loop() {
	g.SingleWindow("Lua test", g.Layout{
		g.Button("Load from lua").OnClick(onRunScript),

func main() {
	wnd := g.NewMasterWindow("Lua test", 400, 300, 0, nil)


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

Projects using giu


PipeIt is a text transformation, conversion, cleansing and extraction tool.

PipeIt Demo


NVTool is a video encoding tool based on NVEncC.

NVTool Screenshots

You can’t perform that action at this time.