doot

Un squelette trompettiste surgit au hasard sur ton écran, joue son petit air, puis disparaît.

Uniquement du 1er septembre au 31 octobre inclus. Le reste de l'année, le programme tourne mais reste sagement endormi : le squelette range sa trompette.

                                        d    o    o    t   !
            .-"""""""-.
          .'           '.
         /   .-.   .-.   \
        |   ( o ) ( o )   |                  .-----.
        |       ___       |             ,--''       '.
        |      /   \      |            /             \
        |     |=====|     |   ,-------'               |
         \    |||||||========(                        |
          '.  |||||  .'       '------.                |
            '-._____.-'               \              /
             /|     |\                 '--.        ,'
            / |     | \                     '-----'

• Multiplateforme : Windows 10/11, macOS, Linux (Arch, Debian/Ubuntu, Fedora, openSUSE…)
• Zéro dépendance : uniquement la bibliothèque standard de Python 3.8+
• Discret : overlay sans bordure, qui ne vole jamais le focus et — sous Windows — laisse passer les clics de souris. Il ne bloque rien, il fait juste doot.
• Multi-écrans : les moniteurs sont énumérés pour de vrai (Win32, RandR, CoreGraphics), le squelette surgit sur l'un d'eux au hasard, jamais à cheval entre deux dalles ni sous la barre des tâches.
• Deux façons d'arriver, tirées au sort : il surgit au milieu de l'écran, ou il glisse depuis l'un des quatre bords en pivotant pour avoir les pieds sur le bord d'où il vient — entré par le haut, il arrive tête en bas.
• Son spatialisé : le doot sort du côté où le squelette est apparu, calculé sur l'ensemble du bureau — collé à droite de l'écran de droite, il sonne franchement à droite.
• Prêt à l'emploi : le squelette et son doot sont livrés avec ; dépose ton propre PNG/GIF ou mp3 pour les remplacer, sans toucher au code.
• Saisonnier : la fenêtre du 1er septembre au 31 octobre est appliquée par le programme lui-même, pas seulement par le planificateur.

🛑 Au secours, faites-le taire

Pas de panique, rien n'est installé en profondeur et aucun droit administrateur n'a été demandé. Trois niveaux, du plus doux au plus définitif :

doot --stop        # arrête le programme qui tourne, tout de suite

./uninstall.sh     # Linux / macOS : désinstalle tout, y compris le démarrage auto

powershell -ExecutionPolicy Bypass -File .\uninstall.ps1   # Windows

Ajoute --purge (Linux/macOS) ou -Purge (Windows) pour effacer aussi le dossier de données. Tu n'as plus le dépôt sous la main ? Tout se retire à la main :

Envie de le garder mais en plus discret ? doot --min 7200 --max 28800 espace les apparitions de 2 à 8 heures, et --no-sound le rend muet.

Installation

Depuis PyPI, sur les trois systèmes

Le paquet s'appelle spooky-doot, parce que doot était déjà pris. La commande, elle, reste doot.

Pour voir le squelette tout de suite, sans rien installer :

uvx --from spooky-doot doot --once --ignore-season

Un doot, et rien d'installé. Le paquet passe quand même par le cache de uv, que uv cache clean vide. --ignore-season force l'apparition : sans lui, doot répond qu'il est en congé jusqu'au 1er septembre et ne montre rien.

Pour l'installer pour de bon :

uv tool install spooky-doot

Il te faut uv pour ces deux commandes : un binaire autonome, qui ne réclame rien d'autre que lui-même, pas même un Python. Ta distribution l'a peut-être déjà — il est dans extra chez Arch et dans les dépôts Fedora. Sinon brew install uv sur macOS, winget install --id=astral-sh.uv -e sur Windows, ou curl -LsSf https://astral.sh/uv/install.sh | sh sur Linux et macOS.

Pas envie d'ajouter uv ? pipx install spooky-doot fait la même chose si tu as déjà pipx, la différence étant que pipx a besoin d'un Python pour tourner. Et pip install spooky-doot marche aussi, même si un environnement dédié vaut mieux pour un outil qu'on lance.

Ça installe la commande et les médias, mais pas le démarrage automatique. Pour que le squelette revienne tout seul à chaque session, il faut les scripts ci-dessous — ou lancer doot toi-même.

Linux (dont Arch) et macOS

git clone https://github.com/boubou666/doot.git
cd doot
./install.sh

Le script copie le code dans ~/.local/share/doot/app, crée la commande ~/.local/bin/doot, puis configure le démarrage automatique : systemd --user si disponible, sinon une entrée XDG autostart, et un LaunchAgent sur macOS.

Options : ./install.sh --no-autostart, --min 300, --max 1800.

Prérequis système (install.sh te le dira si quelque chose manque) :

Pour lire des mp3 sous Linux il faut un lecteur qui gère le compressé : mpv, ffmpeg (ffplay), sox ou vlc. Les .wav passent partout.

Arch Linux, via un paquet

cd packaging
makepkg -si
systemctl --user enable --now doot.service

Windows

git clone https://github.com/boubou666/doot.git
cd doot
powershell -ExecutionPolicy Bypass -File .\install.ps1

Python 3.8+ est requis (winget install -e --id Python.Python.3.12, en cochant « tcl/tk »). Le script installe dans %LOCALAPPDATA%\Programs\doot, ajoute la commande doot au PATH utilisateur et place un raccourci dans le dossier Démarrage. Aucun droit administrateur, aucun composant système modifié.

Sans installer (test rapide)

python3 -m doot --once --ignore-season

Versions

Les évolutions sont consignées dans le CHANGELOG, au format Keep a Changelog. Chaque étiquette vX.Y.Z publie une release automatiquement, avec les notes tirées du changelog et les paquets Python construits.

Mettre à jour

Une fois installé, doot se met à jour tout seul, sur les trois systèmes :

doot --check-update    # dit si une version plus récente existe
doot --update          # récupère, réinstalle, relance le daemon

--update relit la fiche déposée par l'installeur (install.json, dans le dossier de données) pour retrouver d'où le code vient et avec quelles options il avait été installé, puis rejoue l'installeur avec les mêmes réglages. Le daemon est arrêté le temps de l'opération et redémarré derrière.

Deux façons de récupérer le code, dans cet ordre : si le dépôt cloné est toujours là, un git pull --ff-only ; sinon l'archive de la branche principale est téléchargée depuis GitHub. La seconde voie ne demande ni git ni le clone d'origine, donc une installation dont tu as effacé le dossier depuis se met à jour quand même.

Tes sons, tes images et ton journal ne sont pas touchés : ils vivent dans le dossier de données, l'installeur ne remplace que le code.

Si doot a été installé par un gestionnaire de paquets (le PKGBUILD d'Arch, par exemple), --update refuse et te renvoie vers pacman -Syu plutôt que d'écraser des fichiers qui ne lui appartiennent pas.

Utilisation

doot                         # lance le daemon (c'est ce que fait le démarrage auto)
doot --once                  # un doot tout de suite, puis on quitte
doot --once --ignore-season  # idem, même hors saison : pratique pour tester
doot --status                # saison, daemon, son et image utilisés
doot --stop                  # arrête le daemon
doot --paths                 # où sont les fichiers
doot --screens               # liste les écrans détectés
doot --check-update          # une version plus récente existe-t-elle ?
doot --update                # met à jour et réinstalle
doot --art                   # imprime le squelette dans le terminal

Les médias

doot est livré avec le squelette et le son qu'on attend : doot/assets/doot.png et doot/assets/doot.mp3, installés d'office. C'est le mème skull trumpet (« doot doot »), qui circule un peu partout depuis 2010 ; il est inclus pour que ça marche du premier coup. Si tu es l'ayant droit et que ça te dérange, ouvre une issue et je les retire.

Trois niveaux de repli, dans cet ordre : tes fichiers → les fichiers fournis → l'ASCII art et le jingle synthétisé maison (harmoniques, vibrato, enveloppe ADSR), utilisés notamment sur un Linux sans lecteur mp3.

Mettre les tiens

doot --paths        # affiche les deux dossiers ci-dessous

• Image → dossier image/ : un .png ou un .gif (les GIF animés sont joués en boucle). Prends une image détourée, à fond transparent : sous Windows le fond disparaît complètement et le squelette flotte sur le bureau. Plusieurs fichiers ? Un est tiré au hasard à chaque apparition.
• Son → dossier sound/ : .wav, .mp3, .ogg, .flac, .m4a, .opus. L'affichage s'allonge automatiquement pour couvrir toute la durée du son.

Tes fichiers passent devant ceux fournis, et ils sont relus à chaque apparition : tu peux les changer pendant que le daemon tourne. Pour revenir au dessin ASCII et au jingle synthétisé : doot --no-image --regen-sound (ou vide les deux dossiers et supprime doot/assets/).

Les deux façons d'arriver

Il y en a deux, tirées au sort à chaque apparition :

• au milieu, comme depuis toujours : il surgit sur place, à un endroit quelconque de l'écran, droit, en fondu ;
• par un bord, en glissant depuis l'extérieur.

Une fois sur deux par défaut. --slide-chance règle la proportion — 0 pour n'avoir que des apparitions sur place, 1 que des entrées par un bord, 0.8 pour surtout des entrées :

doot --slide-chance 0.8

L'entrée par un bord

Le squelette glisse depuis un bord de l'écran jusqu'à sa position de repos. Le mouvement est vif au départ et se pose en douceur — une décélération cubique sur 420 ms par défaut.

L'image pivote pour que son bas se pose contre le bord par lequel elle entre : le squelette a toujours les pieds sur le bord d'où il vient.

Il s'arrête contre ce bord, à quelques pixels près. Il ne s'enfonce pas dans l'écran : ce serait une traversée, pas une entrée.

doot --once --side left      # entre par la gauche
doot --once --side top       # tombe du haut, tête en bas
doot --once --slide-ms 900   # entrée plus lente
doot --once --no-slide       # apparaît sur place, comme avant

Le squelette ASCII, lui, ne pivote pas : des glyphes à chasse fixe tournés d'un quart de tour ne veulent plus rien dire. Il est simplement retourné quand il entre par la droite — les obliques et les parenthèses basculent, et les lettres du doot changent de côté sans cesser d'être lisibles.

Pendant le glissement il n'y a pas de fondu d'apparition : le bord de l'écran révèle déjà le squelette, et les deux ensemble font bouillie.

Le son spatialisé

Le doot sort du côté où le squelette est apparu. La position est calculée sur tout le bureau virtuel, pas sur un écran isolé : avec deux dalles côte à côte, un squelette collé au bord droit de celle de droite sonne franchement à droite, et pas au centre comme s'il était seul au monde.

Le canal dominant reste à plein volume, seul le canal opposé est atténué. Un doot centré rend donc exactement le son d'origine, sans les 3 dB qu'un panoramique à puissance constante lui aurait coûtés.

Comment c'est appliqué, selon ce que la plateforme sait faire :

Les WAV sont traités par doot lui-même, ce qui marche partout et avec n'importe quel lecteur. Pour les formats compressés il faut un intermédiaire capable de le faire : MCI sous Windows, un filtre pan sous Linux. Quand rien ne sait, le son est joué au centre plutôt que pas du tout.

--no-pan désactive tout ça.

Où sont les fichiers

doot --paths affiche tout. Par défaut :

Il contient image/ et sound/ (tes médias), doot.wav (le jingle en cache), doot.log (le journal) et doot.pid.

Dépannage

Rien ne s'affiche → doot --status. Si tkinter manque, installe le paquet du tableau ci-dessus. Sous Wayland, l'overlay passe par XWayland ; si ton compositeur le refuse, lance la session en X11 ou utilise --center.

Pas de son → doot --status indique le lecteur détecté. Sous Linux il faut au moins un de mpv, ffplay, play, cvlc (tous formats) ou pw-play, paplay, aplay (wav). Sans aucun, doot s'affiche en silence plutôt que de planter.

Mon image ne s'affiche pas → tkinter ne lit que le PNG et le GIF. Convertis ton jpg/webp, par exemple avec ffmpeg -i image.webp image.png. Une image illisible fait simplement revenir l'ASCII art.

Il n'apparaît que sur un seul écran → doot --screens liste ce que doot détecte. Sous Linux, doot interroge RandR directement sur la socket X, sans rien à installer. Sous Wayland pur, sans XWayland, il n'y a pas de socket X à interroger et tout le bureau reste vu comme un seul écran ; fixe alors la cible avec doot --screen 0. Avec des écrans à facteurs d'échelle différents sous Windows, la position peut se décaler un peu : --screen primary évite le problème.

Le fond n'est pas transparent (Linux) → il faut un compositeur actif (picom, KWin, Mutter…). Sinon le squelette s'affiche sur un fond sombre.

Ça ne se déclenche jamais → on est peut-être hors saison. doot --status te dit la date de réouverture. Pour vérifier que tout marche : doot --once --ignore-season.

Le daemon ne redémarre pas à la session → systemctl --user status doot (Linux), launchctl list | grep doot (macOS), ou vérifie le raccourci dans shell:startup (Windows).

Tests

La suite est en unittest, donc elle tourne sans rien installer :

python -m unittest discover -s tests -v

Elle couvre les bornes de la saison, le placement multi-écrans, la synthèse du jingle et le choix du son. Les tests du décodeur PNG comparent sa sortie à celle de Pillow, octet pour octet, sur neuf variantes de fichier (RGBA, RGB, gris, gris+alpha, palette 1/2/4/8 bits, avec et sans tRNS) ; ils se mettent en pause si Pillow ou doot/png.py est absent :

python -m pip install pillow    # pour activer les tests PNG

La CI rejoue tout ça sur Linux, Windows et macOS à chaque push et chaque pull request, vérifie qu'aucun doot ne s'affiche hors saison, et contrôle la syntaxe des quatre installeurs.

Comment ça marche

Le daemon tire un délai au hasard entre --min et --max, dort, vérifie que la saison est toujours ouverte, affiche le squelette, recommence. Hors saison, il se contente de revérifier la date toutes les heures.

Licence

Le code est sous licence MIT, ainsi que l'ASCII art et le jingle synthétisé, qui sont originaux.

Les fichiers de doot/assets/ sont l'exception : le mème skull trumpet n'est pas de moi et n'est pas couvert par la licence MIT du projet. Il est inclus par commodité ; retire-le si ton usage l'exige, et les médias que tu ajoutes toi-même restent soumis à leurs propres droits.