Koito

Koito est l’outil principal de suivi de l’historique d’écoute musicale personnel, dans le même esprit que Last.fm mais entièrement auto-hébergé, avec des statistiques mises à jour en temps réel plutôt que selon le cycle mensuel habituel des plateformes en ligne. Les données d’écoute peuvent être filtrées par semaine, année ou depuis toujours, et une fonction de rewind fait ressortir des récapitulatifs mensuels ou annuels. Maloja tourne à ses côtés comme tracker secondaire de sauvegarde pour les mêmes données d’écoute.

Son historique d’écoute est sauvegardé chaque nuit en reprenant la même logique que le rôle koito_backup : authentification auprès du point de terminaison /apis/web/v1/export de Koito avec un en-tête Authorization basé sur un jeton, téléchargement de l’historique complet en un seul export JSON, puis écriture sur les deux NAS sous le nom koito_export_<horodatage>.json, en ne conservant que les 5 dernières sauvegardes par NAS. L’exécution nocturne elle-même est un script shell autonome déployé par cron_configuration, car une tâche cron ne peut pas fournir le mot de passe become interactif dont Ansible a besoin. Le rôle koito_backup reste utile pour lancer la même sauvegarde manuellement, à la demande.