LGI is a GUI framework 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 300kb, 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: Win32, Mac and Linux. There is also a legacy 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 sourceforge.

Related Information:

Latest Trunk Code:

svn checkout https://svn.code.sf.net/p/lgi/code/trunk Lgi/trunk


Version: v3.4.0 [Stable]
Version: v3.3.0 [Stable]
Version: v3.2.1 [Stable]
Version: v3.2.0 [Stable]
Version: v3.02 [Stable]
Version: v3.01 [Stable]
Version: v3.00 [Stable]
Version: v2.20 [Stable]
Version: v2.10 [Stable]
Version: v2.00 [Stable]
Version: v1.99 [Stable]
Ports Status
Ordered by maturity:
  • Win32 (XP/Vista/Win7)
    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 longer support or test on any version of windows before XP.
  • Mac OS X (>=10.5.0)
    The newest port of Lgi, most things are working but there are less used areas that need implementing or fixing. The GUI code is fairly complete and solid, although some more optimization is needed. Threads, sockets etc all work too.
  • Linux/Gtk+ (>=2.6)
    This is currently being rewritten to target Gtk+ as I simply do not have to time to frig with XCB/XLIB to make it work. There is some basic code working but lots of things still need to be done to make a large application run well.
  • MingW
    I ported the win32 code to gcc/MingW and there is working makefiles. The code isn't extensively tested but the IDE runs ok, YMMV. The underlying Win32 code is very good, so there would only be problems that Cygwin/GCC introduced.
  • BeOS (Zeta)
    This is an old old port from the r5 days that I recently updated to work on Zeta for v2. Most of the basic functionality works to put windows on the screen. But lots of little quirks still exist or things arent implemented. However that said some of the design concepts for Lgi came straight out of BeOS, so that BeOS port often is the "cleanest" of the implementations, having a direct mapping to the native API instead of convoluted hacks to make things work. Currently the BeOS port doesn't run very well on Zeta, there is some problem with locks getting stuck in really weird places. I consider this port deprecated at the moment.

Building LGI
First check out the source:
svn checkout https://svn.code.sf.net/p/lgi/code/trunk Lgi/trunk


Support Libraries

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

Visual Studio 6,2005,2008,2010

Install a supported version of Visual Studio. Build the appropriate workspace:
  • vc6: Lgi.dsw
  • vs2005: Lgi_vc8.sln
  • vs2008: Lgi_vc9.sln
  • vs2010: Lgi_vc10.sln

Adding build folders to the shared library path:

Add this to your path:
  • [install_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 10.4:
sudo apt-get install subversion
sudo apt-get install g++
sudo apt-get install libgtk2.0-dev
svn co https://lgi.svn.sourceforge.net/svnroot/lgi Lgi
cd Lgi/trunk
ln -s Makefile.linux makefile
Adding build folders to the shared library path:
cd /usr/local/lib
sudo ln -s [install_path]/Lgi/trunk/DebugX/liblgid.so liblgid.so
sudo ln -s [install_path]/Lgi/trunk/ReleaseX/liblgi.so liblgi.so
M$ VC++ 6 Tip
Add this to your Common/MsDev98/Bin/AUTOEXP.DAT file to show various LGI types inline:
; LGI types
GDateTime=<_Year>/<_Month>/<_Day> <_Hours>:<_Minutes>:<_Seconds>
3.4.0 [Stable]
Download: Source + Docs [Common, 4730K, 11/5/2011]

Accumulation of fixes and features to date.
3.3.0 [Stable]
Download: Source + Docs [Common, 3764K, 10/6/2009]
3.2.1 [Stable]
Download: Source + Docs [Common, 3674K, 20/10/2008]
3.2.0 [Stable]
Download: Source + Docs [Common, 3636K, 12/9/2008]
3.02 [Stable]
Download: Sources + Docs [Common, 1899K, 4/10/2007]
3.01 [Stable]
Download: Source + Docs Zip [Common, 2982K, 20/6/2007]
3.00 [Stable]
Download: Source + Docs Zip [Common, 2928K, 1/5/2007]
2.30 [Stable]
2.20 [Stable]
Download: Lgi-20060502 [Common, 2827K, 2/5/2006]
Download: Lgi-20060418 [Common, 2686K, 18/4/2006]
Download: Lgi-20051026 [Common, 2730K, 26/10/2005]
2.10 [Stable]
Download: Source+Docs [Common, 2842K, 27/7/2005]
2.00 [Stable]
Download: Source+Docs [Common, 3896K, 26/10/2004]
1.99 [Stable]
Download: Source+Docs [Common, 2609K, 7/5/2004]
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]