:uk: English README :uk:

Lunii.QT

Une application Python QT pour gérer sa fabrique à histoires (fah) <u>Lunii</u> et <u>Flam</u>, avec les opérations de organisation / importation / exportation / téléchargement du firmware
pour Windows 11 / MacOs (11 BigSur => 26 Tahoe) / Linux
(compatible avec les archives STUdio, avec support de la conversion audio)

FAQ : Veuillez consulter les questions déjà posées dans la section Discussions, ou les Issues pertinentes.

Nouveautés

• 😎 Flam support 😎
  L'application permet désormais d'importer les histoires Lunii sur votre Flam, sous réserve qu'elle soit en firmware v2.x.x

  Attention : la Flam est TRES lente en usb. Il faut etre patient. (environ 4min pour 80Mo)

• 😎 Lunii v3 & Firmware 3.2.x 😎
  Lunii.QT a été mis à jour pour prendre en charge le dernier firmware (3.2.2 et suivants). Grâce à une analyse approfondie (j’aurais dû connecter les neurones et réfléchir 10 minutes de plus à la premère analyse), une solution stable et TRÈS simple a été trouvée.
  Oubliez toutes les anciennes manipulations concernant les fichiers .md et le firmware.

  Rappel : Gardez précieusement vos fichiers firmware v3 (vous pourrez toujours rétrograder) et évitez les mises à jour automatiques.

Matériels pris en charge :

• Fah v1 et v2 (support complet)
• Fah v3 (fichiers md v6 et v7 supportés, sauvegardes personnelles uniquement)
• Flam (support complet, sauvegardes personnelles uniquement)

Limitations :

• L'application <u>n'autorise plus</u> d'exporter les histoires officielles pour les Lunii, à cause du piratage.
  Les Flams <u>pourront</u> sauvegarder et restaurer leurs histoires mais ne fonctionneront que sur le device d'origine.
• Le transcodage audio nécessite la présence de FFMPEG

Table des matières

<!-- TOC -->

• Lunii.QT
  • Interface Utilisateur
    • Fenêtre principale
    • Mode Nuit
  • Raccourcis clavier
  • Fonctionnalités
  • Transcodage audio
  • Mise à jour du firmware
  • Formats d'archives pris en charge
    • pour Lunii
    • pour Flam
  • Python ? Guide Pratique
    • Préparation de l'environnement
    • Génération des UI
    • Génération des fichiers de tranduction
    • Génération du fichier de ressource
    • Exécution
    • Générer un exécutable GUI
  • Astuces
    • macOS - Authorisation de l'application
    • Métadonnées des histoires non-officielles
    • Gestion du cache
    • Dépendances manquantes sous Linux
    • Exportation V3
    • Création de l'ICO
  • Remerciements
• Liens / Dépôts similaires

<!-- TOC -->

Interface Utilisateur

<img src="./res/screenshot_about.png" width="450"><br>

<img src="./res/screenshot_main.png" width="600"><br>
<img src="./res/screenshot_nm_off.png" width="300"><img src="./res/screenshot_nm_on.png" width="300"><br>
<img src="./res/screenshot_debug.png" width="600">

Fenêtre principale

<img src="./res/screenshot_interface.png" width="600">

1. La barre de menu. Elle vous informera lorsqu'une mise à jour de l'application est disponible
   (il suffit d'aller dans Menu About/Update to v2.X.X)

2. L'emplacement de votre Lunii/Flam lorsqu'elle est connectée.
   Le bouton à gauche relance la détection automatique.

3. Gestion du Mode nuit (ici)

4. Actualisation de la base de données Officielle : Met à jour la liste des histoires et leurs descriptions depuis le Luniistore. Utilisez ce bouton lorsque certaines histoires officielles ne sont pas reconnues.

5. La liste de vos histoires avec l'UUID et le type d'histoire (DB).
   L'UUID : Un identifiant unique permettant de lier les histoires à leur dossier sur la Lunii/Flam. Les huit derniers caractères de l'UUID composent le nom du dossier de l'histoire.

   DB signifie Base de données. Cette application prend en charge deux bases de données différentes

   • O - Base de données Officielle de Lunii
     (Toutes les métadonnées proviennent des serveurs de Lunii).
   • T - base de données Tierce, également connue sous Non officielles ou Custom
     (Ces métadonnées ne peuvent pas être récupérées, elles sont complétées lors de l'importation de l'histoire)

6. L'icône 🛏️ indique que l'histoire supporte le Mode Nuit. Il est possible de forcer ce status depuis le menu contextuel

7. Histoires cachées (les entrées grisées dans la liste).
   Cette fonctionnalité est activable par le biais du menu contextuel sur une histoire.
   Son usage est double:

   1. Masquer certaines histoires pour éviter que l'enfant ne passe trop de temps à sélectionner une histoire le soir. Cela évite de la supprimer et la recopier de nouveau.
   2. Eviter la suppresion d'histoires non officielles pendant une synchronisation avec l'application Luniistore. Les histoires cachées sont toujours physiquement présente dans l'appareil, mais ne seront pas visible par Luniistore. N'oubliez pas de bien "cacher" vos histoires avant de cliquer sur "synchroniser" !

8. Dans la barre d'état, vous trouverez

   • Votre SNU (numéro de série),
   • La version du firmware de votre Lunii/Flam
   • L'espace disponible sur la SD
   • Le nombre d'histoires

Mode Nuit

<img src="./res/screenshot_nm_off.png" width="300"><img src="./res/screenshot_nm_on.png" width="300">

Raccourcis clavier

| Keys | Actions | |----------------|-----------------------------------------------------| | Ctrl+Up | Déplace la ou les sélection(s) en première position | | Alt+Up | Déplace la ou les sélection(s) vers le haut | | Alt+Down | Déplace la ou les sélection(s) vers le bas | | Ctrl+Down | Déplace la ou les sélection(s) en dernière position | | | | | Ctrl+I | Importe une nouvelle histoire | | Ctrl+S | Exporte la sélection | | Ctrl+Shift+S | Exporte toutes les histoires | | Ctrl+H | Masquer/Démasquer les histoires sélectionnées | | Ctrl+N | Forcer le mode nuit d'une histoire | | Delete | Supprime les histoires sélectionnées | | | | | Ctrl+O | Ouvre le dossier d'une Lunii/Flamm | | Ctrl+L | Ouvre la fenêtre de debug | | Ctrl+Q | Fermer l'application | | F1 | À propos de l'application | | F5 | Réactualise les appareils |

Fonctionnalités

• Détection automatique des Mises à jour
• Import / Export / Suppression des histoires
• Support des archives au format STUdio, et importez la base d'histoire de STUdio
• Réorganisez vos histoires dans votre ordre préféré
• Gérer le mode nuit
• Cachez les histoires
  Dans le but de ne pas subir une suppression forcée des histoires non officielles durant la synchronisation avec l'application Luniistore, vous pouvez désormais "cacher" temporairement certaines histoires
  (tous les fichiers sont conservés sur l'appareil)
• Histoires perdues
  Trois nouveaux outils sont proposés pour gérer vos histoires perdues.
  (souvent suite à un crash d'une autre application 😜)
  Vous pouvez :
  • les lister
    (l'application tentera de réparer les histoires, en particulier les fichiers sur les Lunii v1/v2)
  • les récupérer (si elles sont saines)
  • les supprimer (attention, les fichiers seront supprimés)
• Récupération du Firmware pour votre appareil (cf. cette section)

Transcodage audio

Certaines histoires tierces utilisent des fichiers non MP3. Ils ne peuvent donc pas être installés tels quels sur Lunii. Cela nécessite une étape de transcodage. Ce processus supplémentaire est réalisé à l'aide de l'outil FFMPEG disponible ici

ATTENTION : le transcodage est <u>très long</u>, il faut être patient. C'est pourquoi vous devriez préférer le format .plain.pk qui utilise un format audio compatible.

Installation

Windows & MacOS

NOTE 1 : Le binaire de FFMPEG ne sera pl