KataMarrant

Mon, 04 May 2026 00:00:00 +0000

KataMarrant est une petite appli d’entraînement au judo que je construis le soir et le week-end. L’objectif est étroit et concret : réviser les 40 Gokyo no Waza, l’ensemble classique des prises codifié au Kodokan que tout judoka est censé connaître par leur nom, en sessions courtes et quotidiennes. L’appli tourne sur Windows, macOS, Linux, Android et iOS à partir d’une seule base de code Tauri 2, avec du JS vanille pour le frontend et du Rust pour le backend.

Il y a quatre modes d’entraînement. Une question est le bouton le moins coûteux à appuyer sur l’écran d’accueil, pour les moments où j’ai moins de trente secondes. Rafale est une volée de dix questions, l’échauffement que je fais dans le métro. Drill (chrono) est un mode chronométré avec une barre qui descend par question, dont une variante audio où le nom de la technique est prononcé à voix haute et il faut choisir la bonne description. Parcourir les 40 techniques est le catalogue de référence, classé par kyo, avec le romaji, le kanji, la traduction française et une vidéo de démonstration sélectionnée pour chaque prise.

La logique du quiz emprunte les bases à la répétition espacée : les techniques que vous ratez reviennent plus souvent, un cooldown de six questions empêche les répétitions consécutives, et les scores de maîtrise par technique vous suivent d’un appareil à l’autre quand la synchronisation est activée. La synchronisation est optionnelle, par lien magique uniquement, sans mot de passe stocké nulle part. Un objectif quotidien, un compteur de série, une courbe d’XP et une petite grille de succès à débloquer occupent l’écran d’accueil, empruntant à une décennie d’applis d’apprentissage des langues et de fitness.

Les illustrations des techniques sont extraites de la planche Gokyo no Waza sur Wikimedia Commons par l’utilisateur Mtwist (CC BY-SA). Les vidéos de référence sont sélectionnées par judo.how. Le projet est open source, non affilié au Kodokan ni à une fédération de judo, et il est documenté sur ce site dans une série de billets sur le build.

Construire KataMarrant, partie 1 : la ceinture noire, 40 prises, et le trou que je ne voulais pas cacher

Mon, 04 May 2026 00:00:00 +0000

Écran d’accueil sur Android. Niveau 5, série de deux jours, 16 sur 10 questions répondues aujourd’hui, quatre modes d’entraînement et une grille de succès verrouillés et déverrouillés.

Premier billet d’une petite série

C’est le premier billet d’une série que je vais écrire sur KataMarrant, une petite appli d’entraînement au judo que je construis le soir et le week-end. Les billets suivants vont parler du build (Tauri 2 sur Android, serveur de synchronisation en Rust, authentification par lien magique, sans mot de passe), des choix de conception (offline-first, répétition espacée avec cooldown, pourquoi j’ai préféré le JS vanille à un framework), et de ce que j’ai appris en mettant une appli personnelle sur le Play Store. Celui-ci, c’est juste le pourquoi. Le reste de la série n’a de sens que si je suis honnête sur cette partie d’abord.

Une prise que je sais faire, un nom que je n’arrive pas à dire

J’ai fait du judo enfant et adolescent, puis j’ai arrêté. Pendant une vingtaine d’années je n’ai pas remis un pied sur un tatami. Il y a quelques mois j’ai recommencé, dans un club ici au Canada, et la mémoire musculaire est revenue plus vite que j’avais le droit d’espérer. Pas les noms. La forme d’une prise, c’est le genre de chose que le corps n’oublie pas vraiment. Le vocabulaire autour des prises, c’est exactement le genre de chose qu’un trou de vingt ans efface.

La ceinture noire, c’est la raison de fond pour laquelle tout ça compte. L’exigence technique est à peu près la même des deux côtés de l’Atlantique : il faut connaître les 40 Gokyo no Waza, l’ensemble classique de prises codifié au Kodokan, en cinq groupes de huit. Il faut pouvoir nommer une technique, la démontrer, la reconnaître quand quelqu’un d’autre l’exécute, et expliquer dans quel cas elle fonctionne. Je ne suis pas au passage de grade. Je suis dans la partie d’avant le passage, là où vous arrêtez de vous mentir sur ce que vous savez vraiment.

La version honnête de l’endroit où j’en étais, quelques semaines après avoir repris, ressemble à peu près à ça. Je savais faire la plupart des 40 prises. Donnez-moi un partenaire, un kumikata, et je vais faire passer une version potable de la technique. Ce que je ne savais pas faire de façon fiable, c’était les nommer. Montrez-moi une image fixe ou un court extrait vidéo et demandez-moi laquelle c’est, et je bloquais sur à peu près la moitié. Le premier kyo était correct parce que c’est celui qu’on travaille le plus. Le cinquième était une catastrophe. Les trois du milieu, c’était à pile ou face. Je sentais la forme d’une prise dans mon corps sans que ma bouche ait l’étiquette.

L’autre chose qu’une absence de vingt ans vous fait, c’est que vous arrivez dans un club et les personnes qui sont visiblement plus jeunes que vous, parfois de beaucoup, connaissent les noms mieux que vous. Ce n’est pas une plainte. C’est la réalité de reprendre à la fin de la trentaine à côté d’adolescents qui sont sur le tatami toutes les semaines depuis qu’ils marchent. Il y a quelque chose de très utile dans ce décalage : ça remet l’ego à sa place dans le bon sens et ça vous dit exactement quels devoirs vous avez à faire. Les miens, ce n’étaient pas les prises. C’était le vocabulaire attaché aux prises.

Ce trou est embêtant parce que c’est exactement le trou entre pratiquer le judo et savoir le judo. C’est aussi le trou que les jurys de passage de grade vont gratter en premier. On ne va pas vous demander d’inventer une prise. On va vous demander de nommer et d’exécuter celle qu’ils ont choisie. Donc le trou était précis, l’objectif était précis, et la solution était précise : il me fallait travailler la reconnaissance et le rappel, pas la technique. La reconnaissance, c’est essentiellement de la mémoire. Et la mémoire aime la répétition.

Ce que je n’ai pas essayé avant d’écrire la moindre ligne de code

La version honnête de cette section, c’est que j’ai sauté l’étape où vous essayez les options ennuyeuses d’abord.

Je n’ai pas fabriqué de flashcards papier. Je n’ai pas installé Anki. Je n’ai pas téléchargé trois applis de référence judo sur le store pour essayer sincèrement de réviser avec pendant deux semaines. J’avais une image claire dans la tête de la forme que je voulais, je savais assez bien comment cette forme se construit, et le chemin de moindre résistance pour moi, spécifiquement, c’était de l’écrire. Ce n’est pas le conseil standard qu’on donne à quelqu’un avec un problème d’apprentissage, et si vous n’êtes pas développeur le meilleur conseil est sincèrement “utilisez Anki pendant un mois avant de construire quoi que ce soit.” Mais je suis développeur, la friction entre “je veux ce truc” et “j’ai une version qui marche de ce truc” est beaucoup plus basse pour moi que pour la plupart des gens, et j’ai livré assez de side projects pour savoir lesquels survivent. Ceux qui survivent, ce sont ceux que j’utilise tous les jours. Donc la vraie question que je me suis posée, ce n’était pas “est-ce qu’il existe une appli qui fait ça.” C’était “est-ce qu’il existe une appli que j’ouvrirais tous les jours.” C’est une barre beaucoup plus basse, et la réponse était quand même non, donc j’ai commencé à construire.

Ce que je voulais, c’était la forme Duolingo. Une notification quotidienne, une session courte, une série que je culpabiliserais un peu de casser, plusieurs modes de jeu pour que le même contenu reste intéressant, et des statistiques assez honnêtes pour me dire quelles prises je rate systématiquement. Aucune des applis de judo que j’avais regardées n’avait cette forme, et les outils de mémorisation génériques qui ont cette forme ne sont pas pré-chargés avec le Gokyo, les kanji, le romaji, les noms français et une vidéo de démonstration sélectionnée pour chaque prise. Le contenu, c’était le boulot. Une fois que vous vous engagez à construire le contenu, autant construire l’interface autour que vous avez vraiment envie d’utiliser.

Une inspiration plus ancienne : le quiz de verbes allemands de mon père

La forme de cette appli n’a rien d’original. L’idée n’est même pas de moi au sens strict, parce que je n’ai pas eu à l’inventer. Quand j’étais à l’école je devais apprendre les verbes forts allemands, les irréguliers, la longue liste devant laquelle tout étudiant de la langue soupire à un moment donné. Mon père, qui est aussi développeur, m’avait codé un petit programme qui tirait au hasard une sous-série de verbes et me testait dessus. Mon niveau d’allemand n’a jamais atteint des sommets, ce qui est de ma faute et pas celle du programme, et pour être honnête j’ai perdu la plupart des verbes forts aussi. Ce qui est drôle, c’est que la seule chose dont je me souviens clairement de toute cette période, c’est le programme, pas le contenu qu’il était censé me faire rentrer dans la tête. Quel que soit ce que ce petit outil a accompli ou non, la technique (donner à l’enfant un quiz quotidien sur une liste fermée et laisser le hasard faire le travail) est entrée en stockage long terme dans ma tête et y est restée. KataMarrant a la même forme, appliquée à une autre liste fermée, par l’enfant en question, qui écrit maintenant ses propres programmes.

Pourquoi je suis la bonne personne pour construire ça (et pourquoi c’est tout l’enjeu)

La réponse ennuyeuse à “pourquoi tu construis encore une appli” c’est : c’est mon métier. J’ai passé la dernière décennie à livrer du logiciel multiplateforme, dont quelques années à construire des applis haptiques et d’entraînement avec une couche de gamification chez Haply, où le cœur du job c’est de prendre une compétence sérieuse, la décomposer en petites répétitions, et faire en sorte que la personne ait envie de faire ces répétitions. La combinaison “je sais ce qui rend une appli quotidienne addictive” et “j’ai un grade personnel à préparer” est suffisamment rare dans ma propre vie pour que ne pas construire ça aurait été du gâchis.

Il y a une réponse plus honnête en dessous. Les side projects fonctionnent pour moi quand ils sont sur le même axe que quelque chose qui me tient déjà à cœur. J’ai une pile de projets persos abandonnés qui sont morts parce qu’ils étaient techniquement intéressants mais personnellement non pertinents. Ceux qui survivent, dont mon homelab, le tableau de bord de la salle de bain, et maintenant KataMarrant, survivent parce que j’utilise vraiment le résultat tous les jours. Le projet n’a pas besoin d’être ambitieux pour vivre. Il faut qu’il soit utile à une personne précise, et cette personne, c’est moi. Construis pour une audience d’une seule personne, et la boucle de feedback quotidienne te dicte les priorités toute seule.

Je me suis donné un cahier des charges serré. Multiplateforme, parce que je le veux sur mon téléphone et sur mon poste fixe. Offline-first, parce que je ne voulais pas d’un outil que je suis censé ouvrir tous les jours qui exige que je crée un compte d’abord. La synchronisation entre téléphone et poste fixe est utile, et l’appli la supporte, mais elle est optionnelle et n’est pas activée par défaut. Lancement instantané, parce que le moment où un quiz prend plus de temps à s’ouvrir que mon attention dure, la série est morte. Open source, parce que je ne construis pas une boîte, je construis un outil, et je préfère que quelques autres judokas l’améliorent que de garder la porte fermée.

Ce que KataMarrant est vraiment

La description la plus courte qui tient sur le côté d’une carte : un quiz de fiches de judo pour les 40 Gokyo no Waza, sur tous mes appareils, que je vais vraiment ouvrir tous les jours.

Une question de quiz. L’illustration vient de la planche Gokyo no Waza sur Wikimedia Commons, par Mtwist (CC BY-SA). Le panneau de réponse affiche le nom en romaji, le kanji, la traduction française littérale, et un lien vers une vidéo de démonstration sélectionnée.

La boucle de base est celle qu’on attend. L’appli me montre une technique, me demande lequel des trois noms correspond, et me dit si j’ai bon. Bonne réponse, le score de maîtrise de la technique monte. Mauvaise réponse, elle revient plus souvent dans les sessions suivantes. Il y a un cooldown de six questions pour que la même prise ne tombe pas deux fois de suite, même si c’est la pire de ma liste. Le mode reconnaissance affiche une illustration fixe. Le mode audio joue un clip enregistré du nom et me demande de choisir la bonne description, ce qui est brutal de manière utile : ça force le romaji dans mon oreille, pas seulement dans mon œil.

Il y a quatre points d’entrée sur l’écran d’accueil, et c’est un petit choix qui s’est avéré plus important que je ne l’avais prévu.

Une question est le bouton le moins coûteux à appuyer. Pour les moments où j’ai moins de trente secondes. J’ouvre l’appli, je réponds à une question, je referme. C’est suffisant pour garder la série en vie.
Rafale (10) est une volée de dix questions. C’est l’échauffement que je fais dans le métro. C’est le mode le plus utilisé de loin, ce que je n’avais pas prédit.
Drill (chrono) est un mode chronométré avec une barre qui descend pour chaque question. Pour les moments où j’ai déjà révisé et où je veux me tester sous un peu de pression. C’est aussi là que vit la variante audio.
Parcourir les 40 techniques est le mode de référence. Le catalogue complet, classé par kyo, avec le romaji, le kanji, la traduction française et une vidéo de référence intégrée pour chacun. Je m’attendais à ce que ce soit la fonctionnalité phare. C’est l’écran le moins ouvert de l’appli. Les gens qui veulent apprendre les noms veulent qu’on les leur demande, pas les lire.

Un compteur de série, un objectif quotidien (j’ai pris dix questions, libre à chacun d’ajuster), un système de niveau lié à une petite courbe d’XP, et une grille de succès à débloquer occupent l’écran d’accueil. Rien de tout ça n’est neuf. C’est emprunté à une décennie d’applis d’apprentissage des langues, d’applis de fitness et de jeux mobiles qui ont déjà résolu le problème de faire revenir un humain demain. L’emprunt est exactement le but.

Le poste fixe n’est pas une option en plus

Interface desktop. Même base SQLite, même logique de quiz, mise en page différente. Tauri 2 me permet d’expédier le même cœur Rust sur Windows, macOS, Linux, Android et iOS sans codebase séparée.

Une appli de judo, c’est évidemment une appli mobile-first. J’ai failli ne pas faire la version desktop, puis je l’ai construite quand même, et maintenant la fenêtre desktop est l’endroit où je fais mes sessions de révision plus longues. La raison, c’est la synchronisation. Si je me teste pendant trente secondes le matin sur le téléphone et que je m’assois à mon bureau le soir pour préparer un cours, les mêmes prises que j’avais ratées au petit-déjeuner remontent à la surface au bureau. Les scores de maîtrise me suivent d’un appareil à l’autre. C’est utile d’une manière qu’un widget d’écran d’accueil sur un seul appareil ne peut pas être.

La réponse technique à “comment c’est sur tous les supports” c’est Tauri 2, qui me permet d’expédier le même cœur Rust et le même frontend JS vanille sur Windows, macOS, Linux, Android et iOS. Le frontend n’a pas d’étape de build. Le backend parle à une petite base SQLite pour les stats et un journal de quiz. La synchronisation est optionnelle, par lien magique, sans mot de passe, hébergée sur un petit service Rust que je tourne moi-même. Je raconterai ça correctement dans le prochain billet de la série.

Un mode drill qui m’a fait comprendre pourquoi le quotidien compte

Mode drill, variante audio. L’appli prononce le nom de la technique, dix secondes pour choisir la bonne description, et la barre du haut se vide. Brutal au début. Efficace.

Le mode drill est l’endroit où le truc de gamification que j’ai emprunté à Haply tape le plus fort. Le mécanisme en lui-même est banal : un chrono, une série interne à la session, un succès quand on enchaîne dix bonnes réponses d’affilée en mode audio (le succès s’appelle Sensei silencieux, et oui, c’est censé être une petite blague). Ce qui n’est pas banal, si vous n’avez pas déjà vécu avec ce genre de mécanisme, c’est la vitesse à laquelle un drill quotidien de deux minutes cesse d’être une chose que vous devez vous rappeler de faire et devient une chose que vous attrapez dès que vous avez une poche de temps libre.

Quelques jours plus tard, le tableau de bord me dit déjà quelque chose d’utile. Certains groupes avancent et d’autres pas. Je progresse sur des morceaux de la liste, pas sur la totalité, et je vois exactement lesquels. Je savais que le trou existait, de manière floue, avant. Le graphique le rend précis. Le simple fait de construire quelque chose de mesurable sur ma propre progression était, en soi, une chose que je n’aurais pas pu obtenir avec des flashcards papier.

Voilà le pourquoi du projet. La ceinture noire, c’est la destination. Le trou Gokyo, c’est le problème qui est devant moi tout de suite. Réviser sur le téléphone tous les jours avec un outil que j’ouvre vraiment, c’est la solution. Le construire au lieu de l’acheter, c’est en partie parce qu’aucune appli sur les stores n’avait la forme exacte que je voulais, et en partie parce que le genre de travail que je fais en journée, c’est exactement le genre de travail qui transforme “ça serait cool s’il existait une appli pour ça” en appli qui marche, en quelques week-ends. Les side projects survivent quand ils sont utiles à une vraie personne tous les jours, et quand cette personne est aussi celle qui peut les construire. C’est tout le pitch de KataMarrant. Le reste de la série, c’est le build.

La suite de la série

Dans le prochain billet, je rentre dans le build. Tauri 2 est sincèrement bon et un peu maudit dans la même phrase, et il y a une poignée de décisions que j’ai prises qui m’auraient fait gagner une semaine si je les avais connues le premier jour. Sujets que je veux couvrir, à peu près dans l’ordre où ils m’ont mordu :

Du JS vanille plutôt qu’un framework, et pourquoi le frontend sans étape de build est le bon choix pour une appli de cette taille.
De la répétition espacée sans bibliothèque : la quantité étonnamment petite d’arithmétique qui rend le quiz adaptatif sans devenir pénible.
Authentification par lien magique et serveur de sync en Rust, sans mot de passe stocké nulle part, jamais.
Notifications locales sur Android via un plugin Tauri maison qui enveloppe WorkManager, et le chemin iOS équivalent qui m’a fait pousser la barbe.
Mettre une appli personnelle sur le Play Store, et à quel point ce processus est déraisonnablement long et pénible pour un side project d’une seule personne. Les pièges précis dans lesquels je suis tombé pour que vous puissiez les éviter.

Si l’un de ces sujets vous intéresse, le code est sur github.com/Leicas/KataMarrant et il y a une page projet correspondante sur ce site.

Les illustrations des techniques dans l’appli sont extraites de la planche Gokyo no Waza par l’utilisateur Wikimedia Mtwist, sous licence CC BY-SA. Les vidéos de référence sont sélectionnées par l’excellent judo.how. Les noms et les kanji sont les noms standards. Aucun de ce travail n’est affilié au Kodokan ni à une fédération de judo. C’est un outil d’entraînement personnel, écrit par un judoka pressé, pour un judoka pressé.

Judo | Antoine Weill--Duflos