Setup your development environment

To develop on Weboob, you have to setup a development environment.

Git installation

Clone a git repository with this command:

$ git clone

We don’t want to install Weboob on the whole system, so we create local directories where we will put symbolic links to sources:

$ mkdir ~/bin/
$ export PATH=$PATH:$HOME/bin/
$ mkdir ~/python/

All executables in ~/bin/ will be accessible in console, and all python modules in ~/python/ will be loadable. Add symbolic links:

$ ln -s $HOME/src/weboob/weboob ~/python/
$ find $HOME/src/weboob/scripts -type f -exec ln -s \{\} ~/bin/ \;

Repositories setup

As you may know, Weboob installs modules from remote repositories. As you probably want to use modules in sources instead of stable ones, because you will change them, or create a new one, you have to add this line at end of ~/.config/weboob/sources.list:


Then, run this command:

$ weboob-config update

Run Weboob without installation

This does not actually install anything, but lets you run Weboob from the source code, while also using the modules from that source:


For example, instead of running videoob -b youtube search plop, you would run:

$ ./tools/ videoob -b youtube search plop


You can now edit sources, create a module or an application.

Table Of Contents

Previous topic


Next topic

How to contribute