# 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.