README

LEDMETER : An Alsa meter plugin for Linux audio software , driving leds.

	This program aims at giving level metering capability to Alsa audio programs 
by driving leds in /sys/class/leds.
	It can be used also for OSS applications (using alsa-oss, aoss
wrapper and a properly written .asoundrc). 

Marc Capdeville <m.capdeville@no-log.org>
Base on ameter-0.43 : http://laugeo.free.fr/ameter.html

Laurent Georget <laugeo@free.fr>
(This plugin is heavily based on the level meter plugin from  
Abramo Bagnara <abramo@alsa-project.org>
(originally with a ncurse display).

Thanks to Andrew Burgess (http://www.cichlid.com) for fixing the aplay problem when interrupting with ctrl+c.

1) Requirements :

	- Alsa ( tested with 1.0.25)

	
2) Compilation :

	./configure
	make
	su -c "make install"

3) Edit  (or create) .asoundrc file in your home directory to have the following lines :

pcm_scope.ledmeter {
	type ledmeter
}
pcm_scope_type.ledmeter {
	lib /usr/local/lib/libledmeter.so
}
pcm.ledmeter {
	type meter
	slave.pcm 'hw:0,0'
	frequency 50
	scopes.0 ledmeter
}


( The frequency parameter is the nb of update/sec , 50 is the default value)

4) Test :
        

	Using Glame: 
	- In audio preferences:
		- Set output plugin to alsa_audio_out 
		- Set output device to ledmeter
	(This is ok for playing and recording)

	Using aplay/arecord:
	aplay -D ledmeter sound.wav 
	arecord -D ledmeter soundrec.wav
	

	Using mplayer:
	mplayer -ao alsa:device=ledmeter /tmp/film.avi 	

	Using alsa-oss:
        aoss realplay /usr/lib/RealPlayer8/firstrun.rm


5) Limitations :
	- Dont work on capture only device