Trackball-Befreiung ohne Browser-Leine 🖲️
  • Python 76.6%
  • Shell 23.4%
Find a file
holm / Christian Müller 8dc57e1388
Merge dev: Release v0.2.0
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G1i1TiVG4uU5MBG7c8bzj1
2026-11-06 10:07:08 +01:00
docs fix: Ruecklesen nennt als Warnung, was nicht uebernommen wurde (#5) 2026-11-06 10:05:46 +01:00
tests fix: Ruecklesen nennt als Warnung, was nicht uebernommen wurde (#5) 2026-11-06 10:05:46 +01:00
.gitignore feat: EM06 sichern, umbelegen und einspielen ohne Hersteller-Seite (#1) 2026-11-04 21:34:28 +01:00
.toolctl-install feat: EM06 sichern, umbelegen und einspielen ohne Hersteller-Seite (#1) 2026-11-04 21:34:28 +01:00
CHANGELOG.md chore(release): v0.2.0 2026-11-06 10:06:57 +01:00
CLAUDE.md feat: EM06 sichern, umbelegen und einspielen ohne Hersteller-Seite (#1) 2026-11-04 21:34:28 +01:00
cliff.toml feat: EM06 sichern, umbelegen und einspielen ohne Hersteller-Seite (#1) 2026-11-04 21:34:28 +01:00
LICENSE feat: EM06 sichern, umbelegen und einspielen ohne Hersteller-Seite (#1) 2026-11-04 21:34:28 +01:00
pemmikan.md docs(pemmikan): Stand nach Sicherungen und Warnung 2026-11-06 10:06:56 +01:00
protoarc feat: EM06 sichern, umbelegen und einspielen ohne Hersteller-Seite (#1) 2026-11-04 21:34:28 +01:00
protoarc.py fix: Ruecklesen nennt als Warnung, was nicht uebernommen wurde (#5) 2026-11-06 10:05:46 +01:00
README.md fix: Ruecklesen nennt als Warnung, was nicht uebernommen wurde (#5) 2026-11-06 10:05:46 +01:00

protoarc

License: MIT Linux Python

Trackball-Befreiung ohne Browser-Leine 🖲️ — ProtoArc EM06 sichern, umbelegen und einspielen, ohne hub.protoarc.com.

Features

  • Sichern — kompletten Konfigurationsspeicher des Geräts in eine Datei lesen
  • Auflisten — vorhandene Sicherungen mit Zeit und Prüfsumme zeigen
  • Anzeigen — Tastenbelegung aus der Datei lesbar ausgeben, ohne Gerät
  • Umbelegen — Slot in der Datei ändern, das Gerät bleibt dabei unberührt
  • Vergleichen — Gerät gegen Datei oder Datei gegen Datei, nach Slots, DPI, Kürzeln und Makros
  • Einspielen — nur abweichende Bytes schreiben, danach rücklesen, was nicht ankam als Warnung zeigen
  • Keine Firmware-Befehle — das Werkzeug liest und schreibt nur den Konfigurationsspeicher

Getestet mit einem EM06 per USB (260d:1326). Bluetooth geht nicht. Andere Modelle sind ungeprüft.

Aufruf

protoarc read                      # Gerät -> Sicherungsordner
protoarc read  em06.bin            # Gerät -> genau diese Datei
protoarc list                      # Sicherungen mit Zeit und Prüfsumme
protoarc show  em06.bin            # Belegung anzeigen
protoarc set   em06.bin 2 mitte    # Slot 2 in der Datei umbelegen
protoarc diff  em06.bin            # Gerät -> Datei vergleichen
protoarc diff  alt.bin neu.bin     # Datei -> Datei vergleichen
protoarc apply em06.bin            # Datei -> Gerät
protoarc rollout vorlage.bin       # sichern, Unterschiede zeigen, nach Bestätigung einspielen

Für rollout und alle anderen Befehle mit Gerät immer nur einen EM06 anstecken.

Wo liegt was

Sicherungsordner ist ~/.local/share/protoarc/.

Befehl Schreibt Liest
read Sicherungsordner, em06-<seriennummer>-<zeit>.bin Gerät
read <datei> genau diese Datei, relativ zum aktuellen Ordner Gerät
rollout <datei> Sicherung wie read, danach das Gerät Datei und Gerät
apply <datei> Gerät, keine Sicherung Datei und Gerät
set <datei> … genau diese Datei, das Gerät bleibt unverändert diese Datei
show, diff, list nichts Datei, bei diff <datei> auch das Gerät

Für show, diff, apply und rollout gilt: Liegt die angegebene Datei nicht am genannten Ort und ist es ein blanker Dateiname, wird sie im Sicherungsordner gesucht. Jeder dieser Befehle nennt den verwendeten vollen Pfad.

Gleiche Prüfsumme in list heißt gleicher Inhalt. Die Seriennummer im Dateinamen unterscheidet Geräte nicht sicher, verschiedene EM06 können dieselbe melden.

Beispiel: Sicherung ansehen und gegen das angesteckte Gerät prüfen, ohne etwas zu schreiben.

protoarc list
protoarc show vorlage.bin
protoarc diff vorlage.bin

Funktionen für set: links, rechts, mitte, zurück, vor, aus.

Das Protokoll steht in docs/PROTOCOL.md.

Voraussetzungen

  • Linux, Python 3 ohne Zusatzpakete. Fehlt python3, startet der Wrapper es per nix shell.
  • Schreib- und Lesezugriff auf /dev/hidraw* des Geräts, zum Beispiel per udev-Regel:
KERNEL=="hidraw*", ATTRS{idVendor}=="260d", ATTRS{idProduct}=="1326", TAG+="uaccess"

Die Regel muss in einer Datei vor 73-seat-late.rules liegen, etwa 70-protoarc-webhid.rules. Sie greift nach dem Neu-Einstecken.

Changelog

Siehe CHANGELOG.md. Wird per git-cliff aus Conventional Commits generiert. Manuell nicht editieren.

Installation

git clone https://forgejo.mueller.network/holm.tools.public/protoarc.git
ln -s "$PWD/protoarc/protoarc" ~/bin/protoarc

Lizenz

MIT, siehe LICENSE. Erstellt unter Zuhilfenahme von Claude.ai.