geany-lsp

This is the development repository of the LSP plugin for Geany.

Main development of the plugin happens in this repository so please report bugs here. In addition, the plugin code will be uploaded to the geany-plugins before every release so if you are interested in the release version only, you can get it from there.

Features

The plugin provides the following LSP features:

• Autocompletion
• Function signagure
• Diagnostic messages
• Code lenses
• Semantic token type highlighting
• Hover popup
• Go to symbol definition/declaration
• Go to type definition
• Swap header/source
• Find references
• Find implementations
• Navigation to document/project symbols, files, and line numbers
• Code formatting
• Identical symbol highlighting
• Document symbol renaming
• Project-wide renaming

Limitations

The plugin API of Geany currently does not support modifying document symbols in the sidebar so the Symbols tab contents is based on Geany's ctags symbols instead of LSP symbols.

The plugin currently only works over stdin/stdout and takes over the responsibility for starting and stopping LSP servers. Some LSP servers, such as Godot, have to run all the time because they provide other functionality and have to be connected using sockets - this is not supported by the server at the moment.

Building

For building the plugin, you need to compile and install the latest Geany version (2.1) from git master. Then, you can build and install the LSP plugin using either

./autogen.sh && make && sudo make install

or

meson setup build && cd build && ninja && sudo ninja install

Quick Start

1. Install the LSP server you want to use.
2. Enable the LSP Client plugin under Tools->Plugin Manager.
3. Check the configuration file under Tools->LSP Client->User Configuration and make sure the LSP server is configured correctly, following the documentation of the LSP server you wish to use.
4. Create a Geany project and set its base path to the root directory of your sources.
5. Enable the LSP plugin for the project under Project->Properties->LSP Client.

Documentation

More information about the supported features and configuration can be found in

• the plugin documentation
• the configuration file

Jiri Techet, 2024