A C# binding generator for GObject based libraries providing a C# friendly API surface
Gir.Core provides C# bindings for several GObject based libraries like GTK for user interfaces.
This project aims to provide a complete set of APIs for writing rich cross-platform user interfaces and multimedia programs. It is built upon the well-established GObject Introspection framework for language bindings.
The code is under development and not ready for production use. There are nuget packages available. The API is subject to change as long as version 1.0 is not released. Feel free to visit the nuget organization to get an overview.
The upcoming features and releases can be checked out in the milestones.
Library | Description | Level of Support |
---|---|---|
GTK-4.0 | UI-Toolkit | Partial |
Libadwaita-1 | Building blocks for modern GNOME applications | Partial |
GStreamer-1.0 | Multimedia Framework | Partial |
Cairo-1.0 | Graphics Library | Partial |
Pango-1.0 | Font/Text Library | Partial |
Gio-2.0 | Library for high level application functionality | Partial |
GdkPixbuf-2.0 | Image loading in various formats | Partial |
libshumate | Library to display maps | Planned |
WebKit-6.0 | Browser engine (Linux only) | Partial |
JavaScriptCore-6.0 | JavaScript engine for WebKit (Linux only) | Partial |
GtkSource-5 | Extends a Gtk.TextView to be like a source code editor | Partial |
Anyone who wants to help is very welcome. If you want to get in contact feel free to chat with us via matrix (#gircore:matrix.org) or open a discussion and don't forget to check out our contribution guidelines.
To generate the bindings locally execute the following commands in a terminal. Make sure to initialise submodules with --recursive
otherwise the gir-files
directory will not be loaded properly.
$ git clone --recursive https://github.com/gircore/gir.core.git
$ cd gir.core/src
$ dotnet fsi GenerateLibs.fsx
$ dotnet build GirCore.Libs.slnf
If you want to clean the Libs folder of all generated files run:
$ dotnet fsi CleanLibs.fsx
For more advanced build options, see the documentation.
The folder structure in this repository is organized as follows:
The code in the library folder is not complete because most of the code is generated when the GirTool is run.
Gir.Core is licensed under the terms of the MIT-License. Please see the license file for further information.
The Gir.Core logo is built upon the original GTK logo by Andreas Nilsson which is licensed under the GNU Free Documentation License and was relicensed under CC BY-SA 3.0. Therefore the Gir.Core logo is licensed under the CC BY-SA 3.0, too.