Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
January 21, 2022 12:13
May 22, 2023 14:13
May 18, 2023 12:52
February 10, 2021 16:40
March 27, 2023 19:20
May 2, 2023 14:45
May 2, 2023 14:45
August 18, 2020 09:49

System76 Keyboard Configurator

Tool for configuring System76 keyboards, internal and external, with support for changing the keymap and LED settings.

This requires a System76 laptop with recent open EC firmware, or a Launch keyboard. Note that LED settings are not currently persisted on internal keyboards.


See releases page for pre-built binaries of the latest tagged release.


# Install dependencies if necessary
sudo apt-get install cargo libgtk-3-dev libhidapi-dev libudev-dev

# Clone keyboard-configurator if necessary
git clone

# Make sure it is up to date
cd keyboard-configurator
git pull

# Build and run the configurator
cargo run --release


Translators are welcome to submit translations directly as a pull request to this project. It is generally expected that your pull requests will contain a single commit for each language that was added or improved, using a syntax like so:

i18n(eo): Add Esperanto language support
i18n(pl): Improvements to Polish language support

Translation files can be found here. We are using Project Fluent for our translations, which should be easier than working with gettext.