{{tag>Bionic Focal matériel souris}}
----

====== Configurer sa souris SteelSeries ======

**Rivalcfg** est un outil en ligne de commande et une bibliothèque Python permetant la configuration de nombreuses souris de la marque SteelSeries.

Seules les options supportées par le matériel sont gérées par l'application. Ces fonctionnalités dépendent du modèles de la souris.


===== Compatibilité =====

Les familles de souris suivantes sont actuellement supportées (près d'une cinquantaine de modèles au total) :

  * SteelSeries Aerox 3
  * SteelSeries Aerox 3 Wireless
  * SteelSeries Kana v2
  * SteelSeries Kinzu v2
  * SteelSeries Prime
  * SteelSeries Rival
  * SteelSeries Rival 3
  * SteelSeries Rival 95
  * SteelSeries Rival 100
  * SteelSeries Rival 100 PC Bang
  * SteelSeries Rival 105
  * SteelSeries Rival 106
  * SteelSeries Rival 110
  * SteelSeries Rival 300
  * SteelSeries Rival 300S
  * SteelSeries Rival 310
  * SteelSeries Rival 500
  * SteelSeries Rival 600
  * SteelSeries Rival 700
  * SteelSeries Rival 710
  * SteelSeries Sensei 310
  * SteelSeries Sensei TEN
  * SteelSeries Sensei [RAW]


Pour plus de détails, consultez [[https://github.com/flozz/rivalcfg#supported-devices|la liste à jour des modèles supportés]].


===== Pré-requis =====

  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.


===== Installation =====

Pour installer Rivalcfg, il faut commencer par [[:tutoriel:comment_installer_un_paquet|installer les paquets]] **[[apt>build-essential,python3-pip,python3-dev,libusb-1.0-0-dev,libudev-dev|build-essential python3-pip python3-dev libusb-1.0-0-dev libudev-dev]]**.


Puis, étant donné que le logiciel n'est pas encore disponible dans les dépôts, il vous faudra l'installer en utilisant pip3 :

<code>
sudo pip3 install rivalcfg
</code>

Et enfin, il vous faudra terminer l'installation avec la commande suivante afin d'autoriser votre utilisateur à configurer la souris :

<code>
sudo rivalcfg --update-udev
</code>


===== Utilisation =====

Pour configurer votre souris, il faudra utiliser la [[:commande_shell|commande]] suivante :

<code>
rivalcfg
</code>

Les options de la ligne de commande varient en fonction de la souris connectée à l'ordinateur. Vous trouverez donc la liste des options pour votre souris dans [[https://flozz.github.io/rivalcfg/devices/index.html|la page qui lui est dédiée dans la documentation officielle]].


===== Désinstallation =====

Pour supprimer Rivalcfg, il vous faudra utiliser la [[:commande_shell|commande]] suivante :

<code>
sudo pip3 uninstall rivalcfg
</code>


===== Voir aussi =====

  * **(en)** [[https://github.com/flozz/rivalcfg|Page officielle de Rivalcfg sur Github]]
  * **(en)** [[https://flozz.github.io/rivalcfg/|Documentation officielle de Rivalcfg]]
  * **(fr)** [[https://blog.flozz.fr/2020/08/24/rivalcfg-comment-jai-cree-un-peu-par-hasard-cet-outil-de-configuration-pour-les-souris-steelseries/|Historique du projet sur le blog de son auteur]]
  * **(fr)** [[https://forum.ubuntu-fr.org/viewtopic.php?pid=22327803#p22327803|Discussion sur le forum Ubuntu-fr]]

----
//Contributeurs principaux : [[utilisateurs:flozz|FLOZz]]