| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| piveo [Le 16/08/2026, 18:06] – [Installation] samcelia | piveo [Le 23/09/2026, 19:52] (Version actuelle) – mise en forme | correction lien interne (installation) | /latest sur github | détails divers krodelabestiole |
|---|
| ===== Présentation ===== | ===== 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. | Cette application [[wpfr>logiciel libre|libre]]((Licence [[https://www.gnu.org/licenses/quick-guide-gplv3.fr.html|GPLv3]])) et gratuite 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 }} | {{:accueil2.png?240|Écran d'accueil 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**. | 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 : | Cas d'usage : |
| * **Enseignants** : mémoriser l'identité de leurs élèves en début d'année ou après les vacances ! | * **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 | * **Managers, commerciaux, RH, événementiel** : connaître rapidement leurs contacts |
| *** Élus** : retenir vos collègues d'une commision, par exemple | * **Élus** : retenir vos collègues d'une commission, par exemple |
| et bien d'autres contextes professionnels... | et bien d'autres contextes professionnels... |
| |
| * PySide6 | * PySide6 |
| * [[wpfr>SQLite]] | * [[wpfr>SQLite]] |
| * OS testé: Ubuntu 24.04 LTS, ubuntu 26.04 LTS | * OS testé: Ubuntu [[:noble|24.04 LTS]], Ubuntu [[:resolute|26.04 LTS]] |
| |
| === Langues === | === Langues === |
| ===== Installation ===== | ===== Installation ===== |
| |
| Pour installer un paquet **[[:deb]]** référez-vous avant tout au [[:deb#installer_un_paquet_deb|chapitre dédié]] au sujet. | Pour installer un paquet **[[:deb]]** isolé référez-vous avant tout au [[:installer_un_paquet_deb#installer_un_paquet_isole|chapitre dédié]] au sujet. |
| |
| <note important> | <note important> |
| Cette méthode ne permet pas de mise à jour automatique. | Cette méthode ne permet pas de mise à jour automatique. |
| l'icône de lancement est automatiquement créé. | l'icône de lancement est automatiquement créée. |
| </note> | </note> |
| |
| Récupérer le fichier deb sur [[https://github.com/GerardLeRest/piveo-v2/releases|github_piveo]] | Récupérer le fichier [[:deb]] sur [[https://github.com/GerardLeRest/piveo-v2/releases/latest|github_piveo]] |
| <code>sudo apt install piveo_X.X.X-Y_amd64.deb </code> | <code>sudo apt install ./piveo_X.X.X-Y_amd64.deb</code> |
| X.X.X: version du logiciel | * ''X.X.X'' : version du logiciel. |
| Y: version deb du logiciel. | * ''Y'' : version deb du logiciel. |
| | * le fichier ''.deb'' est dans le répertoire courant. |
| | |
| ===== Désinstallation ===== | ===== Désinstallation ===== |
| Pour désinstaller un paquet **[[:deb]]** référez-vous avant tout au [[:deb#desinstaller_un_paquet_deb|chapitre dédié]] au sujet. | Pour désinstaller un paquet **[[:deb]]** référez-vous avant tout au [[:deb#desinstaller_un_paquet_deb|chapitre dédié]] au sujet. |
| | |
| <code> sudo apt remove piveo_x.x.x-y_amd64.deb</code> | <code> sudo apt remove piveo </code> |
| ou pour effacer les fichiers de configuration: | ou pour effacer aussi les fichiers de configuration: |
| <code> sudo apt purge piveo_x.x.x-y_amd64.deb</code> | <code> sudo apt purge piveo </code> |
| |
| |
| ===== Fonctionnement ===== | ===== Fonctionnement ===== |
| |
| {{:interface-piveo.png?500}} | {{ :interface-piveo.png?500}} |
| |
| L'application Piveo fonctionne de la manière suivante : | L'application Piveo fonctionne de la manière suivante : |
| |
| * Trois structures sont proposées : École, Entreprise, Parlement sur la page de garde). | * Trois structures sont proposées : //École//, //Entreprise//, //Collectivité// sur la page d'accueil). |
| * L’utilisateur choisit entre prénom+nom, nom ou prénom). | * 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). | * Plusieurs modes de mémorisation sont disponibles : lecture (œil), devinette(œil barré), écriture(crayon). |
| * La partie gauche de l’interface permet de faire défiler les personnes tout en affichant leurs informations. | * 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. | * 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. | 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 ===== | ===== Personnalisation de la base de données ===== |
| |
| ==== Méthode 1 (Nouvelle version Recommandée) ==== | Pour modifier l'une des trois bases de données, complétez les trois fichiers CSV correspondants : |
| |
| Cette nouvelle version simplifie beaucoup l’installation. | * ''personnes.csv'' : liste des personnes ; |
| | * ''specialite.csv'' : liste des spécialités ; |
| | * ''personnes_specialites.csv'' : liens entre les personnes et leurs spécialités. |
| |
| 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]]** : | Avant toute suppression, faites une copie de la ou des bases de données que vous souhaitez conserver. |
| * **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. | Fermez **Piveo**, puis supprimez la base de données concernée dans ''~/.local/piveo/BaseDonnees/''. Au prochain démarrage, elle sera recréée à partir des fichiers CSV modifiés. |
| | |
| 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 (ancienne méthode) ==== | |
| | |
| 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. | |
| |
| | {{ :tableaux.png |}} |
| ===== Problèmes connus ===== | ===== Problèmes connus ===== |
| |
| ==== Problème lié au répertoire ~/.local/piveo ==== | ==== 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. | Fermez **Piveo**, puis renommez son répertoire de données : |
| | |
| <note important>Attention : cette opération supprime les données locales.</note> | |
| | |
| 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 :<code>cp -r ~/.local/piveo/BaseDonnees ~/Bureau/SauvegardeBDD</code> | |
| - Supprimer le répertoire local de Piveo<code>rm -r ~/.local/piveo</code> | |
| - Relancer Piveo\\ Au premier lancement, le répertoire ''~/.local/piveo'' sera recréé automatiquement. | |
| |
| === Restaurer vos bases (optionnel) === | <code>mv ~/.local/piveo ~/.local/piveo-sauvegarde</code> |
| |
| Si vous souhaitez récupérer vos anciennes données : | Le répertoire ''piveo-sauvegarde'' conserve vos anciennes bases, vos CSV et vos photos. Relancez **Piveo** : un nouveau répertoire ''~/.local/piveo'' sera créé avec les données fournies par le paquet. |
| - Fermez Piveo | |
| - Copiez les bases sauvegardées dans le nouveau répertoire :<code>cp -r ~/Bureau/SauvegardeBDD/* ~/.local/piveo/BaseDonnees/</code> | |
| |
| ===== Voir aussi ===== | ===== Voir aussi ===== |
| * [[https://github.com/GerardLeRest/piveo-v2|GitHub]] | * [[https://github.com/GerardLeRest/piveo-v2|GitHub]] |
| * [[https://forum.ubuntu-fr.org/viewtopic.php?id=2091784|discussion]] sur le forum | * [[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]] | * article 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/upmGYy93n2w|Piveo - présentation]]// |
| * vidéo //[[https://youtu.be/2uoeuXKKTdk|Piveo - DBeaver et fichiers CSV]]// | |
| | |
| |