- Python 76.6%
- Shell 23.4%
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01G1i1TiVG4uU5MBG7c8bzj1 |
||
|---|---|---|
| docs | ||
| tests | ||
| .gitignore | ||
| .toolctl-install | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| cliff.toml | ||
| LICENSE | ||
| pemmikan.md | ||
| protoarc | ||
| protoarc.py | ||
| README.md | ||
protoarc
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 pernix 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.