toga 0.2.5

A Python native, OS native GUI toolkit.

A Python native, OS native GUI toolkit.

Prerequisites

Toga has some minimum requirements:

• Toga requires Python 3. Python 2 is not supported.

• If you’re on macOS, you need to be on 10.7 (Lion) or newer.

• If you’re on Linux, you need to have GTK+ 3.10 or later. This is the version that ships starting with Ubuntu 14.04 and Fedora 20. You also need to install the Python 3 bindings to GTK+. If you want to use the WebView widget, you’ll also need to have WebKit, plus the GI bindings to WebKit installed. This means you’ll need to install the following:

  • Ubuntu 14.04 apt-get install python3-gi gir1.2-webkit-3.0

  • Ubuntu 16.04 apt-get install python3-gi gir1.2-webkit-4.0 or apt-get install python3-gi gir1.2-webkit-3.0

  • Debian ??

  • Fedora dnf install python3-gobject pywebkitgtk or yum install python3-gobject pywebkitgtk

If these requirements aren’t met, Toga either won’t work at all, or won’t have full functionality.

Quickstart

To get a demonstration of the capabilities of Toga, run the following:

$ pip install toga-demo
$ toga-demo

This will pop up a GUI window with some sample widgets.

Documentation

Documentation for Toga can be found on Read The Docs.

Community

Toga is part of the BeeWare suite. You can talk to the community through:

• @pybeeware on Twitter

• The pybee/general channel on Gitter.

Contributing

If you experience problems with Toga, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.