soundfiles Files

Soundfiles V1.0
avril 2012
licence = GNU GPL

Guide d'installation et d'utilisation du programme Soundfiles:


Soundfiles est un catalogue d'albums musicaux.
Chaque album est caractérisé par ses propriétés:
- artist: chaîne de caractères -> p.ex: PETRUCCIANI Michel
- album: chaîne de caractères -> p.ex: The blue note years (1986 - 1994)
- label: chaîne de caractères -> p.ex: Blue note
- year(année): nombre entier -> p.ex: 1998
- support: chaîne de caractères -> p.ex: disque vinyle 25/30 cm
- style: chaîne de caractères -> p.ex: jazz
- myIndex (numéro d'ordre du support si nécessaire, p.ex. de la cassette audio): nombre entier



A) Installation de Soundfiles sous Windows Vista:

Le programme d'installation que vous aurez téléchargé aura copié
les fichiers suivants dans le répertoire de votre choix:
- parameters.txt
- soundfiles.py
- FindingWebPages_m.py
- LoadingMySoundFiles_m.py


Vérifier que vous avez téléchargé l'interpréteur PYTHON sur http://python.org/download/
Sélectionner la version 3.

Installer PYTHON en version 3. 

Ouvrir parameters.txt avec notepad.
Y entrer, sur une ligne le répertoire complet suivi du nom de fichier contenant la base de données
contenant le catalogue.
Si la base de données n'existe pas encore, il faut néanmoins mentionner un nom de fichier de base de données
précédé par le chemin d'accès à ce fichier.
p.ex. F:\documents\myprograms\python\soundfilemanager\SoundFileInventory.db3

Pour lancer le programme double cliquer sur soundfiles.py.
(si le programme ne se lance pas, designer le programme PYHTON.exe
en tant que programme par défaut: clic droit sur soundfiles.py, puis choisir "ouvrir avec" et "choisir le programme par défaut",
puis sélectionner le programme python.exe)

Il est possible de créer un raccourci sur le bureau:
Clic droit sur soundfiles.py, puis choisir "envoyer" et créer un raccourci sur le bureau.



B) utilisation de Soundfiles:

Les fonctions disponibles:
- importer CSV: ce bouton est activé si aucune base de données n'est trouvée.
Il permet de créer une base de données à partir d'un fichier nommé soundfileinventory.csv
.
Ce fichier peut être constitué manuellement (par saisie dans Excel ou Open office,
puis enregistrement au format CSV en retenant le séparateur ";" et en dévalidant l'insertion de guillemets
autour du texte).Les données relatives aux albums sont ainsi aisément
saisies dans Excel (ou Open Office), en vue d'être importées automatiquement, par le bouton "importer CSV".
Le format du fichier CSV doit être (exemple):
CARMEL;THE CALLING;LONDON;1986;K7 audio;Pop Rock;100
Il ne faut utiliser ni les caractères accentués, ni les guillemets dans les valeurs entrées.



- chercher un artiste: saisir les 1ères lettres du nom d'artiste à rechercher dans le catalogue.


valider par la touche "entrée"

- artiste à rechercher sur le web: saisir le nom de l'artiste à rechercher sur le web,
valider par la touche "entrée"

- ajouter: permet d'ajouter un nouvel album au catalogue. Entrer les valeurs dans les champs de saisie,
passer d'un champ à l'autre grâce à la tabulation.
Passer du dernier champ au bouton OK grâce à la tabulation.
Cliquer sur le bouton OK pour valider l'enregistrement dans le catalogue.

- un double clic sur une ligne du catalogue affiché permet de sélectionner un album.
Il est possible de supprimer l'album sélectionné en sélectionnant le bouton "suppr".
Il est possible de lancer une recherche sur Wikipedia de l'artiste correspondant à l'album sélectionné
(une connexion à internet est requise pour cette fonction).