You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

27 lines
1021 B

  1. # Tab Completion for QMK
  2. 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.
  3. ## Setup
  4. There are several ways you can setup tab completion.
  5. ### For Your User Only
  6. Add this to the end of your `.profile` or `.bashrc`:
  7. source ~/qmk_firmware/util/qmk_tab_complete.sh
  8. If you put `qmk_firmware` into another location you will need to adjust this path.
  9. ### System Wide Symlink
  10. 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:
  11. `ln -s ~/qmk_firmware/util/qmk_tab_complete.sh /etc/profile.d/qmk_tab_complete.sh`
  12. ### System Wide Copy
  13. 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.
  14. cp util/qmk_tab_complete.sh /etc/profile.d