Welcome to Java-GI

Java-GI generates Java bindings for native libraries including Gtk, LibAdwaita, GtkSourceview, WebkitGtk and GStreamer using GObject-Introspection data. The bindings use the Panama Foreign Function & Memory API (JEP-442) to directly access native resources from inside the JVM.

Please note that Java-GI is still under active development. Feedback is welcome.

How to use

• Basic usage and example applications

• Registering new GTypes

• Creating composite template classes

• Generating bindings for other libraries

Supported libraries

Java-GI version 0.7.2 works with OpenJDK 20, and 0.8.0 with OpenJDK 21. They have been built with the following library versions:

Library	Java-GI 0.7.x	Java-GI 0.8.x
OpenJDK	20	21
GLib	2.76	2.78
GTK	4.10	4.12
LibAdwaita	1.3	1.4
GStreamer	1.20	1.22
GtkSourceview	5.9	5.10
WebkitGtk	2.41	2.42

Java bindings for there libraries are available from Maven Central.

API documentation

Java-GI converts API documentation from GObject-Introspection to Javadoc. For the library bindings published by Java-GI 0.8.0, the Javadoc is available here.

JAR files with the Javadoc and source code, to use offline in your IDE, are available from Maven Central.

Example apps

You can find example applications in the java-gi-examples repository.

Contributing

To build Java-GI for yourself, make changes, or use Java-GI to generate bindings for other (GObject-Introspection based) libraries, follow the instructions here. Please log issues, questions and requests on Github, or join the discussion on Matrix.