Tom Lee

Software development geekery.

Ginvoke

What is ginvoke?

ginvoke is a launcher for the Linux desktop built for programmers. What differentiates ginvoke from other launchers like Gnome Do, Alfred and QuickSilver is in how easy it is to extend. Custom commands can be added to the program using simple Python scripts.

The current stable release of ginvoke is written entirely in Python and PyGTK for GTK 2.x. A version for GTK 3.x is in the works.

How can I get it?

If you’re on Debian, ginvoke for GTK 2.x is directly available from my apt repository.

Debian / Ubuntu / Linux Mint

$ sudo wget -O /etc/apt/sources.list.d/tomleeco.list http://apt.tomlee.co/list
$ wget -O - http://apt.tomlee.co/gpg | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install ginvoke

Once installed, set up a keyboard shortcut for /usr/bin/ginvoke. How you go about doing this varies between desktop environments.

Refer to the README for more information on what to do once ginvoke is installed.

Others

$ pip install ginvoke

Note that you’ll need to install Python and PyGTK yourself — most likely using your system’s packaging tool.

Once installed, set up a keyboard shortcut for /usr/bin/ginvoke. How you go about doing this varies between desktop environments.

Refer to the README for more information on what to do once ginvoke is installed.

ginvoke2

The next generation of ginvoke is being written in C and takes a more Unixy approach to extensibility, serving as a quick & easy way to launch scripts and programs on your $PATH when you’re away from your terminal. Functionality can still be directly extended via Python scripts, but otherwise integrates neatly with the way you already work.

Since it’s a work in progress, no packages have been published. However, if you’re on Debian it should be trivial to build your own .deb like so:

$ git clone git://github.com/thomaslee/ginvoke2
$ (cd ginvoke2 && fakeroot debian/rules binary)

You should then find a .deb package sitting in the parent directory. This can be installed using “dpkg -i ginvoke2-*.deb”.

Problems?

If you’d like help with any of this, please get in touch or raise an issue on github.

Contribute!

If you’re eager to fix bugs or you’ve got grand ideas, I’m always keen to see patches! Fork the ginvoke (or ginvoke2) repo & send me a pull request on github.