Installation

wxGlade is available in four different package types:

  1. the sources packages (.zip and .tar.gz)

  2. the full installer at Microsoft Windows (wxGlade-VERSION-setup.exe)

  3. the installer of the Standalone Edition at Microsoft Windows (wxGlade-SAE-VERSION-setup.exe)

  4. current development version

Download

Official Release Packages

All stable version are available for downloading at http://sourceforge.net/projects/wxglade.

Development Versions

wxGlade manages source code in a Mercurial repository hosted on Bitbucket.org. You can fetch the whole repository from https://bitbucket.org/agriggio/wxglade using anonymous Mercurial (hg) access.

Alternatively you can download different source tarballs from https://bitbucket.org/agriggio/wxglade/downloads, too.

Installing on Microsoft Windows

The default installer requires a local installation Python and wxPython. The wxWidgets are bundled with wxPython on Microsoft Windows. Thereby you don't need to install wxWidgets separately.

There is no need to install additional packages for the standalone edition, because the standalone edition includes the required parts of Python, wxPython and wxWidgets.

The installation process is quite simple. Just download the installer file, execute it and follow the installer instructions.

Installing on Unix/Unix-like Operating Systems

Current Linux distributions provide wxGlade packages already. Use the distribution specific install mechanism to install the wxGlade package and all dependencies.

You may install wxGlade from the source package if your distribution doesn't provide any package or the package is out-of-date.

Installing from Source

The installation from scratch requires Python, wxPython and wxWidgets. Those three components have to be installed first. Maybe you could use already packaged versions of those components for your operating system. Otherwise read the installation documentation of the missing components and follow the instructions.

There are two ways for installing wxGlade from source - single or multi user installation.

Download a source package or a development package in a first step.

Single User Installation

The Single User Installation is a simplified installation without using native package like .msi and .exe files on Microsoft Windows or .rpm, .pkg and .deb on Linux. It's to provide a simple way for running wxGlade without the need of installation privileges.

The dependencies listed at the section called “Requirements and Supported Platforms” have been satisfied.

The source packages and the development packages have the same structure. They have a top level directory and all wxGlade files are under those top level directory. Extract the package into the user's home directory. Take care that the directory structure of the archive will be preserved. Rename the top level directory to wxGlade. That's shorter and simpler to use.

Change into the new created directory. Execute the wxglade file on Unix operating systems or wxglade.pyw on Microsoft Windows to start wxGlade. Feel free to create a shortcut on your desktop.

That's all. Installations below users home directory don't require administrative permissions.

Multi User Installation - Variant 1

The first variant of a multi user installation is very similar to the section called “Single User Installation” except the installation directory. And probably you need administrative permissions. You could extract the wxGlade source package e.g. into c:\Program Files\wxglade on Microsoft Windows or into /opt/wxglade on Unix.

Multi User Installation - Variant 2

Extract the downloaded package into a temporary directory. Change in this directory and execute the Python setup script using python setup.py in a terminal window.

Example 1.1. Installing wxGlade at /opt/wxglade

# python setup.py install --prefix /opt/wxglade
running install
running build
running build_py
creating build
creating build/lib.linux-i686-2.7
creating build/lib.linux-i686-2.7/wxglade
creating build/lib.linux-i686-2.7/wxglade/widgets
creating build/lib.linux-i686-2.7/wxglade/widgets/combo_box
[...]
copying docs/html/ch04s23.html -> /opt/wxglade/share/doc/wxglade/doc/html
copying docs/html/ch04s26.html -> /opt/wxglade/share/doc/wxglade/doc/html
copying docs/html/ch05s02.html -> /opt/wxglade/share/doc/wxglade/doc/html
copying docs/html/pr01.html -> /opt/wxglade/share/doc/wxglade/doc/html
creating /opt/wxglade/share/doc/wxglade/doc/pdf
copying docs/pdf/manual.pdf -> /opt/wxglade/share/doc/wxglade/doc/pdf
creating /opt/share/man
creating /opt/share/man/man1
copying docs/man/wxglade.1 -> /opt/wxglade/share/man/man1
copying docs/man/manpage.xml -> /opt/wxglade/share/doc/wxglade
copying docs/src/manual.xml -> /opt/wxglade/share/doc/wxglade
running install_egg_info
Writing /opt/wxglade/lib/python2.7/site-packages/wxGlade-0.6.5_-py2.7.egg-info

After the installation has finished the wxGlade main script wxglade is located at <install directory>/bin.

Execute the script to start wxGlade

Example 1.2. Starting wxGlade at /opt/wxglade/bin/wxglade

# /opt/wxglade/bin/wxglade 
Starting wxGlade version 0.6.5 on Python 2.7.2+
Base directory:             /opt/wxglade/lib/python2.7/site-packages/wxglade
Documentation directory:    /opt/wxglade/lib/python2.7/site-packages/wxglade/docs
Icons directory:            /opt/wxglade/lib/python2.7/site-packages/wxglade/icons
Build-in widgets directory: /opt/wxglade/lib/python2.7/site-packages/wxglade/widgets
Template directory:         /opt/wxglade/lib/python2.7/site-packages/wxglade/templates
Credits file:               /opt/wxglade/share/doc/wxglade/credits.txt
License file:               /opt/wxglade/share/doc/wxglade/license.txt
Tutorial file:              /opt/wxglade/lib/python2.7/site-packages/wxglade/docs/html/index.html
Using wxPython 2.8.12.1
loaded code generator for perl
loaded code generator for XRC
loaded code generator for python
loaded code generator for lisp
loaded code generator for C++
Found widgets listing -> /opt/wxglade/lib/python2.7/site-packages/wxglade/widgets/widgets.txt
loading widget modules:
        frame
        dialog
[...]

Troubleshooting

This section should help you to solve some non-application issues.

wxGlade has started e.g. by clicking the desktop icon with mouse, but no application window opens

Check the log file for errors (see the section called “Configuration Files”) and check that all dependencies (especially wxWidgets and Python) are installed. A list of dependencies is in the section called “Requirements and Supported Platforms”.

If you think this is an application issue, file a bug report like described in the section called “How to Report a Bug”, please.