Shell Autocompletions

Gtheme provides tab completion for all commands, including dynamic completion of desktop and theme names. Completions are regenerated automatically when desktops or themes are added or removed.

Setup

Zsh

Add the completions directory to your fpath in ~/.zshrc:

fpath=($HOME/.gtheme/completions $fpath)

This line must be placed before the call to compinit:

fpath=($HOME/.gtheme/completions $fpath)
autoload -Uz compinit && compinit

If you don’t have a compinit call, add one after the fpath export.

Bash

Source the completion script in your ~/.bashrc:

[ -r "$HOME/.gtheme/completions/gtheme.bash" ] && source "$HOME/.gtheme/completions/gtheme.bash"

Fish

Fish automatically loads completions from user-level directories — no additional setup is required.

Note

Gtheme regenerates completion scripts every time a desktop or theme is added or removed, which requires write access to the ~/.gtheme/completions/ directory. This directory is created automatically during installation.