PYTHON-DBUS_MMCTRL

Documentation
Sommaire
Synopsis

Utilitaire pour associer les touches multimédia à des commandes personnalisées sous Linux. Les commandes associées peuvent être lancées pendant l'exécution d'applications plein-écran.


Fonctionnement

Programmé en python, le fonctionnement de python-dbus_mmctrl est très simple. Un démon (service) lancer au démarrage par "root" surveille l'état des touches multimédia grâce à Dbus. Quand une touche est appuyée, il détecte l'utilisateur actuelle de Xorg et appel des commandes shell au nom de celui-ci via "su -". Les commandes associées aux signaux sont lus depuis un fichier de configuration éditable pour chaque utilisateur.


Dépendances

python(>=2.5), python-dbus



Installation

Télécharger et installer le paquet correspondant à votre distribution.
  • Debian et dérivée:
    # dpkg -i pdbmmctrl-x.x.x.deb
  • Fedora:
    # rpm -ivh pdbmmctrl-x.x.x.noarch.rpm
  • Slackware:
    # installpkg pdbmmctrl-x.x.x.tgz
Vous pourrez trouver ces paquets dans la section téléchargements.


Fichiers


/usr/lib/python-dbus_mmctrl/python-dbus_mmctrl.py Script principal, contient les fonctions nécessaires au fonctionnement du programme
/usr/sbin/pdb_mmctrl et /etc/init.d/pdb_mmctrl Script de lancement, il gère le démarrage de python-dbus_mmctrl.
/usr/share/python-dbus_mmctrl/mmctrl.conf Fichier de configuration par défaut, pour les utilisateurs qui n'ont pas de fichier de configuration personnalisé.
/usr/share/python-dbus_mmctrl/mute_ati_ixp_with_amixer.sh Ce script permet de mettre en sourdine et de remettre le son de amixer.
$HOME/.mmctrl.conf fichier de configuration utilisateurs.


Configuration

  • Supprimer vos raccourcis clavier pour les touches multimédia (dans gnome-keybinding-properties par exemple pour les utilisateurs de Gnome)

  • Methode assistée:
  • Lancer l'utilitaire de configuration.
    $ gmmctrl
  • Cliquer sur le bouton "Nouveau"et appuyer sur une touche multimedia.Une nouvelle ligne apparait alors dans la liste.
  • Faite un double-clic sur la nouvelle ligne,une nouvelle fenêtre avec un champs apparait.
  • Taper la commande desirée dans le champs.
  • Recommencer l'operation pour toutes les touches que vous souhaité configurer.

  • Methode manuelle:
  • Créer un fichier de configuration dans votre répertoire personnel, si le fichier de configuration n'existe pas dans le répertoire utilisateur /usr/share/python-dbus_mmctrl/mmctrl.conf sera utilisé (Par défaut, ce fichier est vide).
    $ touch $HOME/.mmctrl.conf

  • Dans un terminal lancez la commande suivante :
    $ pdb_mmctrl --signals
    Cette commande retourne "received signal:NOM_DU_SIGNAL" quand une touche multimédia est appuyée.

  • Ouvrir le .mmctrl.conf et ajouter les lignes de la manière suivante: NOM_DU_SIGNAL= COMMANDE A EXECUTER

    Note: les lignes précéder de "#" sont ignorées.

    Exemple de fichier de configuration

    #.mmctrl.conf
    volume-down= amixer set Master 1%-
    volume-up= amixer set Master 1%+
    mute= /usr/share/python-dbus_mmctrl/mute_ati_ixp_with_amixer.sh
    homepage= firefox
    next-song=mpc next
    previous-song=mpc prev
    play-pause=mpc toggle



Utilisation:

pdb_mmctrl {options}

Voir /usr/share/doc/python-dbus_mmctrl/README pour plus d'informations

Options:
startDémarrer comme un service (Ne démarre pas si le service est déjà actif).
restartRedémarrer le service.
stopArrêter le service.
statusRetourne l'état du service et son PID quand le service est actif.
--signalsVoir le signal de la touche appuyée et quitter.
--helpAfficher cette aide et quitter.


Support

Si vous pensez avoir découvert un bug ou si vous voulez soumettre une correction, contactez-moi à cette adresse: caf@tuxfamily.org

Vous pouvez récupérer les sources des paquets sur le dépôt subversion à cette adresse. http://svn.tuxfamily.org/pdbmmctrl/devel/

Si vous avez subversion d'installé tapez cette commande dans un terminal:
$ svn co svn://svn.tuxfamily.org/svnroot/pdbmmctrl/devel/
Le contenu du dépôt subversion sera téléchargé dans le répertoire courant.

Notes:
  • La version Debian (dans "trunk") utilise exclusivement les outils fournis par Debian pour le démarrage et l'installation des services (updaterc.d , start-stop-daemon, ...), il existe une branche "pdbmmctl-all" pour les autres distributions qui n'utilisent pas ces outils.
  • Tous les paquets sont construits à partir de paquets ".deb" et convertis grâce au logiciel "alien".

hébergé librement chez tuxfamily.org