ACPI hotkeys

From ArchWiki
Revision as of 01:25, 22 April 2007 by MEo (talk | contribs)
Jump to: navigation, search

ACPI Hotkeys


There are many guides on how to configure multimedia hotkeys using program such as xev or keyTouch. However, this guide explains how to use the simple utility of acpi_listen and generate your own script for hotkeys.

Who Should be Using This Guide

This guide assumes that you know your keyboard signals through acpi. If you do not know whether or not this is the case, I suggest looking:

Using Multimedia Keys in Linux


Extra Keyboard Keys - keyTouch

Installing Necessary Tools

You should already have these tools installed, but just to make sure you will need

sudo pacman -S acpi acpid acpitool

Refer to this guide on what modules you should load (i.e. through /etc/rc.conf or modprobe)

Using acpi_listen

Under root, or with sufficient access to the input devices, run:


If pressing a special key, such as previous or next, receives a response that looks similar to:

hkey VALZ 00000000 00000b31

then all is well and we can continue.

A Sample Script

As keyTouch and other keyboard programs did not work for me, or did not work effectively, I needed to create my own script that runs in the background and reacts directly from the output of acpi_listen. Here is the script, feel free to use it / modify it to suit your needs and post suggestions on how it can be improved. Currently, it is setup for a Toshiba Satellite A50 laptop to control exaile, but can be modified very easily for Amarok, Xine or other non-music related functions (internet, email).

i=`acpi_listen -c 1`
case "$i" in
	"hkey VALZ 00000000 00000b31")
		#echo "PREVIOUS"
		exaile -p
	"hkey VALZ 00000000 00000b32")
		#echo "NEXT"
		exaile -n
	"hkey VALZ 00000000 00000b33")
		exaile -t
	"hkey VALZ 00000000 00000b30")
		#echo "STOP"
		exaile -s
		#echo "ELSE: $i"
if [ "$e" != "1" ]
	./ &

Note: This does not need to be run as root if you can receive an acpi_listen response from a user account (again, meaning you have access to the input devices).