xavbox user

Webradio, enregistreur et audiolivres connectés sur raspberry, guide de l'utilisateur

Démarrage

introduction

Bienvenue dans xavbox.

xavbox est un appareil multifonction, basé sur un raspberry pi.
Il est à la fois un appareil radio, un lecteur de musique et un lecteur d'audiolivres,
utilisable par monsieur Tout-le-monde. Les audiolivres intéresseront cependant plus particulièrement les aveugles et malvoyants.
Il se connecte à internet pour être pleinement fonctionnel, soit en direct (cordon RJ45), soit en wifi.

L'appareil radio a besoin d'internet pour fonctionner, ainsi que le lecteur d'audiolivres pour la phase de téléchargement.
Le lecteur de musique peut se passer d'internet, mais de pas de la clé usb externe, sur laquelle sont stockés les fichiers musique (.mp3).

La clé usb est utilisée par le lecteur audiolivres pour télécharger les audiolivres gratuits accessibles sur internet, comme sur le site librivox.org par exemple.

xavbox utilise linux et python pour fonctionner, mpd pour lire l'audio et la synthèse vocale pour pallier l'absence d'écran.

La synthèse vocale délivre les messages d'information, pour un utilisateur voyant, mal ou non voyant.
Après tout, xavbox fait majoritairement appel au sens auditif, alors pourquoi s'encombrer d'un écran qui augmentera le prix et la complexité de l'appareil ?

demarrage

Clavier et démarrage

xavbox est contrôlé par l'intermédiaire d'un simple clavier numérique.
Un clavier normal fait aussi l'affaire, mais l'encombrement est dissuasif : il "pèse" quatre pavés numériques en volume.

Il existe des pavés numériques sans fil, très efficaces.
L'application se lance en tapant 1 puis Entrée.
Sur les xavbox basés sur des raspberry lents (pi zero, pi 1), attendre ensuite plusieurs secondes avant d'entendre le message de bienvenue.

C'est la version python de xavbox qui est lancée.
Actuellement, la version précédente, en bash, se lance toujours avec 0 puis Entrée.
Ultérieurement, il ne devrait subsister que la version python.

Internet

La connexion internet (wifi) et la clé usb doivent être préparées et vérifiées avant le lancement de l'appareil.
Sinon, cela risque de ne pas fonctionner.
Certaines clés ne sont pas compatibles, a priori en raison d'une demande électrique trop importante.
Contactez le responsable du projet pour vérifier ces deux points.

Application lancée

L'application lancée, vous arrivez à l'accueil de l'appareil. De là, vous pouvez lancer les différents modules ainsi :

Touches accueil
ToucheAction
1 radio
2 musique
3 audiolivres
4 maintenance
6 scénarios
00 Aide rapide
11 Menu vocal

Appuyez rapidement sur 00 pour obtenir un guide vocal succinct.
00 peut être utilisé à tout moment dans xavbox, sauf dans un menu "11", appelé menu vocal.
Un menu vocal est une aide sonore (l'appareil n'a pas d'écran, et essaie de s'adapter aux mal ou nonvoyants), qui énonce les actions possibles, et laisse le choix à l'utilisateur de les déclencher en appuyant sur Entrée.

Appareils

radio 📻

Les radios sont organisées en quatre groupes, qui contiennent de 7 à 8 stations chacun. Lorsque vous changez de groupe, la station en écoute est mémorisée pour le groupe quitté. Cela vous permet de retrouver la même station quand vous revenez dans le groupe.

Radios : françaises, musicales, étrangères

Les trois groupes de radio
Groupe 1Groupe 2Groupe 3Groupe 4
1Europe 1AlouetteBBC Radio 4DWR4
2FB ChampagneChampagne FMDeutschlandfunkChill Harmonie
3FB NordRadio FGDF KulturAlles chill
4France CultureFrance MusiqueDoku und Debatten
5France InfoNovaSWR1 Bade-W.
6France InterRTL2SWR2 Archivradio
7RCFSkyrockSWR2
8RTL
9francophonemusicalétrangerchill

Touches radio

Voici les séquences de touches associées à la radio.

Touches radio
ToucheAction
1groupe précédent
2station au hasard
3groupe suivant
4station précédente
5pause
6station suivante
22groupe et radio au hasard
44première station
55stop
66dernière station
85pause publicité de 1mn
/annonce le nom de la radio
*enregistre 3 mn
**enregistre 30 mn
*9écouter enregistrements
00Aide rapide
11Menu vocal

Vous pouvez enregistrer à tout moment la radio que vous écoutez, pendant 3 minutes (touche *), ou 30 minutes (touches **), et ensuite passer sur une autre station. Les enregistrements sont stockés dans le dossier /m/source_media/rec/utilisateur, soit /m/usb/rec/user_1 sur la clé usb, pour l'utilisateur 1.

Pour écouter plus tard les enregistrements, vous pourrez passer dans le module musique et enregistrements. Les touches 88 vous autorisent à supprimer l'enregistrement en écoute.

musique 🎝

La musique est stockée sur la clé usb. Chaque dossier commence par une lettre de A à Z.

Usage courant

Pour écouter simplement votre musique, vous pouvez, une fois entré dans le module musique, taper 1, puis Entrée. Cela va lancer toute la bibliothèque au hasard. Appuyez ensuite sur 6 ou 4 pour naviguer dans les morceaux. Si un titre vous plaît, appuyez sur *, il sera ajouté aux favoris. Pour le supprimer des favoris, appuyez deux fois de suite sur *. Pour lire les favoris seulement, appuyez sur la touche 2. Pour arrêter la musique, appuyez sur 0, ce qui vous ramène au menu principal. Depuis le menu principal, appuyez sur 1 pour lancer la radio.

Touches musique

Voici les séquences de touches associées à la musique.

Touches musique
ToucheAction
1 Jouer au hasard
2 Favoris au hasard
3 Type de musique
4 morceau précédent
5 pause
6 morceau suivant
7 reculer de 10s
9 avancer de 30s
/ annonce titre et auteur
* ajoute aux favoris
** retire des favoris
*/ joue les favoris
88 supprimer un enregistrement
*8 écouter les enregistrements
*9 écouter les enregistrements
00 Aide rapide
11 Menu vocal
22 dossier courant seul

scenarios 🕑

Le module scénarios permet de programmer des actions :
- à des jours donnés
- à des heures précises
- pendant une certaine durée.

Il donne ainsi la possibilité de:
- se réveiller ou s'endormir en musique ou avec la radio
(un effet crescendo ou decrescendo sera le bienvenu)
- enregistrer des émissions radio
- écouter des émissions en priorité à certaines heures
- programmer des minuteries pour la cuisine
- piloter un système domotique

Exemples :
- se réveiller avec la radio tous les jours de la semaines à 7h00, pendant 10mn dans la chambre. A 7h10, la radio se déclenche dans la cuisine.
- écouter en priorité (interruption d'une action en cours éventuelle) le jeu des 1000 euros à 12h45 du lundi au vendredi
- même actyion que précédemment, avec option d'enregistrement simultanée
- écouter le journal de 13h en priorité
- enregistrer le journal de la BBC
- programmer une minuterie our la cuisson des pâtes, du riz, avec en option l'envoi d'un mail, ou l'augmentation du volume progressive
- ...

Audiolivres 📚

Les audiolivres sont disponibles depuis plusieurs sources : internet ou clé usb. Des sites mettent à disposition gratuitement un grand nombre d'ouvrages lus par des bénévoles. Chaque source est appelée une bibliothèque.
Au départ, vous arrivez dans une bibliothèque. Là, vous choisissez parmi les livres disponibles. Pour écouter un livre proposé sur internet, vous devez le télécharger sur la clé usb. Une fois téléchargé, il est écoutable immédiatement. Note : la place sur la clé n'étant pas infinie, il faudra à un moment ou à un autre faire du ménage dans les livres téléchargés. Un livre téléchargé est dit présent s'il a été téléchargé complètement sur la clé usb. Un livre peut aussi être marqué comme favori, qu'il soit présent ou non. Quand vous êtes dans une bibliothèque, vous pouvez rapidement accéder aux livres présents, ou bien aux livres favoris. Utilisez le menu vocal, appelé par les touches 11, pour changer de bibliothèque, ou sélectionner les livres présents, les favoris ou tout l'ensemble.

Ressources en ligne

Bibliothèques gratuites
SiteDetails
Audiocité
Littérature audio
Bibliboom

Touches audiolivres

Voici les séquences de touches associées aux audiolivres.

Touches audiolivres
ToucheAction
1 livre précédent
2 livre au hasard
3 livre suivant
4 chapitre précédent
5 pause
6 chapitre suivant
7 reculer de 10s
9 avancer de 30s
00 aide rapide
11 menu vocal
22 favoris et indésirables
77 biblio précédente
99 biblio suivante
* ajouter le livre aux favoris
** supprimer le livre des favoris
/ annoncer titre et auteur du livre
/* annoncer numéro, lecteur et poids du livre
// annoncer numéro, genre et durée du livre
111 sélectionner les livres présents
dans la bibliothèque actuelle
1111 écouter un livre présent au hasard
en recherchant dans toutes les bibliothèques
222 sélectionner vos livres favoris
dans la bibliothèque actuelle
333 sélectionner les livres de l'auteur actuel
dans la bibliothèque actuelle
444 sélectionner les livres du lecteur actuel
dans la bibliothèque actuelle
555 réinitialiser la sélection en
prenant tous les livres
666 télécharger 10 livres pris au
hasard dans la sélection
777 sélectionner les livres du genre actuel
dans la bibliothèque actuelle
6666 télécharger 11 livres au hasard
de toutes les bibliothèques
91 donner des statistiques
sur fichiers
987 supprimer le livre actuel

commun

Chaque module a ses proches touches d'action, à côté de cela, il existe des touches universelles, qui répondent à une action quel que soit l'appareil.

Touches communes

Voici.

Touches universelles
ToucheAction
0 quitter
. . . quitter tout
5 pause
55 stop
00 aide rapide
000 raccourcis de navigation
111 raccourcis communs
11 menu vocal
12 apprentissage des touches
33 définir l'aide vocale
67 date et heure locales
68 t° Reims et Auxerre
69 t° Metz et Orléans
999 éteindre l'appareil
- baisser le volume
+ monter le volume
*+ ajouter aux super favoris
*- retirer des super favoris
56 jouer les super favoris

Divers

maintenance ⚙

La maintenance permet de mettre l'application à jour, et à veiller à ce que la clé usb soit bien gérée. Si elle est trop remplie, elle empêchera xavbox de fonctionner.

Sauvegarde

La sauvegarde ne concerne que la ou les machine(s) de développement. Depuis le menu maintenance, tapez 99 puis ...

Restauration

Depuis le menu maintenance, tapez 88 puis ...
IMPORTANT : pour être sûr de bien faire la mise à jour, sortir de xavbox avec ..., puis lancer la version précédente, avec 0 puis Entrée.
Restaurer en tapant 11, puis 88, puis 11 et Entrée.

touches ⌨

Récapitulatif touches

Lien vers touches de chaque appareil.

Récapitulatif
Appareil Détail
Accueil Touches accueil
Groupes radios Les 4 groupes de radios
Radios Touches radio
Musique En cours
Audiolivres En cours
Commun Touches universelles
Dev Dev (lettres)

source_et_utilisateur

changer utilisateur ou de source

xavbox est ou sera utilisable par plusieurs utilisateurs.
Chacun aura accès aux mêmes radios, fichiers musique et audiolivres que les autres. Cependant, chaque utilisateur gèrera ses propres enregistrements radio.

Pour changer d'utilisateur, utiliser le menu supplémentaire depuis le menu jukebox (départ), en tapant 11, puis la touche 9 et enfin Entrée.

xavbox utilise une source à la fois.
Pour changer de source (carte SD, clé USB ou disque réseau), utiliser le raccourci 9+. Vous pouvez copier vos fichiers mp3 dans chacun des 26 sous-dossiers du dossier type1. Ils correspondent aux 26 lettres de l'alphabet.

Version autonome (sur batterie)

batterie

Ressources diverses en vue de construire une version autonome électriquement de xavbox (qui devra être capable de fonctionner uniquement sur batterie et/ou sur secteur)
GitHub - craic_pi_power_ Power management for portable Raspberry Pi projects
Pi MusicBox
PowerBoost : utiliser un raspberry même en charge