subnera : suivre Train at Home depuis la barre des menus

Le guide de configuration optimale mentionnait déjà le problème de fond : l'interface de Train at Home ne peut pas afficher votre vraie position dans la file, car le point d'entrée dont elle dépend (register.queue_state) répond 503 sans gestionnaire derrière. subnera existe précisément pour corriger cela, en lisant le même journal que l'application officielle écrit déjà.

Ce que c'est vraiment

subnera est une petite application macOS dans la barre des menus. Elle ne fait tourner qu'un seul processus, n'a pas d'icône dans le Dock, et, par défaut, ne fait que lire des fichiers locaux — le journal et, en lecture seule, les fichiers de mise à jour de l'application officielle — à intervalles réguliers, puis redessine son menu. Sa seule requête réseau d'office est une vérification anonyme, une fois par jour, de l'existence d'une version plus récente, que vous pouvez désactiver (détails). Elle ne se connecte jamais au port de contrôle local de Train at Home (127.0.0.1:8010) : le jeton d'accès de ce port change à chaque redémarrage de l'application, et l'hôte Electron officiel possède déjà la seule connexion dont il a besoin — s'y greffer ne ferait que risquer de perturber un mineur en cours d'exécution.

Si ce Mac est déjà lié par subnera-agent, l'application de barre des menus subnera affiche ce lien en lecture seule et ne rapporte pas d'elle-même : le Mac n'est jamais compté deux fois. Lancez subnera-agent unlink pour utiliser l'application à la place.

Ce qu'elle affiche

Selon où vous en êtes, la barre des menus elle-même change pour le refléter. En file d'attente :

⛏ 1564 ▼          ← titre de la barre des menus : position + tendance
─────────────────
State:     queued
Queue:     1564  (-2.0/min)
ETA:       ~8h40m  (→ Sun 6 Jul 03:20)
Since:     00:12:22
Work:      idle (not assigned)
Speedtest: fail (cosmetic, non-blocking)
Backend:   11×503 queue_state, 11×404
Updated:   17:56:07

En cours d'inscription, en attente d'un emplacement de couche :

🟡 confirmed  ← barre des menus : statut d'inscription
─────────────
State:     registering
Queue:     confirmed — waiting for a layer slot
Since:     18:50:33
Updated:   13:42:17

En cours d'entraînement réel :

🟢 L1 · 358k tok/h  ← barre des menus : couche + débit
─────────────────
State:     working
Since:     03:45:12
Work:      training · layer 1 · opt step #24
Rate:      358k tok/h  ·  112 passes/h  (over 18 min)
Updated:   12:34:56

L'ETA est une estimation approximative basée sur la tendance récente, pas une promesse — les mouvements de file sont irréguliers, et ce chiffre sert surtout à donner un ordre de grandeur, pas un compte à rebours fiable au détail près.

Prérequis

• macOS 13 (Ventura) ou ultérieur.
• Un Mac Apple silicon. Il n'existe pas de version Intel.
• Rien d'autre : ni outils de développement, ni dépendance à l'exécution.

Télécharger et installer

1. Rendez-vous sur la page de téléchargement↗ et téléchargez le DMG.
2. Ouvrez le DMG.
3. Glissez subnera sur le raccourci Applications de la fenêtre.
4. Lancez-la depuis Applications. L'app est signée avec un identifiant Apple Developer et notarisée par Apple : macOS l'ouvre sans avertissement, hormis l'habituelle confirmation « téléchargé depuis Internet ».
5. Activez Launch at Login (section suivante) pour qu'elle revienne après un redémarrage.

Vous préférez Homebrew ? Cette commande installe la même app signée que le DMG ci-dessus :

brew install --cask subnera/tap/subnera

Mettez-la à jour ensuite avec la mise à jour intégrée ou brew upgrade --cask subnera.

Lancement à la connexion

Activez-le directement depuis le menu (Options ▸ Launch at Login) ou depuis Settings… ⌘,. Cela utilise SMAppService d'Apple, et la première fois que vous l'activez, macOS peut lister l'application sous Réglages Système → Général → Éléments de connexion, en attente de votre validation.

Lire la barre des menus en un coup d'œil

Barre des menus	Signification
🟢 working	affecté et en cours d'entraînement
🟡 confirmed	en cours d'inscription, en attente d'un emplacement de couche
🟡 1564 ▼	en file à 1564, avance vers le début (bon signe)
🟡 1564 ▲	en file, recule (généralement après un redémarrage de l'application)
🟡 …	démarrage, réinitialisation, ou speed test en cours
🔴 off	l'application officielle ne tourne pas, ou le journal n'a pas bougé depuis plus de 2 minutes
⚪️ ?	en cours d'exécution, mais l'état n'est pas encore reconnu

Cliquer sur l'élément de la barre des menus ouvre un menu détaillé avec votre statut complet, plus des contrôles pour lancer/quitter/redémarrer l'application officielle. Le sous-menu Options ▸ contient des interrupteurs pour le redémarrage automatique en cas de crash, les données en ligne, la capture de lignes inconnues, et les mesures de bande passante ; aussi Menu bar shows: This Mac / Fleet (si inscrit au hub). Le bas du menu affiche Open log ⌘L, Settings… ⌘,, Remote Dashboard Settings… (si inscrit), et Quit subnera ⌘Q.

Optionnel : les données en ligne

Par défaut, subnera ne lit que des fichiers locaux et n'effectue qu'une requête réseau, la vérification de mise à jour quotidienne anonyme (ce qu'elle envoie). Il lit votre journal et, en lecture seule, le ShipItState.plist et la version de la mise à jour téléchargée. Il n'y écrit jamais. Vous pouvez activer séparément les Online data depuis le menu, qui lisent la clé publique (hotkey) de votre fichier de wallet local et interrogent anonymement l'API publique de Macrocosmos pour le tier, l'occupation et les récompenses de votre run. Votre mot de passe et votre clé privée ne quittent jamais le Mac, dans un cas comme dans l'autre — seuls la clé publique (dans l'URL de la requête) et votre adresse IP sont visibles pour cette requête, comme pour n'importe quelle requête web classique. Décochez l'option depuis le menu à tout moment pour l'arrêter. Le guide sur les données en ligne détaille précisément ce qui est lu et envoyé.

Optionnel : surveiller plusieurs Mac

Si vous faites tourner Train at Home sur plusieurs machines, subnera hub, hébergé (sur app.subnera.com), vous donne un tableau de bord unique pour toute la flotte, un visualiseur de journal CLI, et des alertes. Il est désactivé par défaut : sans enrôlement, l'application n'envoie rien au hub, enrôler un Mac est une action volontaire depuis le menu (Remote Dashboard Settings…), et le démarrage/arrêt/redémarrage à distance ne fonctionne que sur une machine où vous avez explicitement coché Allow remote control. Voir le guide multi-Mac.

Si quelque chose semble anormal avec le moniteur lui-même

Symptôme	Cause probable
⛏ off alors que Train at Home tourne visiblement	Le journal ne se met pas à jour — vérifiez que l'application officielle tourne bien, et que ~/Library/Logs/IOTA Train at Home/ existe.
Le bascule de connexion indique « nécessite une validation »	Validez-la dans Réglages Système → Général → Éléments de connexion.
Position qui grimpe (▲) au lieu de descendre	Vous (ou autre chose) avez redémarré l'application officielle ; chaque redémarrage vous replace en fin de file — voir le guide sur la position dans la file.
⚪️ ?	L'application tourne mais le moniteur ne reconnaît pas encore l'état actuel, par exemple après une mise à jour officielle qui change la formulation du journal. Activez Capture unknown lines dans le menu pour enregistrer les formes de lignes non reconnues (vérifiez qu'elles ne contiennent pas votre hotkey avant de les partager).
Le travail affiche toujours idle	Normal tant que vous n'avez pas atteint le début de la file et reçu l'affectation d'une couche.

Checklist

1. Vérifiez que vous êtes sur macOS 13 ou ultérieur, sur un Mac Apple silicon.
2. Téléchargez le DMG, glissez l'application dans Applications et ouvrez-la.
3. Ouvrez l'application et activez Launch at Login si vous voulez qu'elle persiste après un redémarrage.
4. Laissez Online data désactivé, sauf si vous voulez vraiment les lignes supplémentaires de récompenses/tier publiques.
5. Si vous faites tourner plusieurs Mac, consultez le guide du hub de flotte. Pour un Mac utilisé comme serveur, voir l'agent en ligne de commande.
6. Utilisez le guide sur la position dans la file si vous préférez comprendre le journal brut que l'application lit.

Pour tout le reste d'une bonne configuration de Train at Home — installation, veille, réseau — consultez le guide de configuration optimale complet. Si vous n'avez pas encore installé l'application officielle, commencez par le guide d'installation.