Tartarus Mapper — Razer Tartarus V2 mapper for Linux

Tartarus Mapper is a free and open-source Razer Synapse alternative for Linux, built specifically for the Razer Tartarus V2 gaming keypad (1532:022B). It provides a graphical key mapper, profiles, layers, simultaneous and repeating macros, D-pad and scroll-wheel bindings, automatic per-game profiles, and direct RGB/Chroma backlight control without requiring OpenRazer or Polychromatic at runtime.

Tartarus Mapper est une alternative libre a Razer Synapse sous Linux, creee specialement pour configurer le Razer Tartarus V2. Elle gere le remappage des touches, les profils, les couches, les macros, le pave directionnel, la molette et l'eclairage du peripherique.

Telecharger le paquet Ubuntu/Debian · Signaler un probleme

Etat du projet

• Version actuelle : 4.0.0
• Materiel pris en charge : Razer Tartarus V2 1532:022B
• Systeme cible : Linux, teste principalement sous Ubuntu
• Licence : GNU GPL v3 ou ulterieure
• Auteur : Kiwileretour
• Modifications : CHANGELOG.md

Le moteur et le module LED sont autonomes : OpenRazer et Polychromatic ne sont pas necessaires a l'execution.

Fonctionnalites

• representation interactive des 20 touches, du pave et de la molette ;
• remappage vers une touche, une combinaison ou une action souris ;
• profils et couches avec changement temporaire ou cyclique ;
• macros simultanees avec delais, repetitions par ligne et maintien jusqu'au relachement ;
• couleur de retroeclairage propre a chaque profil ;
• trois LED laterales utilisees comme indicateur de couche ;
• changement automatique de profil selon l'application active sous X11/XWayland ;
• moteur lance comme service systemd utilisateur, sans executer l'application en root.

Installation recommandee (Ubuntu)

Telecharger le paquet tartarus-mapper_4.0.0-1_all.deb depuis la derniere release, puis l'installer :

sudo apt install ./tartarus-mapper_4.0.0-1_all.deb

Debrancher puis rebrancher le Tartarus apres l'installation. L'application est ensuite disponible dans le menu des applications sous le nom Tartarus Mapper, ou depuis un terminal :

tartarus-mapper

Les profils, macros et reglages restent propres a l'utilisateur dans ~/.config/tartarus-mapper. Le paquet n'active pas automatiquement le moteur : le demarrage se fait depuis l'interface apres avoir choisi un profil.

Si la distribution n'applique pas automatiquement l'autorisation de session uaccess, ajouter l'utilisateur au groupe de secours, puis fermer et rouvrir la session :

sudo usermod --append --groups tartarusmapper "$USER"

Installation depuis les sources (Ubuntu)

Les commandes ci-dessous supposent que le depot se trouve exactement dans ~/TartarusMapper, emplacement actuellement attendu par les unites systemd.

1. Recuperer le projet et les dependances

cd ~
git clone https://github.com/kiwileretour-code/TartarusMapper.git
cd TartarusMapper
sudo apt update
sudo apt install python3 python3-tk python3-evdev python3-usb python3-pil libusb-1.0-0

2. Autoriser uniquement le Tartarus et uinput

sudo groupadd --force tartarusmapper
sudo usermod --append --groups tartarusmapper "$USER"
sudo install -m 0644 udev/70-tartarus-mapper.rules /etc/udev/rules.d/70-tartarus-mapper.rules
sudo install -m 0644 udev/70-tartarus-mapper-led.rules /etc/udev/rules.d/70-tartarus-mapper-led.rules
sudo udevadm control --reload-rules
sudo udevadm trigger
sudo modprobe uinput

Il faut ensuite fermer puis rouvrir la session utilisateur afin que l'appartenance au groupe soit prise en compte. Debrancher/rebrancher le Tartarus applique aussi les nouvelles permissions au peripherique.

Les regles fournies sont limitees au Tartarus V2 1532:022B. L'acces a /dev/uinput est accorde au groupe dedie afin que le moteur puisse emettre les touches remappees sans privileges root.

3. Installer les services utilisateur

mkdir -p ~/.config/systemd/user ~/.config/tartarus-mapper
install -m 0644 systemd/tartarus-mapper.service ~/.config/systemd/user/
install -m 0644 systemd/tartarus-autoprofile.service ~/.config/systemd/user/
systemctl --user daemon-reload

4. Lancer l'interface

cd ~/TartarusMapper
python3 tartarus_gui.py

Le profil public demo permet de verifier l'interface sans reprendre une configuration personnelle. Choisir le profil, puis utiliser Activer ce profil dans les reglages pour demarrer le moteur.

Tests rapides

Verifier le profil de demonstration :

python3 tartarus_engine.py --check --profile demo

Tester le retroeclairage rouge :

python3 tartarus_led.py static 255 0 0

Eteindre le retroeclairage :

python3 tartarus_led.py off

Avec le paquet installe, la commande equivalente est :

tartarus-mapper-led static 255 0 0

Executer les tests automatises :

python3 -m unittest -v

Depannage

Le Tartarus n'est pas trouve ou l'acces est refuse

Verifier l'identifiant USB et les groupes de la session :

lsusb -d 1532:022b
id
ls -l /dev/uinput /dev/input/event*

Si le groupe tartarusmapper vient d'etre ajoute, une reconnexion complete est necessaire. Ne pas lancer l'interface en root.

Le Tartarus est occupe pendant une commande LED

Fermer OpenRazer, Polychromatic ou tout autre logiciel susceptible de conserver l'interface USB. Un seul programme peut reclamer cette interface a la fois.

Le moteur s'arrete immediatement

systemctl --user status tartarus-mapper.service
journalctl --user -u tartarus-mapper.service -n 100 --no-pager
python3 tartarus_probe.py

Le profil automatique ne change pas

La detection de la fenetre active utilise X11. Elle fonctionne sous X11 et dans de nombreux cas sous XWayland, mais une session Wayland native peut masquer les informations de la fenetre active. Le changement manuel de profil reste disponible.

Limites actuelles

• seul le Tartarus V2 1532:022B est cible ;
• une seule couleur globale de retroeclairage est geree par profil ;
• pas d'effets Chroma complexes ni de couleur individuelle par touche.

Desinstallation

Paquet Debian

systemctl --user disable --now tartarus-autoprofile.service tartarus-mapper.service
sudo apt remove tartarus-mapper

La configuration personnelle dans ~/.config/tartarus-mapper est volontairement conservee. La supprimer reste un choix manuel.

Installation depuis les sources

Arreter les services avant de retirer les fichiers :

systemctl --user disable --now tartarus-autoprofile.service tartarus-mapper.service
rm ~/.config/systemd/user/tartarus-autoprofile.service
rm ~/.config/systemd/user/tartarus-mapper.service
systemctl --user daemon-reload
sudo rm /etc/udev/rules.d/70-tartarus-mapper.rules
sudo rm /etc/udev/rules.d/70-tartarus-mapper-led.rules
sudo udevadm control --reload-rules

La configuration personnelle reste dans ~/.config/tartarus-mapper. Elle peut etre conservee pour une reinstallation. Le dossier du projet peut etre deplace vers la corbeille avec :

gio trash ~/TartarusMapper

Construire le paquet

Depuis la racine du depot :

bash packaging/build_deb.sh
dpkg-deb --info dist/tartarus-mapper_4.0.0-1_all.deb

Le paquet est produit dans dist/. Les workflows GitHub Actions executent les tests et reconstruisent ce paquet ; un tag v* publie automatiquement le fichier .deb dans une release GitHub.

Licence, composants et marques

• texte de licence : LICENSE ;
• mentions legales : NOTICE ;
• composants tiers : THIRD_PARTY.md ;
• provenance des images : ASSETS.md.

Le protocole LED a ete etudie en prenant les sources publiques d'OpenRazer comme reference technique. OpenRazer n'est pas une dependance de Tartarus Mapper.

Tartarus Mapper est un logiciel non officiel pour le Razer Tartarus V2. Il n'est ni affilie, ni approuve, ni sponsorise par Razer Inc. Razer et Tartarus sont des marques appartenant a leurs proprietaires respectifs.

Contribuer et signaler un probleme

• code source : https://github.com/kiwileretour-code/TartarusMapper
• rapports de bugs : https://github.com/kiwileretour-code/TartarusMapper/issues

Lors d'un rapport de bug, indiquer la distribution Linux, le type de session (X11, XWayland ou Wayland), la version de Python et la sortie pertinente du journal systemd. Ne jamais publier de donnees personnelles contenues dans les profils ou dans ~/.config/tartarus-mapper.