125 lines
2.4 KiB
Markdown
125 lines
2.4 KiB
Markdown
# gKeyMapper
|
||
|
||
GTK4 application (C++) for remapping the G keys **G1–G9** of a Logitech **G910**
|
||
to other keys or commands (Linux Mint / Ubuntu).
|
||
|
||
The current focus is on the **GUI** only (no actual key capture/command execution yet).
|
||
|
||
Documentation and source comments are written in English.
|
||
|
||
## Requirements
|
||
|
||
- Linux Mint / Ubuntu
|
||
- g++ (C++17)
|
||
- pkg-config
|
||
- gettext (for translations, `msgfmt`)
|
||
- GTK 4 development files
|
||
|
||
### Install dependencies
|
||
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y build-essential gettext libgtk-4-dev
|
||
```
|
||
|
||
Afterwards `pkg-config --modversion gtk4` should print a version (e.g. `4.6.x`).
|
||
|
||
## Setting up the project
|
||
|
||
Change to the project directory:
|
||
|
||
```bash
|
||
cd /home/trager/Nextcloud/Projekte/C++/gKeyMapper
|
||
```
|
||
|
||
(Alternatively clone the repository or copy the project folder to your own location.)
|
||
|
||
## Build
|
||
|
||
```bash
|
||
make
|
||
```
|
||
|
||
This produces the `gkeymapper` binary and the `.mo` translations under `locale/`.
|
||
|
||
## Rebuild translations
|
||
|
||
```bash
|
||
make translations
|
||
```
|
||
|
||
## Run
|
||
|
||
Normal:
|
||
|
||
```bash
|
||
./gkeymapper
|
||
```
|
||
|
||
With explicit language files (useful for testing from the build directory):
|
||
|
||
```bash
|
||
LANG=de_DE.UTF-8 GKEYMAPPER_LOCALEDIR=$PWD/locale ./gkeymapper
|
||
```
|
||
|
||
Supported languages: German, English, Spanish, French.
|
||
|
||
## Install (optional)
|
||
|
||
```bash
|
||
sudo make install
|
||
```
|
||
|
||
Installs `gkeymapper` to `/usr/local/bin` and the `.mo` files to
|
||
`/usr/local/share/locale`.
|
||
|
||
## Clean
|
||
|
||
```bash
|
||
make clean
|
||
```
|
||
|
||
Removes the binary and the generated `locale/` directory.
|
||
|
||
## Project structure
|
||
|
||
```
|
||
src/main.cpp # GTK4 GUI
|
||
po/ # Translations (pot/po/mo targets)
|
||
Makefile # Build via pkg-config + gettext
|
||
.vscode/tasks.json # VS Code tasks for make
|
||
README.md
|
||
```
|
||
|
||
## Troubleshooting
|
||
|
||
### `Package gtk4 was not found`
|
||
|
||
The GTK 4 development files are missing. Install them:
|
||
|
||
```bash
|
||
sudo apt install -y libgtk-4-dev
|
||
```
|
||
|
||
Then verify:
|
||
|
||
```bash
|
||
pkg-config --modversion gtk4
|
||
```
|
||
|
||
### `pkg-config` cannot find `.pc` files (wrong search path)
|
||
|
||
In some environments `PKG_CONFIG_PATH` must be set explicitly. Standard path on
|
||
Ubuntu/Mint:
|
||
|
||
```bash
|
||
export PKG_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig:/usr/share/pkgconfig:/usr/lib/pkgconfig
|
||
```
|
||
|
||
## Planned next steps
|
||
|
||
- Real capture of key presses (evdev/uinput or libinput).
|
||
- Execution of commands when a G key is pressed.
|
||
- Loading and saving profiles.
|
||
- Autostart service / background daemon.
|