{{tag>multimedia logiciels_libres python base_de_donnees }}
{{ :memovue1.png?100|Icône de Piveo}}
====== Piveo (anciennement MemoVue) ======
===== Présentation =====
Ce **[[wpfr>logiciel libre]]**((Licence [[https://www.gnu.org/licenses/quick-guide-gplv3.fr.html|licence GPLv3]])) **et gratuit** fonctionne sous GNU/Linux et Windows. Piveo est une application de trombinoscope interactif (les personnes sont présentées une par une) permettant d’apprendre et de mémoriser les noms et prénoms associés aux visages.
{{ :accueil2.png?240 | Capture de Piveo }}
Vous devez retenir les prénoms, noms et visages de dizaines de personnes ? \\ Piveo vous aide à mémoriser efficacement grâce à 3 modes d'apprentissage : **lecture**, **devinette**, **écriture**, ainsi qu’un **mode de recherche**.
Cas d'usage :
* **Enseignants** : mémoriser l'identité de leurs élèves en début d'année ou après les vacances !
* **Managers, commerciaux, RH, événementiel** : connaître rapidement leurs contacts
*** Élus** : retenir vos collègues d'une commision, par exemple
et bien d'autres contextes professionnels...
Voici donc les trois organismes traités :
- **Ecole**
- **Entreprise**
- **Collectivité**
=== Technologies ===
* [[:python|Python3]]
* PySide6
* [[wpfr>SQLite]]
* OS testé: Ubuntu 24.04 LTS
=== Langues ===
Français (native), Anglais, Breton, Espagnol
=== Pourquoi Piveo ? ===
Tout simplement parce qu'en Breton "Piv eo ?" signifie "Qui est-ce ?".
=== Licence ===
Cette application est délivrée sous la licence GPLv3 : [[https://www.gnu.org/licenses/quick-guide-gplv3.fr.html|Licence GPLv3]].
===== Installation =====
L'installation se fait avec une [[:AppImage]].
Cette méthode ne permet pas de mise à jour automatique.
L'intégration au système (dont la création d'un [[:raccourci-lanceur|lanceur]]) doit aussi être faite manuellement.
Pour installer une **[[:AppImage]]** référez-vous avant tout au [[:appimage#installer_un_appimage|chapitre dédié]] au sujet.
En résumé téléchargez le fichier ''Piveo-//X.X.X//-x86_64.AppImage'' sur [[https://github.com/GerardLeRest/piveo/releases|GitHub]] (où ''//X.X.X//'' est le numéro de la dernière version), puis [[:permissions#modifier_les_permissions|rendez-le exécutable]] (clic droit sur le fichier -> //Propriétés// -> //Permissions// -> //Autoriser l’exécution//), ou en ligne de commande :chmod +x Piveo-X.X.X-x86_64.AppImage
Finalement [[:tutoriel:comment_lancer_application|lancez l'application]] en double-cliquant sur le fichier, ou en ligne de commande :./Piveo-X.X.X-x86_64.AppImage
Vous pouvez aussi utiliser un service tel que **[[:appimage#go_appimageappimaged|appimaged]]** pour créer automatiquement un [[:raccourci-lanceur|lanceur]].
===== Fonctionnement =====
{{:interface-piveo.png?500}}
L'application Piveo fonctionne de la manière suivante :
* Trois structures sont proposées : École, Entreprise, Parlement sur la page de garde).
* L’utilisateur choisit entre prénom+nom, nom ou prénom).
* Plusieurs modes de mémorisation sont disponibles : lecture (oeil), deviner(oeil barré), écrit(crayon).
* La partie gauche de l’interface permet de faire défiler les personnes tout en affichant leurs informations.
* Un mode de recherche (? sur l'interface) permet de retrouver une ou plusieurs personnes à partir de leur nom ou prénom.
Contrairement à un trombinoscope, l'application ne présente qu'une photo. Le trombinoscope n'utilise que **2** méthodes d'apprentissage de l'application: apprentissage par la lecture et apprentissage en masquant le prénom et le nom. Si on combine nom/prénom (3 possibilités), aléatoire (2 possibilités), mode d'apprentissage (3 possibilités), cela fait **18** possibilités.
===== Personnalisation automatique de la base de données =====
==== Méthode 1 ====
Cette nouvelle version simplifie beaucoup l’installation.
Il n’est plus nécessaire de construire la base de données manuellement, il suffit de **compléter trois fichiers [[wpfr>Comma-separated_values|CSV]]** :
* **personnes.csv**
* **specialite.csv**
* **personnes_specialites.csv** (ce fichier fait le lien entre les personnes et les spécialités qu'elles font).
Lorsque l’on sélectionne un organisme (par exemple //École//), les fichiers [[wpfr>Comma-separated_values|CSV]] correspondants sont créés automatiquement avec des données de base. Ils sont ensuite enregistrés dans le répertoire ''~/.local/piveo/fichiers/eleves'' sous GNU/Linux.
L'application utilise ensuite ces fichiers CSV pour construire automatiquement la base de données.
Il suffit alors de remplacer les données d’exemple des [[wpfr>Comma-separated_values|CSV]] par vos propres données, en conservant la structure des fichiers.
{{:csv1.png?800}}
==== Méthode 2 ====
Pas besoin d’être expert pour créer votre base de données. Nous allons simplement transformer des fichiers [[wpfr>Comma-separated_values|CSV]] (tableaux de données) en une base [[wpfr>SQLite]] en utilisant l'application **DBeaver**.
Aidez-vous de [[https://youtu.be/2uoeuXKKTdk|cette vidéo]] pendant la manipulation.
=== Étape 1 - Lancer l'application une première fois ===
Lancez l'application Piveo une fois. Cela permet de créer automatiquement les répertoires nécessaires, notamment ''~/.local/piveo/fichiers/''.
Sans cette étape, les fichiers ne seront pas présents.
=== Étape 2 - Installer DBeaver ===
* Téléchargez DBeaver depuis son site officiel : [[https://dbeaver.io/|DBeaver]]
* Installez-le normalement
* Lancez DBeaver
DBeaver est une application gratuite qui permet de créer et gérer des bases de données facilement.
=== Étape 3 - Récupérer les fichiers CSV ===
Prenons un exemple : pour récupérer les trois fichiers [[wpfr>Comma-separated_values|CSV]] qui permettent de créer la base de données ''salarie.db''.
il faut se rendre dans le répertoire ''~/.local/piveo/fichiers/salaries/''.\\
Vous devez y trouver ces trois fichiers :
* ''personnes.csv'' (liste des personnes)
* ''personnes_specialites.csv'' (liste des spécialités)
* ''specialites.csv'' (fait le lien entre les deux fichiers précédents)
Ces fichiers contiennent les données (comme un tableur). Vous pouvez les modifier pour mettre vos propres informations.\\
La base de données associée ''salaries.db'' doit se situer dans le répertoire ''~/.local/piveo/BasDonnees''.
=== Étape 4 - Récupérer le fichier SQL ===
Dans le même répertoire que les fichiers, récupérez également le fichier : ''commun.sql''.\\
Ce fichier sert à créer la structure de la base de données (tables, relations, etc.).
=== Étape 5 - Suivre la vidéo n° 2 ===
Ouvrez la vidéo n° 2 (voir lien - partie 10) et suivez les instructions pour :
* créer la base [[wpfr>SQLite]] dans DBeaver
* importer les fichiers [[wpfr>Comma-separated_values|CSV]]
* finaliser votre base personnalisée.
Votre base de données sera ensuite prête à être utilisée par l'application.
===== Problèmes connus =====
==== Problème lié au répertoire ~/.local/piveo ====
Le répertoire ''~/.local/piveo'' peut parfois contenir des données corrompues empêchant Piveo de démarrer correctement.
Attention : cette opération supprime les données locales.
Sauvegardez vos bases avant toute manipulation.
=== Procédure de résolution ===
- Sauvegarder vos bases de données.\\ Copiez le répertoire contenant les bases vers le bureau :cp -r ~/.local/piveo/BaseDonnees ~/Bureau/SauvegardeBDD
- Supprimer le répertoire local de Piveorm -r ~/.local/piveo
- Relancer Piveo\\ Au premier lancement, le répertoire ''~/.local/piveo'' sera recréé automatiquement.
=== Restaurer vos bases (optionnel) ===
Si vous souhaitez récupérer vos anciennes données :
- Fermez Piveo
- Copiez les bases sauvegardées dans le nouveau répertoire :cp -r ~/Bureau/SauvegardeBDD/* ~/.local/piveo/BaseDonnees/
===== Voir aussi =====
* [[https://gerardlerest.github.io/piveo/|site officiel]]
* [[https://github.com/GerardLeRest/piveo-v2|GitHub]]
* [[https://forum.ubuntu-fr.org/viewtopic.php?id=2091784|discussion]] sur le forum
* journal LinuxFr [[https://linuxfr.org/users/clisam/journaux/piveo-2-4-0-logiciel-d-apprentissage-de-prenoms-et-noms]]
* video //[[https://youtu.be/upmGYy93n2w|Piveo - présentation]]//
* vidéo //[[https://youtu.be/2uoeuXKKTdk|Piveo - DBeaver et fichiers CSV]]//