{"id":13441818,"url":"https://github.com/vala-lang/vala-language-server","last_synced_at":"2026-04-02T05:40:39.752Z","repository":{"id":37026046,"uuid":"97665091","full_name":"vala-lang/vala-language-server","owner":"vala-lang","description":"Code Intelligence for Vala \u0026 Genie","archived":false,"fork":false,"pushed_at":"2024-06-24T04:12:13.000Z","size":18588,"stargazers_count":302,"open_issues_count":68,"forks_count":44,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-28T14:04:41.582Z","etag":null,"topics":["coc","genie","gnome","language-server","neovim","vala","vim","vls","vscode"],"latest_commit_sha":null,"homepage":"","language":"Vala","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vala-lang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"Prince781"}},"created_at":"2017-07-19T02:41:27.000Z","updated_at":"2025-03-15T09:12:09.000Z","dependencies_parsed_at":"2024-01-22T12:40:52.466Z","dependency_job_id":"76073260-4cd8-4b29-a9f7-3f275680062c","html_url":"https://github.com/vala-lang/vala-language-server","commit_stats":{"total_commits":609,"total_committers":30,"mean_commits":20.3,"dds":"0.26929392446633826","last_synced_commit":"31cb5116a4a138365feb709ebb7b8670db604991"},"previous_names":["benwaffle/vala-language-server","prince781/vala-language-server"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vala-lang%2Fvala-language-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vala-lang%2Fvala-language-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vala-lang%2Fvala-language-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vala-lang%2Fvala-language-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vala-lang","download_url":"https://codeload.github.com/vala-lang/vala-language-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198439,"owners_count":20900079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coc","genie","gnome","language-server","neovim","vala","vim","vls","vscode"],"created_at":"2024-07-31T03:01:38.405Z","updated_at":"2026-04-02T05:40:39.722Z","avatar_url":"https://github.com/vala-lang.png","language":"Vala","funding_links":["https://github.com/sponsors/Prince781"],"categories":["HarmonyOS","Language Servers"],"sub_categories":["Windows Manager","Weather"],"readme":"# Vala Language Server\n\nThis is a language server for the [Vala programming language](https://vala-project.org).\n\n## Installation\n\nWe recommend using VSCode with the [Vala plugin](https://marketplace.visualstudio.com/items?itemName=prince781.vala).\n\n- Arch Linux (via AUR): `yay -S vala-language-server`\n  or `yay -S vala-language-server-git`\n\n- Ubuntu, Fedora, Debian, openSUSE, and Mageia: install from [the OBS repo](https://software.opensuse.org//download.html?project=home%3APrince781\u0026package=vala-language-server) [![build result](https://build.opensuse.org/projects/home:Prince781/packages/vala-language-server/badge.svg?type=percent)](https://build.opensuse.org/package/show/home:Prince781/vala-language-server)\n\n- Fedora (official): `sudo dnf install vala-language-server`\n\n- elementaryOS: `sudo apt install vala-language-server`\n\n- Alpine Linux: `apk add vala-language-server`\n\n- Guix: `guix install vala-language-server`\n\n- Void Linux: `xbps-install vala-language-server`\n\n- Windows (via MSYS2): `pacman -S mingw-w64-x86_64-vala-language-server`\n\n...and more. See below:\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/vala-language-server.svg)](https://repology.org/project/vala-language-server/versions)\n\n![VLS with VSCode](images/vls-vscode.png)\n![VLS with Vim with coc.nvim and vista plugins](images/vls-vim.png)\n![VLS with GNOME Builder](images/vls-gb.png)\n\n## Table of Contents\n- [Vala Language Server](#vala-language-server)\n  - [Table of Contents](#table-of-contents)\n  - [Features](#features)\n  - [Dependencies](#dependencies)\n  - [Building from Source](#building-from-source)\n  - [Editors](#editors)\n    - [Vim and Neovim](#vim-and-neovim)\n    - [Visual Studio Code](#visual-studio-code)\n    - [GNOME Builder](#gnome-builder)\n    - [Kate](#kate)\n    - [Emacs](#emacs)\n    - [Sublime Text](#sublime-text)\n  - [Contributing](#contributing)\n\n## Features\n- [x] diagnostics\n- [x] code completion\n    - [x] member access and scope-visible completion\n    - [x] context-sensitive suggestions\n        - completions for abstract methods/properties to implement\n- [x] symbol outline\n- [x] goto definition\n- [x] symbol references\n- [x] goto implementation\n- [x] signature help\n- [x] hover\n- [x] symbol documentation\n    - [x] from comments in source code\n    - [x] from GIR and VAPI files\n- [x] search for symbols in workspace\n- [x] highlight active symbol in document\n- [x] rename\n- [x] snippets\n    - for implementing abstract methods/properties\n- [x] code lenses\n- [x] code actions / quick fixes\n- [x] code formatting\n- [x] call hierarchy\n- [x] inlay hints\n- [ ] workspaces\n- [ ] supported projects\n    - [x] meson\n    - [x] `compile_commands.json`\n    - [x] Vala script (file beginning with `#!/usr/bin/env -S vala` shebang)\n    - [ ] cmake\n    - [ ] autotools\n\n## Dependencies\n- `glib-2.0`\n- `gobject-2.0`\n- `gio-2.0` and either `gio-unix-2.0` or `gio-windows-2.0`\n- `gee-0.8`\n- `json-glib-1.0`\n- `jsonrpc-glib-1.0 \u003e= 3.28`\n- `libvala \u003e= 0.48.12`\n- you also need the `posix` VAPI, which should come preinstalled\n- [uncrustify](http://uncrustify.sourceforge.net/), for formatting (optional)\n\n#### Install dependencies with Guix\n\nIf you're using Guix, to launch a shell with build dependencies satisfied:\n```sh\nguix environment vala-language-server\n```\n\n## Building from Source\n```sh\nmeson -Dprefix=/usr build\nninja -C build\nsudo ninja -C build install\n```\n\nThis will install `vala-language-server` to `/usr/bin`\n\n## Editors\n\n**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.\n\n### vim and neovim\n\n#### coc.nvim\n1. Make sure [coc.nvim](https://github.com/neoclide/coc.nvim) is installed.\n2. After successful installation, in Vim run `:CocConfig` and add a new entry\n   for VLS to the `languageserver` property like below:\n\n```json\n{\n    \"languageserver\": {\n        \"vala\": {\n            \"command\": \"vala-language-server\",\n            \"filetypes\": [\"vala\", \"genie\"]\n        }\n    }\n}\n```\n\n#### vim-lsp\n1. Make sure [vim-lsp](https://github.com/prabirshrestha/vim-lsp) is installed\n2. Add the following to your `.vimrc`:\n\n```vim\nif executable('vala-language-server')\n  au User lsp_setup call lsp#register_server({\n        \\ 'name': 'vala-language-server',\n        \\ 'cmd': {server_info-\u003e[\u0026shell, \u0026shellcmdflag, 'vala-language-server']},\n        \\ 'whitelist': ['vala', 'genie'],\n        \\ })\nendif\n```\n\n#### nvim-lspconfig\n- For Neovim 0.5.0 or higher\n- Make sure [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig) is installed\n- see [the recommended config](https://github.com/neovim/nvim-lspconfig/blob/master/doc/server_configurations.md#vala_ls) in that project\n\n```lua\nrequire'lspconfig'.vala_ls.setup {\n  -- defaults, no need to specify these\n  cmd = { \"vala-language-server\" },\n  filetypes = { \"vala\", \"genie\" },\n  root_dir = root_pattern(\"meson.build\", \".git\"),\n  single_file_support = true,\n}\n```\n\n### Visual Studio Code\n- [Official Vala plugin](https://marketplace.visualstudio.com/items?itemName=prince781.vala)\n\n### GNOME Builder\n- requires GNOME Builder \u003e= 3.35\n- 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`.\n\n### Kate\n- officially supported in Kate git master\n- **Warning:** Kate will silently fail to find symbols when meson cannot be found in path without notifying the user.\n\n### Emacs\n- supported with the [lsp-mode](https://github.com/emacs-lsp/lsp-mode) plugin\n\n### Sublime Text\n- Install the [Vala-TMBundle](https://packagecontrol.io/packages/Vala-TMBundle) and [LSP](https://github.com/sublimelsp/LSP) packages\n- Add this to your `LSP.sublime-settings`:\n```json\n{\n    \"clients\": {\n        \"vala-language-server\": {\n            \"command\": [\n                \"/usr/bin/vala-language-server\"\n            ],\n            \"selector\": \"source.vala | source.genie\",\n            \"enabled\": true\n        }\n    }\n}\n```\n- Run `Tools \u003e LSP \u003e Enable Language Server Globally... \u003e vala-language-server`\n\n## Specifying dependencies\n\nIf you're using meson, vala-language-server will automatically detect the packages you depend on.\n\nIf you just want to write a quick script without a build system, you can add a shebang line to the top of your .vala file:\n\n```c\n#!/usr/bin/env -S vala --pkg gtk4\n```\n\n## Contributing\nWant to help out? Here are some helpful resources:\n\n- [Help is wanted on these issues](https://github.com/vala-lang/vala-language-server/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22)\n- [`#vala` on gimpnet/IRC](irc://irc.gnome.org/vala) is for general discussions about Vala and collaboration with upstream\n- [Discord server](https://discord.gg/YFAzjSVHt7) is for general discussions about Vala, discussions about this project, and support\n- Gitter room is also for project discussions and support, but is less active: https://gitter.im/vala-language-server/community\n- Vala wiki: https://wiki.gnome.org/Projects/Vala/\n- libvala documentation: https://gnome.pages.gitlab.gnome.org/vala/docs/index.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvala-lang%2Fvala-language-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvala-lang%2Fvala-language-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvala-lang%2Fvala-language-server/lists"}