--- Orginal Fatalsaint tutorial 2 Mikec calculator attila about pyqt install Fatalsaint more fatalsaint about IDE


[edit] Qt Designer/Python for Windows XP in 30 Mins

This is guide for noobs who would like to get started in Qt development using Python on Windows XP. The great news about using Python is there is no need to install the Maemo SDK. Python runs on Windows, MAC and Linux as is, and it's just a matter of copying your Python Scripts to your N900 and run.

[edit] Install the Tools

  • Get the Binary Packages for PyQt from Riverbank computing
    Select the Python 2.6 version which is the latest version compatible with Python on the N900. This will install a number of tools, but in particular the ones we are interested in for this Tutorial.
  • PyQt 4.7 The Python Qt bindings (note 4.7 is not the Qt Release version).
  • Qt4 Designer , the GUI editor and layout manager for Qt GUIs.
  • PyUIC4 , Converts your Qt Designer files to PyQt.

When you have this package installed you will have an entry in your start menu like this


Let's do a quick hello world that uses the above tools and links it all together.

[edit] Create UI with Qt Designer

On Your Desktop machine

  • Qt Designer from your start Menu.
  • Create a Main Window Form and set its size to 800x400
  • Add a Label Widget, set the font to a 24 point, resize as needed.
  • Double click on the Label Widget to change its name to Hello World ! Use Control R to see how it will look.
  • Add buttons text and other widgets as you want by drag and drop from the widget menu.
  • Now save your form. File->Save As helloworld.ui

[edit] Generate your Python code

Open a command window from your start menu->accessories (also winkey+r type cmd) and cd into the directory where you stored the ui file, and type in the following.

pyuic4 -x helloworld.ui -o

the -x generates additional code to allow you to test the ui element the -o tells it where to store the python "executable".

You now have a full python Qt4 GUI application ready to rock!!

Just double Click your file in the file manager and presto you have your first PtQt app up and running.

[edit] Deploy to your N900

Make sure you have installed Python and PyQt on your n900. Easiest way of doing this is to install the PyQt examples and documentation package from the application manager. This will pull in all the dependencies that you will need. Don't forget you will need to enable extras development repository.

To get full file system access follow guide Here. ( this method uses WinSCP to do a secure copy to N900)

After setting up your N900 and Windows run WinSCp and enter your ip address and root login details.

To query your N900's ip address run in terminal (sudo gainroot command comes with package rootsh):

$ sudo gainroot
  #  ifconfig | grep inet

You will get a GUI to SCP like this. make sure that you drop files to the /opt directory on your N900

[[Image: ]]

  • Drag and drop files from your desktop to your N900.
  • Copy your file to your N900 /home/opt directory

Once your file is on your opt directory on your n900 you can execute it from the Xterm: (run as user)

$ python


If your helloworld does not have the look and feel of Fremantle make sure that you have installed latest PyQt from the application manager (Thanks Atilla)

[edit] Connecting UI to your Application

OK now that you have done your first prog, you will want to create an app that actually does something with the UI. Jump to Fatalsaints post in this thread for your next tutorial

[edit] Integrating into a Main Program

The above technique will allow you to prototype quickly and let you play with the QT Designer. However you should not edit the python file generated by pyuic4 (why not?). To build a real application you want to create a programme that has your gui generated file included. First generate the file without the -x option in windows command window.

pyuic4 helloworld.ui -o

Now we create a program that calls the generated file.

Sample (may not work depending what you called your form)
 #!/usr/bin/env python
 import sys

 #Now we include our generated from pyuic4.
 from helloworld import *

 # We instantiate a QApplication passing the arguments of the script to it:
 app = QtGui.QApplication(sys.argv)
 MainWindow = QtGui.QMainWindow()
 ui = Ui_MainWindow()

 # Now we can start it.


Now just run the from your n900


Using PySide

Pyside is not quit ready for Windows yet (confusing what is this?)

Bringing it all together into a Graphical IDE

Now you have your helloworld working it's time to dive into a full-blown IDE(Integrated development environment) (Wiki) and do a serious example.

First we need to install an IDE that will pull all of our tools together. Eric4 works really well with Qt Designer. Install from here

Using eric4 build your own browser in an Hour!! Heres the tutorial

Additional Resources

some other tutorials I found helpful

And the Qt4 Design manual

The Maemo Python Wiki Pages