LGI is an open source GUI framework (on Phabricator) for abstracting out all the operating system dependencies that you can produce portable code. It handles all the graphical interface functions, threading and semaphores, network connectivity and lots of other bits and peices to help build small, fast and reliable applications.

The strengths of LGI is that it's a small enough library that one person can understand it all. Also it's not too much of a burden on an application, both in increased download time and memory footprint. LGI at the moment compresses to about 519 KiB, which while not insignificant is quite a bit smaller than the other options.

Ultimately however size is a secondary consideration to the core feature of LGI and that is portability. Currently 3 serious ports exist: Windows, Mac and Linux. There is also a legacy Haiku/BeOS port which is unsupported.

I have completed some basic documentation for the library and scripting language, and there are a number of apps with source code available on github.


Latest Trunk Code:

hg clone https://phab.mallen.id.au/source/lgi/ lgi/trunk


Developer environement GUI:
Windows x64
2.7 MiB, 12/11/2018

Resource Editor:

Graphical editor / translation for resource files:
Windows x64
0.9 MiB, 12/11/2018


Cross platform and version control user interface (Git/Hg/Svn/Cvs):
Windows x64
OSX x32
Linux x64
glibc 2.27
2.4 MiB, 23/11/2018
1.3 MiB, 23/11/2018
5.1 MiB, 20/5/2018

Ports Status

Ordered by maturity:
  • Win32/64 (Win10)
    This is the most stable and featured port, as it's the plaform I use the most. Everything works in Windows, and it's the fastest due to the speed of the Win32 Graphical Subsystem. I no longer support or test on any version of windows before Win10. The GTK port also works on Windows and you can compile with MingW as well.
  • Mac OS X (>=10.13)
    The current port of Lgi uses the Cocoa API (as of late 2019), and is mostly stable. I run 10.15 so that's where the testing is happening. The old Carbon is being removed.
  • Linux/Gtk+ (Ubuntu >= 16.xx)
    Stable port for GTK3. Runs great in Ubuntu, less so in Debian. Runs on both x86 and ARM instruction sets. Yes, it's fine on a Pi.
  • SDL
    The SDL port has some GUI functionality. It's not used much. Font support via Freetype2. There isn't any support for overlapped windows but you can still create simple apps that use the whole frame per window.
  • Haiku (BeOS)
    The BeOS / Haiku port is being removed from Lgi. back... see the 'Haiku' branch for implementation.


Building LGI

First check out the source:
hg clone https://phab.mallen.id.au/source/lgi/ lgi/trunk


Support Libraries

For full graphics and charset support download (or check you already have) iconv, libpng and zlib, libjpeg; then add their include paths to your compilers include paths. Or find the defines in Lgi.h for the various libraries and set them to 0.

Visual Studio

Install a supported version of Visual Studio: 2015 or 2019.

Adding build folders to the shared library path:

Add this to your path:
  • ./lgi/trunk/lib


Install XCode

Go to the Apple Developer site and grab XCode


Open Lgi.xcodeproj in XCode and run the build command.


Building on Ubuntu:
sudo apt-get install mercurial libmagic-dev libgtk3.0-dev \
    libgstreamer1.0-dev libappindicator3-dev libssh-dev
hg clone https://phab.mallen.id.au/source/lgi/ lgi/trunk
cd lgi/trunk
ln -s Makefile.linux makefile
make -j 4
If apt can't find the gtk 3 dev libraries, on some systems it's called 'libgtk-3-dev' just to be different I guess.

If the makefile doesn't work on your system:
  • Download a binary of LgiIde
  • Project->Open and select lgi/trunk/Ide/LgiIde.xml
  • Project->Create Makefile->Linux
  • Project->Build
A bunch of very old builds. For anything current you should use the git repositry:

3.4.0 [Stable]

Accumulation of fixes and features to date.
3.3.0 [Stable]
3.2.1 [Stable]
3.2.0 [Stable]
3.02 [Stable]
3.01 [Stable]
3.00 [Stable]
2.30 [Stable]
2.20 [Stable]
2.10 [Stable]
2.00 [Stable]
1.99 [Stable]
1.98 [Stable]
1.97 [Stable]
1.96 [Stable]
1.95 [Unstable]
1.90 [Stable]
1.85 [Stable]
1.80 [Stable]
1.70 [Stable]
1.66 [Stable]
1.65 [Stable]
1.60 [Stable]
1.51 [Stable]
1.50 [Unstable]
1.45 [Stable]
1.40 [Stable]
1.31 [Stable]
1.30 [Stable]