qpsycle setup pages: Getting qpsycle | Building qpsycle | Configuring sound | Building psycle plugins | Getting the latest updates | Contributing code | Troubleshooting

NOTE: these are basic instructions for setting up the svn development code for qpsycle. You'll probably encounter a lot of problems in the process :) Please add any problems you encounter and any solutions to this page to help other people.

For now, there's a few things hardcoded which means it probably won't work... have a try anyway ;)

installing external packages needed by qpsycle Edit

In order to build qpsycle you will need to get some development libaries for your system.

Linux Edit

  • Qt 4.3 (4.4 or newers is recommend due to some performance tweaks in the libs)
  • alsa, jack or esound
  • gcc g++
  • pkg-config
  • boost
  • libxml++
    • libxml2

For Fedora and redhat-based distros:

yum install gcc-c++
yum install pkg-config
yum install ....... the Qt packages ..........
yum install ..... the boost signals packages ......

then install the development files for one of the audio output libraries supported by qpsycle:

yum install alsa-tools alsa-lib alsa-utils alsa-lib-devel
yum install jack-audio-connection-kit-devel


yum install qjackctl

For debian and debian-based distros (e.g. ubuntu):

aptitude install g++
aptitude install pkg-config
aptitude install libqt4-core libqt4-gui libqt4-dev
aptitude install libboost-signals-dev

then install the development files for one or more of the audio output libraries supported by xpsycle:

aptitude install libasound-dev
aptitude install libesd-dev
aptitude install libjack0.100.0-dev 

(note libjack version number might change, try

aptitude search libjack

to find which is latest version.)

For OpenSUSE:

zypper install gcc
zypper install gcc-c++
zypper install libqt4-dev
zypper install boost-devel

then install the development files for one of the audio output libraries supported by qpsycle:

zypper install alsa-utils alsa-devel

Windows Edit

GNU gcc/mingw (recommended) Edit

Download the psycle dev-pack for ms-windows.

If you don't want to use the dev-pack you should get MinGW, Qt and GTKmm Developement Environment and set them up.

Unpack it to a destination which doesn't contain spaces in the path.

Get the Qt for mingw pre-built package from the trolltech website.

Note: Make sure to get Qt version 4.3 or above, this is required for mingw!

During the installation point Qt to the mingw location in the dev-pack to x:\path\to\psycle-dev-pack-for-mswindows\opt\mingw. You can safely ignore the warning about w32api.h not being 3.2, the dev-pack contains a higher version.

Microsoft's Visual C++ Edit

If you want to use Visual Studio you should get the Qt Source Code from Trolltech and compile it yourself by running in the Qt main dir:

configure.exe -debug_and_release

Note that if you want to compile with Visual C++ 2005 you should install Visual Studio 2005 SP1 and KB930198 then Visual C++ 2005 Express will be fuly supported by Qt Open Source Edition and by QPsycle. Visual C++ 2008 Express is not fully supported by Qt for now and it needs some tweaking in order to work with QPsycle.

See also Qpsycle/developer/notes

Mac OS X Edit

In order to proceed, you must first have the XCode tools installed from your Mac OS X installation disc. If you've lost these, you could always register/login to your free ADC account and download XCode there. XCode contains a lot of libraries, and gcc, amongst others (like distcc for distributed compiling etc..).

First you will need to get QT for macOS, this page also guides you thru installing QT. Now you need to get pkg-config, if using fink open a terminal, and type "fink install pkgconfig" or when using macports: "port install pkgconfig". Follow this same step for installing boost, and alsa or jack (remember to set your preferred driver in your configuration file later on).

You should be all set now.

building qpsycle Edit

Linux / Mac OS X Edit

go to your qpsycle folder

cd qpsycle

next type

qmake-qt4 -recursive && make

or just

qmake -recursive && make

Windows Edit

GNU gcc/mingw Edit

Make sure you have all the needed libs installed, see section above if not. Note: Make sure you have Qt version 4.3 or above, this is required for mingw!

Start a command prompt. You can use the provided link in the Qt section of your start menu, or if you have the psycle dev-pack for ms-windows, start either bash-in-rxvt-terminal.cmd or microsoft-shell-in-microsoft-terminal.cmd (the former starts a posix shell, so you will need to adapt the syntax of the following commands to posix syntax).

If you started the command prompt by using the the provided link in the Qt section of your start menu, type:

x:\path\to\psycle-dev-pack-for-mswindows\libexec\main no-msys

If you started the command prompt by using the dev-pack, type:

echo %QTDIR%

If the command does not return the dir where you the installed Qt libs, type:

set QTDIR=%ProgramFiles%\Qt
set PATH=%QTDIR%\bin;%PATH%

where %ProgramFiles%\Qt is the dir where you installed the Qt libs.

From the command prompt, if:


does not return win32-g++, then type:

set QMAKESPEC=win32-g++

Then navigate to your qpsycle source directory and type:

qmake -recursive

Microsoft's Visual C++ Edit

You have to install gtkmm devlopement enviroment in order to compile QPsycle

Navigating to your qpsycle source directory and typing:


remeber to set your QMAKESPEC enviroment variable to msvc!

set QMAKESPEC=win32-msvc2005


set QMAKESPEC=win32-msvc2008

See also Qpsycle/developer/notes


If it went fine, that means it compiled fine.

Next step is to put the configuration file in the right place, then edit it, then see if it works.

Linux / Mac OS X Edit

Copy to your home directory.

cp .xpsycle.xml ~

The config file is set up by default to use the alsa driver. To change the driver, see Qpsycle/setup/alpha/Configuring sound.

Test it and see if it works with:


Windows Edit

Copy .xpsycle.xml in your Documents And Settings folder.

cp .xpsycle.xml C:\Documents And Settings\(Your User Name)\

Currently, the audio driver will not be enabled by default so you have to open Configuration->Audio Settings in QPsycle and click on Restart Driver