Awesome Open Source
Awesome Open Source

Vala Language Server

This is a language server for the Vala programming language.


We recommend using VSCode with the Vala plugin.

  • Arch Linux (via AUR): yay -S vala-language-server or yay -S vala-language-server-git

  • Ubuntu, Fedora, Debian, openSUSE, and Mageia: install from the OBS repo

  • elementaryOS: sudo apt install vala-language-server

  • Alpine Linux: apk add vala-language-server

  • Guix: guix install vala-language-server

Packaging status

VLS with VSCode VLS with Vim with coc.nvim and vista plugins VLS with GNOME Builder

Table of Contents


  • [x] diagnostics
  • [x] code completion
    • [x] member access and scope-visible completion
    • [x] context-sensitive suggestions
      • completions for abstract methods/properties to implement
  • [x] symbol outline
  • [x] goto definition
  • [x] symbol references
  • [x] goto implementation
  • [x] signature help
  • [x] hover
  • [x] symbol documentation
    • [x] from comments in source code
    • [x] from GIR and VAPI files
  • [x] search for symbols in workspace
  • [x] highlight active symbol in document
  • [x] rename
  • [x] snippets
    • for implementing abstract methods/properties
  • [x] code lenses
  • [x] code actions / quick fixes
  • [x] code formatting
  • [x] call hierarchy
  • [x] inlay hints
  • [ ] workspaces
  • [ ] supported projects
    • [x] meson
    • [x] compile_commands.json
    • [x] Vala script (file beginning with #!/usr/bin/env -S vala shebang)
    • [ ] cmake
    • [ ] autotools


  • glib-2.0
  • gobject-2.0
  • gio-2.0 and either gio-unix-2.0 or gio-windows-2.0
  • gee-0.8
  • json-glib-1.0
  • jsonrpc-glib-1.0 >= 3.28
  • libvala >= 0.48.12
  • you also need the posix VAPI, which should come preinstalled

Uncrustify is required for formatting.

Install dependencies with Guix

If you're using Guix, to launch a shell with build dependencies satisfied:

guix environment vala-language-server

Building from Source

meson -Dprefix=/usr build
ninja -C build
sudo ninja -C build install

This will install vala-language-server to /usr/bin


An important note: VLS cannot know what arguments are used for the file you are editing unless it can locate a build script, compile commands list, or shebang to analyze. (This is generally true for most language servers of compiled languages.) Before making an issue, check whether you have a build script or shebang for your file.

vim and neovim


  1. Make sure coc.nvim is installed.
  2. After successful installation, in Vim run :CocConfig and add a new entry for VLS to the languageserver property like below:
    "languageserver": {
        "vala": {
            "command": "vala-language-server",
            "filetypes": ["vala", "genie"]


  1. Make sure vim-lsp is installed
  2. Add the following to your .vimrc:
if executable('vala-language-server')
  au User lsp_setup call lsp#register_server({
        \ 'name': 'vala-language-server',
        \ 'cmd': {server_info->[&shell, &shellcmdflag, 'vala-language-server']},
        \ 'whitelist': ['vala', 'genie'],
        \ })


Visual Studio Code

GNOME Builder

  • requires GNOME Builder >= 3.35
  • Running ninja -C build install should install the third-party plugin to $PREFIX/lib/gnome-builder/plugins. Enable Vala and disable GNOME Vala Language Server.


  • officially supported in Kate git master


Sublime Text

  • Install the Vala-TMBundle and LSP packages
  • Add this to your LSP.sublime-settings:
    "clients": {
        "vala-language-server": {
            "command": [
            "selector": "source.vala | source.genie",
            "enabled": true
  • Run Tools > LSP > Enable Language Server Globally... > vala-language-server


Want to help out? Here are some helpful resources:

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Vim (18,656
Vscode (9,994
Neovim (4,015
Vala (1,209
Language Server (584
Coc (142
Genie (61