✎ google2ubuntu [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

{{tag>Precise reconnaissance_vocale BROUILLON}}
----
 
====== Google2Ubuntu ======
 
Google2Ubuntu est un outil libre (GPLv3) permettant d'utiliser la reconnaissance vocale de Google sur Ubuntu.

Prinicipe: cet outil nécessite une connexion Internet, il acquiert votre voix dans un fichier audio, l'envoie à Google qui nous retourne alors le texte prononcé. On peut alors lier certaines actions à certains mots.

J'ai récemment repris le projet dans le but de le simplifier et de le rendre plus souple. Pour cela, toute la structure du projet a été revue et le code a totalement été réécrit en Python.

<note important>Il s'agit d'un outil en cours de développement, à utiliser à vos propres risques. Vous pouvez y contribuer via [[http://forum.ubuntu-fr.org/viewtopic.php?id=804211|cette discussion]] sur le forum ubuntu-fr. </note>
===== Pré-requis =====
 
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
 
===== Installation =====
Le projet est disponible sur Github: [[https://github.com/benoitfragit/google2ubuntu]]

L'installation est très facile
<code>
wget https://github.com/benoitfragit/google2ubuntu/archive/master.zip
unzip master.zip
cd google2ubuntu-master
chmod +x INSTALL
./INSTALL
</code>

===== Configuration =====

==== Configuration basique ====
 
google2ubuntu se veut extensible mais il y a n'y a pas besoin de le configurer.
L'application fonctionne grâce à un unique fichier de configuration:
<code>
~/.config/google2ubuntu/google2ubuntu.conf
</code>

Ce fichier regroupe l'ensemble des actions que l'utilisateur veut lancer avec des phrases.
Ainsi le formatage de chaque ligne est du type:
<code>
[O/o]uvre*documents=xdg-open ~/Documents &
</code>

La première partie avant le "=", est la phrase clé ie la phrase à prononcer pour lancer l'action voulu.
Justement l'action est la seconde partie de la ligne.

Au premier lancement, si le fichier de conf est absent on charge un fichier minimal:
<code>
/usr/share/google2ubuntu/default.conf
</code>

Trois types de commandes peuvent être ajoutées:
  * Commandes basiques: Comme celle présentée plus haut
  * Commandes internes: Commande qui fait appel a des fonction codée dans google2ubuntu.py le but étant d'en avoir le moins possible
  * Modules: Des modules sont des scripts externe que l'on peut appeler
==== Gestion des commandes ====

La gestion des commandes se fait via une interface graphique développée en Python+Gtk3. 
On ajoute une commande en cliquant sur "Ajouter". On peut choisir d'ajouter un certains types de commandes. Une ligne pré-remplie est ajouté à vos commandes.

=== Ajout d'une commande basique ===

Si vous ajouter une commande basique, la ligne est de cette forme:
<code>phrase clé  commande</code>
Il faut alors modifier chacun des 2 champs comme dans l'exemple de partie précédente

=== Ajout d'une commande interne ===
Si vous ajouter une commande interne:
<code>phrase clé  interne/mot</code>
Il suffit juste de modifier le terme "mot" par "heure" ou "batterie". Pour l'instant, il n'y a que ces commandes qui ont été implémentée.

=== Ajout d'un module ===
== Constitution d'un module ==
Un module est un ensemble de 2 fichier regroupés au sein d'un dossier. Ces fichiers sont l'exécutable du module et le fichier de configuration. Deux exemples sont installés par défaut weather et search dans <code>~/.config/google2ubuntu/modules</code>

Un module est donc constitué d'un fichier exécutable (script) et d'un fichier nommé args.
Il va servir à envoyer des les paramètres au script. Ce fichier args doit contenir 2 paramètres:
  * linker = " à " # qui va servir à séparer l'appel du module du texte à lui envoyer
  * spacebyplus = 0  # qui sert à transformer si 1, les espaces en +

== Choisir un module ==
Pour choisir un module, cliquer sur "Ajouter" puis "Module". Une fenêtre de sélection de fichier s'ouvre. Rendez-vous dans le dossier du module et cliquez sur le script. Le programme vérifie qu'il y a bien le fichier args et copie le dossier dans le dossier regroupant les modules.
Si tout est bon, une nouvelle ligne s'ajoute automatiquement dans votre liste de commande, ex:
<code>phrase clé  /modules/search/search.sh</code>
Il vous suffit alors de modifier la phrase clé comme vous le souhaitez
===== Utilisation =====
 
Lancez l'application via le [[:unity#tableau_de_bord_dash|dash]] (Ubuntu 11.04 et ultérieures) ou via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
<code>google2ubuntu</code>

À chaque lancement, google2ubuntu vérifie la présence du fichier de configuration et teste la connexion internet. Une notification sonore et visuelle vous indique alors les éventuels problèmes.

Pour lancer la boucle d'acquisition, il faut passer par l'applet et faire "Démarrer".
Ensuite attendre la notification visuelle centrée dans l'écran pour parler.

Par défaut, la durée d'acquisition est fixée à 4 secondes, pendant celles-ci dites le texte que vous désirez faire reconnaître. Si le texte est reconnu, la commande associée se lance.

Une fois la commande lancée, google2ubuntu vous notifie de sa mise en pause. La mise en pause sera effective si vous ne bougez pas la souris pendant 8 secondes. Si tel est le cas le script se met en pause. Sinon, si vous bougez la souris, google2ubuntu suppose que vous avez encore besoin de lui et relance une acquisition.

Pour sortir du mode Pause, il faut dire "relancer" de manière assez claire, la boucle d'acquisition est alors relancée et google2ubuntu vous demande alors de parler.

Pour quitter google2ubuntu, plusieurs possibilités:

- Dire "arrêt", ce qui à pour conséquence d'arrêter la boucle d'acquisition, mais laisse l'applet ouvert  pour une éventuelle relance.
  -  Via l'applet cliquer sur "Quitter", ce qui a pour conséquence de quitter la boucle d'acquisition dès que la commande en cours est finie et de fermer l'applet.

===== Possibilités ======

//Contributeurs principaux : [[:utilisateurs:benoitfra]], [[:utilisateurs:YannUbuntu]].//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : O I S A I Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported