Skip to content
This repository has been archived by the owner. It is now read-only.
Geany plugin to navigate a Python codebase quicker
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Geany Python Navigation plugin

This is a plugin for Geany to make it easier to navigate a Python codebase.

Currently, its only feature is "jump to Python module". It tries to open the source file corresponding to a given Python module (dotted path).


  1. Install Geany 1.27+.
  2. Install GeanyPy. On Debian/Ubuntu, install geany-plugin-py as well as python-gtk2.
  3. Put on your Geany plugin path, e.g. in ~/.config/geany/plugins/.
  4. Open Geany's plugin manager (Tools → Plugin Manager) and enable GeanyPy and Python Navigation.
  5. Click Keybindings to set your preferred key for "Jump to Python module". (This is optional: you can also invoke it from the Tools menu.)


When you press the chosen keybinding (or invoke Tools → Jump to Python module), the plugin first tries to figure out which Python module name (dotted path) you wish to look up:

  1. if there is some selected text in the current document, then it is used;
  2. otherwise, if the cursor is on a line beginning with import X or from X, then X is used;
  3. otherwise, you are prompted to enter the dotted path manually.

Then the plugin tries to find the file corresponding to that module name. For example, if the dotted path is, the plugin looks for foo/ or foo/bar/ in a few places around the current document.

You can also configure the search path on a per-project basis. To do so, open your Geany project file (the one whose name ends in .geany) and add a section like this:


then restart Geany (reopen the project). The format is similar to that for PYTHONPATH.

You can’t perform that action at this time.