4 releases (2 breaking)
Uses new Rust 2021
|0.15.4||Feb 20, 2022|
|0.15.1||Jan 15, 2022|
|0.14.0||Jun 22, 2021|
|0.0.0||Apr 4, 2021|
#6 in #gtk3
30,301 downloads per month
Used in 97 crates (via gtk)
gtk-rs organization aims to provide safe Rust binding over
You can find more about it on https://gtk-rs.org.
This repository contains all the "core" crates of the gtk-rs organization. For more
information about each crate, please refer to their
README.md file in their directory.
Currently, the minimum supported Rust version is
gtk3-rs repository contains Rust crates for GTK 3. However there is a large ecosystem of
GObject libraries and many of these
libraries have Rust bindings based on the tooling included in
Of particular note:
- gtk-rs-core - bindings for some of the core libraries such as
- gstreamer-rs - bindings for the GStreamer media framework
When using crates that are not part of the
gtk-rs repository, you will
need to be careful and ensure that they do not pull in incompatible versions of core
To regenerate crates using gir, please use the
file as follows:
$ python3 generator.py
This repository is mostly split into two branches:
master contains the not yet released code and is where new developments
crate contains the last release source code and isn't supposed to
This repository is structured as follows:
- crate/ | |-- README.md |-- Gir.toml |-- Cargo.toml |-- src/ |-- sys/
crate is a "top" directory (so "atk" or "gdk" in here for example).
Each crate contains:
README.md: explanations about the crate itself and eventually some details.
Cargo.toml: descriptor of the crate, used by
Gir.toml: configuration used by gir to generate most of the crates' code.
src: the source code of the crate.
sys: the 1:1 bindings of the C API.
During development, it is useful to execute the generator with a different version of the gir tool or of the gir files, for instance to test if the code generation is successful before submitting a pull request to update one of the submodules. This can be done by specifying arguments to the generator script, for instance, to run the generator on a local copy of the gir files:
$ python3 generator.py --gir-files-directory ../gir-files/
python3 generator.py --help for more details.