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.

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.

On Unix systems wxGlade will be started using the shell script wxglade. The script search the system for Python 2 and finally executes the Python interpreter to start wxGlade.

You can set the environment variable PYTHON_BIN, if the shell script wxglade doesn't find Python or if you want to use a non-default interpreter.

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 (Extract and Run)

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 (Extract and Run)” 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. Execute the wxglade file on Unix operating systems or wxglade.pyw on Microsoft Windows to start wxGlade.

Figure 1.2. Starting wxGlade on Windows at C:\Program Files\wxGlade

Starting wxGlade on Windows at C:\Program Files\wxGlade

Multi User Installation - Variant 2

Note

This installation method is only supported Unix operating systems.

Extract the downloaded package into a temporary directory. Open a terminal window, change into the temporary directory and install wxGlade using execute the Python setup script setup.py as follow:

python2 setup.py install --root <DESTINATION DIRECTORY>

Note

Parameters shown in angle brackets (e.g., <parameter>) are required.

Parameters shown in square brackets (e.g., [parameter]) are optional. If not given, wxGlade will use suitable defaults.

Example 1.1. Installing wxGlade at /opt/wxglade

# python2 setup.py install --root /opt/wxGlade
running install
running build
running build_py
running build_scripts
running install_lib
creating /opt/wxGlade
creating /opt/wxGlade/usr
creating /opt/wxGlade/usr/lib
creating /opt/wxGlade/usr/lib/python2.7
[...]
writing manifest file 'wxGlade.egg-info/SOURCES.txt'
Copying wxGlade.egg-info to /opt/wxGlade/usr/lib/python2.7/site-packages/wxGlade-0.7.1rc1-py2.7.egg-info
running install_scripts
creating /opt/wxGlade/usr/bin
copying build/scripts-2.7/wxglade -> /opt/wxGlade/usr/bin
changing mode of /opt/wxGlade/usr/bin/wxglade to 755

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

Execute the script <install directory>/usr/bin/wxglade to start wxGlade

Figure 1.3. Starting wxGlade on Windows at /opt/wxglade/bin/wxglade

Starting wxGlade on Windows at /opt/wxglade/bin/wxglade