Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pop-os/keyboard-configurator
Keyboard configuration UI
https://github.com/pop-os/keyboard-configurator
Last synced: 1 day ago
JSON representation
Keyboard configuration UI
- Host: GitHub
- URL: https://github.com/pop-os/keyboard-configurator
- Owner: pop-os
- License: gpl-3.0
- Created: 2020-08-18T17:19:45.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-16T20:16:54.000Z (about 2 months ago)
- Last Synced: 2024-10-29T18:08:10.848Z (15 days ago)
- Language: Rust
- Homepage:
- Size: 1.74 MB
- Stars: 261
- Watchers: 23
- Forks: 47
- Open Issues: 70
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
## Releases
See [releases](https://github.com/pop-os/keyboard-configurator/releases) page for pre-built binaries of the latest tagged release.
## Building
```
# Install dependencies if necessary
sudo apt-get install cargo libgtk-3-dev libhidapi-dev libudev-dev
# Clone keyboard-configurator if necessary
git clone https://github.com/pop-os/keyboard-configurator
# Make sure it is up to date
cd keyboard-configurator
git pull
# Build and run the configurator
cargo run --release
```
## Translators
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](./i18n/). We are using [Project Fluent](https://projectfluent.org) for our translations, which should be easier than working with gettext.