openlogi 0.5.1

OpenLogi command-line interface — a local-first companion for Logitech HID++ peripherals.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

> [!WARNING]
> **OpenLogi est en cours de développement actif** et n'est pas encore stable —— les fonctionnalités et la configuration peuvent encore changer. Mettez une **Star** ⭐ au dépôt et **suivez-le** 👀 pour être averti dès qu'une version est publiée.

<h4 align="right"><a href="../README.md">English</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.ja.md">日本語</a> | <a href="README.de.md">Deutsch</a> | <strong>Français</strong> | <a href="README.ko.md">한국어</a></h4>

<p align="center">
    <img src="https://assets.openlogi.org/brand/openlogi-icon.png" width="138" alt="OpenLogi"/>
</p>

<h1 align="center">OpenLogi</h1>
<p align="center"><strong>⚡️ Une alternative native et locale d'abord à Logitech Options+, écrite en Rust 🦀<br/>Réaffectez les boutons, le DPI et SmartShift via HID++. Sans compte, sans télémétrie.</strong></p>


<div align="center">
    <a href="https://twitter.com/AprilNEA" target="_blank">
    <img alt="twitter" src="https://img.shields.io/badge/follow-AprilNEA-green?style=social&logo=Twitter"></a>
    <a href="https://t.me/+u8DfyLlIqPYxZjJh" target="_blank">
    <img alt="telegram" src="https://img.shields.io/badge/chat-telegram-blueviolet?style=flat&logo=Telegram"></a>
    <a href="https://github.com/AprilNEA/OpenLogi/releases" target="_blank">
    <img alt="GitHub downloads" src="https://img.shields.io/github/downloads/AprilNEA/OpenLogi/total.svg?style=flat"></a>
    <a href="https://github.com/AprilNEA/OpenLogi/commits" target="_blank">
    <img alt="GitHub commit" src="https://img.shields.io/github/commit-activity/m/AprilNEA/OpenLogi?style=flat"></a>
    <img alt="Hits" src="https://hits.aprilnea.com/hits?url=https://github.com/aprilnea/openlogi">
</div>

> **Marre d'Options+ ? Essayez OpenLogi.**

Réaffectez les boutons, pilotez le DPI et SmartShift, et changez de profil selon l'application —— sans compte Logitech, sans télémétrie et sans l'installation officielle d'Options+. Aucun cloud, configuration en simple TOML ; les seuls accès réseau sont le téléchargement des images d'appareils et une vérification de mise à jour optionnelle, désactivée par défaut.

---

## Présentation

OpenLogi communique avec les souris Logitech HID++ via un récepteur Logi Bolt —— ou une connexion Bluetooth directe / filaire —— sans exécuter Logi Options+. Il fournit deux binaires :

- **[OpenLogi GUI](../crates/openlogi-gui)** —— une application de bureau GPUI : un schéma de souris interactif avec des zones cliquables, un sélecteur d'action par bouton (39 actions intégrées plus des raccourcis personnalisés enregistrés), des préréglages DPI, un interrupteur SmartShift, des surcouches de profil par application, un carrousel d'appareils qui bascule en direct entre les appareils appairés, et une fenêtre de réglages dont l'interface est localisée en six langues.
- **[OpenLogi CLI](../crates/openlogi-cli)** —— une interface en ligne de commande pour l'inventaire sans interface graphique (`list`), ainsi que des sous-commandes de synchronisation des ressources et de diagnostic des appareils.

Tout reste local : les affectations vivent dans un simple fichier TOML, les appuis sur les boutons sont réaffectés via l'event tap du système, et les changements de DPI / SmartShift sont écrits directement sur l'appareil via HID++.

macOS est pris en charge aujourd'hui ; Linux et Windows arrivent bientôt —— voir la [Feuille de route](#feuille-de-route).

## Feuille de route

| Fonctionnalité | État |
|---|---|
| Détecter les récepteurs Bolt + lister les appareils appairés (CLI + GUI) | ✅ |
| Appareils Bluetooth direct / filaires (sans récepteur) | ✅ |
| Pourcentage de batterie / état de charge | ✅ (appareils en ligne) |
| GUI interactive : carrousel, schéma de souris, sélecteur d'action | ✅ macOS |
| Réaffectation des boutons via l'event tap du système (boutons latéraux Back / Forward pour l'instant) | ✅ macOS |
| Catalogue de 39 actions + raccourcis clavier personnalisés enregistrés | ✅ macOS¹ |
| Contrôle du DPI + préréglages + actions Cycler / Définir un préréglage (HID++ `0x2201`) | ✅ macOS |
| Bascule du mode molette SmartShift (HID++ `0x2111`) | ✅ macOS |
| Surcouches de profil par application (bascule auto au focus de l'app) | ✅ macOS |
| Fenêtre de réglages : lancement à l'ouverture de session, vérification des mises à jour, barre de menus, autorisations, langue | ✅ macOS |
| Localisation de l'interface (6 langues : en, ja, ru, zh-CN, zh-HK, zh-TW) | ✅ macOS |
| Affectations par direction du bouton gestuel | 🟡 configurable ; capture matérielle à venir |
| Capture des boutons central / changement de mode / molette du pouce | 🟡 configurable ; le hook ne gère que les boutons latéraux |
| Hook d'événements Linux / Windows | ❌ stub (`Unsupported`) |
| Récepteurs Unifying | ❌ (pas encore pris en charge) |

¹ Quelques actions (p. ex. les touches multimédias) se contentent pour l'instant de journaliser l'événement prévu au lieu de l'émettre réellement —— suivi en tant que tâche ultérieure.

## Installation

> [!IMPORTANT]
> Quittez d'abord **Logi Options+** —— les deux applications se disputent l'accès HID++, et un récepteur ne peut être détenu que par une seule à la fois.

Téléchargez le `.dmg` signé et notarisé depuis la [dernière version](https://github.com/AprilNEA/OpenLogi/releases/latest) et glissez `OpenLogi.app` dans `/Applications`.

Ou installez via [Homebrew](https://brew.sh) :

```sh
brew install --cask openlogi
```

Pour compiler depuis les sources, voir [DEVELOPMENT.md](DEVELOPMENT.md).

## Utilisation (CLI)

Voir [USAGE.md](USAGE.md).

## Configuration

Voir [CONFIGURATION.md](CONFIGURATION.md).

## Développement

Voir [DEVELOPMENT.md](DEVELOPMENT.md).

## Remerciements

- [`hidpp`](https://crates.io/crates/hidpp) par [@lus](https://github.com/lus)
- [Solaar](https://github.com/pwr-Solaar/Solaar)
- [Mouser](https://github.com/TomBadash/Mouser) par Tom Badash

## Licence

Sous double licence, au choix :

- Apache License, Version 2.0 ([LICENSE-APACHE](../LICENSE-APACHE))
- Licence MIT ([LICENSE-MIT](../LICENSE-MIT))

à votre convenance.

### Logo et ressources de marque

Le logo et l'icône d'application d'OpenLogi —— les ressources de marque situées dans [`design/`](../design/) —— sont © 2026 AprilNEA, tous droits réservés, et ne sont pas couverts par les licences MIT/Apache ci-dessus ; voir [`design/LICENSE`](../design/LICENSE). Forker le code n'accorde aucun droit sur le nom, le logo ou l'icône d'OpenLogi ; merci de ne pas les utiliser pour représenter vos propres projets, forks ou distributions sans autorisation écrite préalable.

---

**Sans affiliation avec Logitech.** « Logitech », « MX Master » et « Options+ » sont des marques de Logitech International S.A.