To get things started we will try to run a very simple GTK based GUI application using the PyGObject providedPython bindings. First create a small Python script called hello.py withthe following content and save it somewhere:
Before we can run the example application we need to install PyGObject, GTKand their dependencies. Follow the instructions for your platform below.
| Ubuntu | Fedora | Arch Linux |
| Windows | macOS | openSUSE |
After running the example application have a look at the “Python GTK 3Tutorial” for more exampleson how to create GTK apps and the “PyGObject API Reference” for API documentation for all supportedlibraries.
Windows¶
All macOS and iOS releases appearances from System 4 to macOS Catalina.
- Go to http://www.msys2.org/ and download the x86_64 installer
- Follow the instructions on the page for setting up the basic environment
- Run
C:msys64mingw64.exe- a terminal window should pop up - Execute
pacman-Suy - Execute
pacman-Smingw-w64-x86_64-gtk3mingw-w64-x86_64-python3mingw-w64-x86_64-python3-gobject - To test that GTK 3 is working you can run
gtk3-demo - Copy the
hello.pyscript you created toC:msys64home<username> - In the mingw32 terminal execute
python3hello.py- a window should appear.
Ubuntu / Debian¶
- Execute sudo apt install libgirepository1.0-dev gcc libcairo2-dev pkg-config python3-dev gir1.2-gtk-3.0 to install the build dependencies and GTK; Execute pip3 install pycairo to build and install Pycairo; Execute pip3 install PyGObject to build and install PyGObject; Change the working directory to where your hello.py script can be found; Run.
- # How to deploy GTK based app on Mac OS X? Many friends ask me to provide the official installer package(.dmg) for Mac OS X, I do want to implement it. But there is a big stone on the way, because I don't have physical machine and landed OS X just a short time, have many dark hole on it. Face it, solve it, things will be done, I.
- Open a terminal
- Execute
sudoaptinstallpython3-gipython3-gi-cairogir1.2-gtk-3.0 - Change the directory to where your
hello.pyscript can be found (e.g.cdDesktop) - Run
python3hello.py
- Open a terminal and enter your virtual environment
- Execute
sudoaptinstalllibgirepository1.0-devgcclibcairo2-devpkg-configpython3-devgir1.2-gtk-3.0to install the build dependencies and GTK - Execute
pip3installpycairoto build and install Pycairo - Execute
pip3installPyGObjectto build and install PyGObject - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
Fedora¶
- Open a terminal
- Execute
sudodnfinstallpython3-gobjectgtk3 - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
- Open a terminal and enter your virtual environment
- Execute
sudodnfinstallgccgobject-introspection-develcairo-develpkg-configpython3-develgtk3to install the build dependencies and GTK - Execute
pip3installpycairoto build and install Pycairo - Execute
pip3installPyGObjectto build and install PyGObject - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
Arch Linux¶
- Open a terminal
- Execute
sudopacman-Spython-gobjectgtk3 - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
Install Gtk For Mac
- Open a terminal and enter your virtual environment
- Execute
sudopacman-Spythoncairopkgconfgobject-introspectiongtk3to install the build dependencies and GTK - Execute
pip3installpycairoto build and install Pycairo - Execute
pip3installPyGObjectto build and install PyGObject - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
openSUSE¶
Install Gtk On Mac
- Open a terminal
- Execute
sudozypperinstallpython3-gobjectpython3-gobject-Gdktypelib-1_0-Gtk-3_0libgtk-3-0 - Change the directory to where your
hello.pyscript can be found - Run
python3hello.py
- Open a terminal and enter your virtual environment
- Execute
sudozypperinstallcairo-develpkg-configpython3-develgccgobject-introspection-develto install the build dependencies and GTK - Execute
pip3installpycairoto build and install Pycairo - Execute
pip3installPyGObjectto build and install PyGObject - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
macOS¶
- Go to https://brew.sh/ and install homebrew
- Open a terminal
- Execute
brewinstallpygobject3gtk+3 - Change the working directory to where your
hello.pyscript can be found - Run
python3hello.py
Install Gtk For Mac Mojave
For more details on how to use a virtualenv with PyGObject, see the“Creating a Development Environment” page.
