Version 1 (modified by chriz, 9 years ago) (diff)

Migrated from old trac wiki

WikidPad on Linux

Generally, Wikidpad runs well under Linux, although there are a few IssuesUnderLinux. It helps if you are reasonably adept at Linux administration and Python, but you can follow the basic instructions below and have a working installation.

The main python file depends on the two packages gadfly and pwiki in the lib directory. There are two ways to get give access to these packages.

  • easy - make the lib path available to the python interpreter
  • intermediate - install the libraries into the system directories

Note: some experimental DEBs are available for Ubuntu

Running WikidPad in Linux using Python

Make lib path available

Add the lib path to the PYTHONPATH variable to make it available to the python interpreter. This can be done with a simple command like export:

export PYTHONPATH=$PYTHONPATH:lib/ After that you can run from its directory simply as: python

Install into the system directories

  • Go to the lib directory.
  • Copy the directories gadfly and pwiki to the python site-packages path. This path is under your python lib path for example in /usr/lib/python2.4/lib/site-packages
  • create a <dir>.pth path file for both gadfly and pwiki in <python library path>/site packages. Again this is relative to the python lib path as above.

After that you can again run from its directory.

Potential problems

  • Depending on the version of wxPython you are using, you might get errors related to unicode.
  • You'll need to install wxpython 2.4 (in Debian or Ubuntu : apt-get install libwxgtk2.4-python(replaced by python-libgtk2.4-python and python-wxtools on ubuntu dapper)) if you get the error referenced above, which is:

Error starting wikidPad. 'ascii' codec can't decode byte 0xf6 in position 1569: ordinal not in range(128).

  • Another thing you can do to fix Unicode issues is to edit or create the in your Python site-packages directory, and add (but not indented!):

import sys sys.setdefaultencoding('iso-8859-1') # or something else for your language's character set

  • You may find that once you get it working, you are unable to type anything in the panel. Make sure your permissions on the WikidPad file are correct.
  • I run 64-bit Debian GNU/Linux and have somewhat of a mongrel system (the Debian 64-bit ditribution recently switched from Unstable to Stable), but I found that wxPython 2.6 (and libwxgtk2) eliminated the very high CPU utilization that lesser versions seemed to cause. Also, the greitmayr branch in SVN is friendlier to more recent wxPython versions. Still wants to uses a Windowish function to start the Help wiki (sigh) (no longer true, help now works fine on Linux - I tried 1.8 beta).
  • If you have or install your distribution's Gadfly package, you may also get the compiled kjbuckets; copy Wikidpad's into the gadfly directory (will this break other uses of Gadfly???)
  • Once you save your Wikis in Linux, I've had difficulty opening them in Windows once sending them back. I'll be running some tests to see if its a quick fix and will repost. << This should be made much more explicit up front. It could be quite a problem for some people!
  • The interface in Linux can be distorted (very large toolbar fonts) Has anyone figured out how to adjust this?
  • You may find that WikidPad is unable to find SQLite. To ensure you're able to use SQite first make sure you have the python ctypes package installed. (By the way, ctypes is now included part of Python 2.5, so if you have an up to date distribution, you are likely to already have it). Second, you may need to tweak lines 95-6 of /lib/pwiki/ so that WikidPad can find the Sqlite3 Library. On Ubuntu, I had to replace "" with ""
  • If your window manager is set to always activate the window which is under the mouse pointer, you may have problems with the incremental search. For FVWM, add a line in the configuration file:
    Style "WikidPad i-search" NoTitle, FPGrabFocus

Log of experiences, should be merged with the above


hi guys - I've just recently switched my laptop across to Ubuntu (my first permanent Linux install after many many years of Windows) and was pleasantly surprised to have no troubles getting WikidPad up and running using the downloaded source (although I'm not sure I have sqlite wikis working yet... ) are those linux installation instructions accurate? adding the lib directory to the python path appears to be unnecessary provided you chdir to the wikidpad source directory before running "python".

The only addition from the standard ubuntu installation was the python-wxgt2.8 package: sudo apt-get install python-wxgtk2.8 also, wouldn't it be better to advise people to copy the source files to /usr/lib instead of /usr/share since the latter isn't supposed to contain code/executables, and to create a small bash script in /usr/ bin to chdir then run the python command, something like:

#!/bin/sh chdir /usr/lib/WikidPad python

(might need to chmod the file to make sure it is executable by all users). Using this I was able to setup a nice WikidPad runner (using the standard WikidPad icon) on my gnome task panel that calls the wikidpad script.

Couple of other things:

  • I'm running Ubuntu and didn't encounter the issues listed at: - how old is that stuff?

  • it would be nice if the WikidPad.config and WikidPad_error.log were

put in a hidden .WikidPad directory under the users home directory 20071025 - I found I needed to use wx version 2.6 rather than version 2.4 as suggested above.

Running WikidPad on Linux using Wine

I was able to get WikidPad running in Wine, after a quick trip to the irc channel #winehq on, here are my steps:

  • Install Wine (I was using Ubuntu so it was as easy as apt-get install wine)
  • Copy the msvcrt.dll from your Windows/system32 directory to /root/.wine/drive_c/windows/system/
  • Type winecfg at the terminal (as root) and under the Libraries tab, add msvcrt.dll
  • Run the installer and it *should* work.
  • This fixes the error with the toolbar fonts as described above, and also shows that error regarding saving WikidPad wikis between Linux and Windows partitions (error connecting to database in 'Z:\home\endura\TestWiki?\data'. bad marshal data. This has to do with the difference of Unix and Windows carriage returns. Update: You won't have the last problem if you are running WikidPad 1.20beta or above. '

Running WikiPad on Linux using CrossOver?

I have run the installer under Cross Over and it works like a charm.

WikidPad on Fedora 7 (Dec. 2007)

Fortunately it was very easy to get WikidPad running under Fedora. I had to additionally install

  • wxGTK-gl-2.8.7-2.fc7
  • wxPython-

Then I unzipped the WikidPad source file into an empty directory (e.g. /home/my_name/sw/WikidPad). For easy execution I created the following script file, made it executable and stored it somewhere in the path:

cd $HOME/sw/WikidPad

Note: That way it's for my user's usage only, since it's in my home directory.

WikidPad as portable application

I used Wididpad 1.9beta for Windows and now changed to Ubuntu Hardy. I had a portable application installed on my usb and I just copied it into Ubuntu and it works fine. January 2009