Nix

The Quickshell repo has an embedded flake. You can use either of the two:

• git+https://git.outfoxxed.me/outfoxxed/quickshell
• github:quickshell-mirror/quickshell

{
  inputs = {
    nixpkgs.url = "nixpkgs/nixos-unstable";

    quickshell = {
      # add ?ref=<tag> to track a tag
      url = "git+https://git.outfoxxed.me/outfoxxed/quickshell";

      # THIS IS IMPORTANT
      # Mismatched system dependencies will lead to crashes and other issues.
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
}

The package is available as quickshell.packages.<system>.default, which can be added to your environment.systemPackages or home.packages if you use home-manager.

Arch

Quickshell is available from the aur under:

• the quickshell package for the latest release
• the quickshell-git package that tracks the master branch

Install using the command below:

yay -S quickshell
# or
yay -S quickshell-git

(or your AUR helper of choice)

Fedora

Quickshell is available from the errornointernet/quickshell COPR, as either:

• quickshell that tracks the latest release
• quickshell-git that tracks the master branch

Install using the command below:

sudo dnf copr enable errornointernet/quickshell

sudo dnf install quickshell
# or
sudo dnf install quickshell-git

Guix

Quickshell’s source repository works as a channel. Add the following to your channel list:

(channel
  (name quickshell)
  (url "https://git.outfoxxed.me/outfoxxed/quickshell")
  (branch "master"))

Then, you can install the package via guix install quickshell-git or by adding quickshell-git to your system or home definition.

You can also clone the repository and use guix shell -f quickshell.scm to try out the package.

Manual build

See BUILD.md for build instructions and configurations.

Emacs

Install the yuja/tree-sitter-qml tree-sitter grammar, and the xhcoding/qml-ts-mode mode.

Both are packaged for nix via outfoxxed/nix-qml-support.

Either lsp-mode or eglot should be usable for LSP (caveats below).

The author’s personal emacs config uses lsp-mode and qml-ts-mode as follows:

(use-package qml-ts-mode
  :after lsp-mode
  :config
  (add-to-list 'lsp-language-id-configuration '(qml-ts-mode . "qml-ts"))
  (lsp-register-client
   (make-lsp-client :new-connection (lsp-stdio-connection '("qmlls", "-E"))
                    :activation-fn (lsp-activate-on "qml-ts")
                    :server-id 'qmlls))
  (add-hook 'qml-ts-mode-hook (lambda ()
                                (setq-local electric-indent-chars '(?\n ?\( ?\) ?{ ?} ?\[ ?\] ?\; ?,))
                                (lsp-deferred))))

Neovim

Neovim has built-in syntax highlighting for QML, however tree-sitter highlighting may work better than the built-in highlighting. You can install the grammar using :TSInstall qmljs.

To use the language server (caveats below), install nvim-lspconfig and the following snippet to your configuration:

require("lspconfig").qmlls.setup {
  cmd = {"qmlls", "-E"}
}

Helix

Helix has built-in syntax highlighting for QML.

To use the language server, add the following snippet to your configuration:

[language-server.qmlls]
args = ["-E"]
command = "qmlls"

Vscode

1. Install the Official QML Support extension
2. Enable the qt-qml.qmlls.useQmlImportPathEnvVar setting.