Installation
Prev | Chapter 1. Introduction to wxGlade | Next

## Installation

wxGlade is available in 4 different package types:

- the sources packages (`.zip` and `.tar.gz`)

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

- the installer of the standalone edition at Microsoft Windows (`wxGlade-SAE-VERSION-setup.exe`)

- development version fetched with Mercurial or downloaded the current packaged development version from https://bitbucket.org

### Installing at 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 at Unix/Linux

The current Linux distributions provide wxGlade packages. 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 contain a proper package.

### 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 the downloaded package into a separate directory e.g. a subdirectory below user's home directory. Change in this directory and execute the wxglade file on Unix/Linux or wxglade.pyw on Microsoft Windows.

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 file\wxglade on Microsoft Windows or into /opt/wxglade on Unix/Linux.

#### 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
    [...]

Prev | Up | Next
Download | Home | Chapter 2. Exploring wxGlade