gitbot/qmk_firmware
0
0
Fork 0
mirror of https://github.com/qmk/qmk_firmware.git synced 2024-12-18 07:33:26 +00:00
Code Issues Packages Projects Releases Wiki Activity
c922fc2cf3
qmk_firmware/docs/cli_tab_complete.md
Zach White 588bcdc8ca
Add support for tab completion (#12411) 
* Add support for tab completion

* make flake8 happy

* Add documentation
2021-04-14 19:00:22 -07:00

1021 B
Raw Blame History

Tab Completion for QMK

If you are using Bash 4.2 or later, Zsh, or FiSH you can enable Tab Completion for the QMK CLI. This will let you tab complete the names of flags, keyboards, files, and other qmk options.

Setup

There are several ways you can setup tab completion.

For Your User Only

Add this to the end of your .profile or .bashrc:

source ~/qmk_firmware/util/qmk_tab_complete.sh

If you put qmk_firmware into another location you will need to adjust this path.

System Wide Symlink

If you want the tab completion available to all users of the system you can add a symlink to the qmk_tab_complete.sh script:

`ln -s ~/qmk_firmware/util/qmk_tab_complete.sh /etc/profile.d/qmk_tab_complete.sh`

System Wide Copy

In some cases a symlink may not work. Instead you can copy the file directly into place. Be aware that updates to the tab complete script may happen from time to time, you will want to recopy the file periodically.

cp util/qmk_tab_complete.sh /etc/profile.d