PyGObject is a Python package which provides bindings for GObject based libraries such as GTK, GStreamer, WebKitGTK, GLib, GIO and many more.
It supports Linux, Windows and macOS and works with Python 3.7+ and PyPy3. PyGObject, including this documentation, is licensed under the LGPLv2.1+.
If you want to write a Python application for GNOME or a Python GUI application using GTK, then PyGObject is the way to go. For more information on specific libraries check out the “Python GTK 3 Tutorial” and the “Python GI API Reference”.
import gi
gi.require_version("Gtk", "3.0")
from gi.repository import Gtk
window = Gtk.Window(title="Hello World")
window.show()
window.connect("destroy", Gtk.main_quit)
Gtk.main()
How does it work?
PyGObject uses glib, gobject, girepository, libffi and other libraries to access the C library (libgtk-3.so) in combination with the additional metadata from the accompanying typelib file (Gtk-3.0.typelib) and dynamically provides a Python interface based on that information.
Who Is Using PyGObject?
Anaconda - an installation program used by Fedora, RHEL and others
D-Feet - an easy to use D-Bus debugger
Gaphor - a simple modeling tool
Girens - a Plex client for playing movies, TV shows and music from your Plex library
GNOME Music - a music player for GNOME
GNOME Tweak Tool - a tool to customize advanced GNOME 3 options
Gramps - a genealogy program
Lollypop - a modern music player
Meld - a visual diff and merge tool
MyPaint - a nimble, distraction-free, and easy tool for digital painters
Nicotine+ - a graphical client for the Soulseek file sharing network
Orca - a flexible and extensible screen reader
Pithos - a Pandora Radio client
Pitivi - a free and open source video editor
Quod Libet - a music library manager / player
Terminator - The Robot Future of Terminals
Transmageddon - a video transcoder
The following applications or libraries use PyGObject for optional features, such as plugins or as optional backends:
beets - a music library manager and MusicBrainz tagger
gedit- a GNOME text editor
matplotlib - a python 2D plotting library
Totem - a video player for GNOME