Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
269 lines (223 sloc) 10.3 KB


ScannerPi is a collection of scripts and configuration files that you can use to assist in setting up a RaspBerry Pi for streaming scanner audio to websites such as

Step 1: RaspberryPi Pre-Configuration Steps

  • These instructions assume you have installed Raspbian on your Pi

Audio set-up

  • With your USB sound stick installed, in a terminal on the RasPi run the command
$ arecord –l

and note the output. You should see something like this:

**** List of CAPTURE Hardware Devices ****
card 1: Device [Generic USB Audio Device], device 0: USB Audio [USB Audio]
Subdevices: 1/1
Subdevice #0: subdevice #0
  • This indicates that the capture (recording) device is card one. The numbering starts at zero and the on-board audio on the RasPi is card 0 (but it does not have a capture device). In ALSA configuration it is referred to by device and sub-device thusly: “hw:1,0”.

Next connect speakers to the audio jack on the RasPi (not the USB output) and a microphone or other audio input to the USB sound stick. A scanner tuned to NOAA weather with continuous output works well. Adjust the volume to mid level if using a scanner, etc. Then enter:

$ arecord -D plughw:1,0 temp.wav 
  • In this case we use the plug-in called "plug" to handle format conversion. Otherwise you could use “arecord –D hw:1,0 somefile.wav but you would need to explicitly set the format to match your sound stick. Using “plughw:1,0” makes life easier.

If using a microphone, speak into it for about ten seconds. Then type “ctl-c” to stop recording. If you hear the audio when you enter the command,

$ aplay temp.wav

then the recording on the RasPi and USB device is working. If you don’t hear anything using “aplay temp.wav”, or if it is too soft or distorted, try using the command:

$ sudo alsamixer

(along with the volume control on the radio) to balance the recording level. After entering “alsamixer” press “F6” and select the sound card (maybe called generic USB device), then “F5” to display all controls for that device.

Using one scanner I had to turn the scanner up quite loud, then using alsamixer turn on Auto Gain (arrow over to auto gain and press “m” until “00” is displayed). Using a different scanner I had to keep it rather low and turn auto gain off (mute) while keeping the capture level at + 9 dB - it’s fair to say “your mileage may vary.”

If despite all this you cannot get decent quality audio then you should suspect a problem with the attached audio hardware, audio cable, etc.

Once you have a feed running with good audio level you can save the alsamixer settings between reboots by issuing command:

$ sudo alsactl store

Updates the Pi's Catalog, Kernel, & Firmware

Run these commands is sucessive order

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo rpi-update

Add the SOX Package

This command installs the 'sox' package required for mp3 encoding

sudo apt-get install sox libsox-fmt-mp3

Step 2: Compile & Install Darkice

This installs the Darkice package and has you manually compile it to support mp3 encoding

Add a deb-src repository to your sources list at /etc/apt/sources.list:

$ sudo sh -c "echo 'deb-src wheezy main contrib non-free rpi' >> /etc/apt/sources.list"
$ sudo apt-get update

Fulfills Build Dependencies:

$ sudo apt-get --no-install-recommends install build-essential devscripts autotools-dev fakeroot dpkg-dev debhelper autotools-dev dh-make quilt ccache libsamplerate0-dev libpulse-dev libaudio-dev lame libjack-jackd2-dev libasound2-dev libtwolame-dev libfaad-dev libflac-dev libmp4v2-dev libshout3-dev libmp3lame-dev

Create Working Directory:

$ mkdir src && cd src/

Get the DarkIce Source Package

$ apt-get source darkice

Change the Compile Configuration to Match the Raspbian Environment

$ cd darkice-1.0/
$ nano debian/rules

Use the following text. The build will fail if the text contains SPACES instead of TABS.

You may want to copy fom this link:

#!/usr/bin/make -f

	dh $@

.PHONY: override_dh_auto_configure
	ln -s /usr/share/misc/config.guess .
	ln -s /usr/share/misc/config.sub .
	dh_auto_configure -- --prefix=/usr --sysconfdir=/usr/share/doc/darkice/examples --with-vorbis-prefix=/usr/lib/arm-linux-gnueabihf/ --with-jack-prefix=/usr/lib/arm-linux-gnueabihf/ --with-alsa-prefix=/usr/lib/arm-linux-gnueabihf/ --with-faac-prefix=/usr/lib/arm-linux-gnueabihf/ --with-aacplus-prefix=/usr/lib/arm-linux-gnueabihf/ --with-samplerate-prefix=/usr/lib/arm-linux-gnueabihf/ --with-lame-prefix=/usr/lib/arm-linux-gnueabihf/ CFLAGS='-march=armv6 -mfpu=vfp -mfloat-abi=hard'

Version to Reflect mp3 Support

Add the following "New build with mp3 support" text as shown below

$ debchange -v 1.0-999~mp3+1

darkice (1.0-999~mp3+1) UNRELEASED; urgency=low

  * New build with mp3 support

 --  <pi@raspberrypi>  Sat, 11 Aug 2012 13:35:06 +0000

Build & Install the Darkice Package

$ dpkg-buildpackage -rfakeroot -uc -b
$ sudo dpkg -i ../darkice_1.0-999~mp3+1_armhf.deb

Preparing to replace darkice 1.0-999 (using .../darkice_1.0-999~mp3+1_armhf.deb) ...
Unpacking replacement darkice ...
Setting up darkice (1.0-999~mp3+1) ...

You have installed DarkIce with mp3 support

Step 3: Configure & Install Support Scripts

This step will focus on installing and configuring DarkIce & Radioplay

Install id3 Tag Package

$ sudo apt-get install id3v2

Folder Creation for Radioplay

$ sudo mkdir /etc/radioplay
$ sudo mkdir /var/lib/radioplay

Create Scanneraudio & Sandbox Folders

Create this at the pi root (/home/pi)

$ mkdir scanneraudio
$ mkdir sandbox && cd sandbox

Darkice Script

$ curl "" -o darkice

Darkice Configuration File

$ curl "" -o darkice.cfg

Radioplay Script

$ curl "" -o radioplay

Radioplay Configuration File

$ curl "" -o radioplay.conf

Download them all at Once

$ curl "" -o darkice && curl "" -o darkice.cfg && curl "" -o radioplay && curl "" -o radioplay.conf
  • Update the darkice.cfg and radioplay.conf configuration files using nano to conform it to your settings
  • You may also need to modify the radioplay script at the trim area to customize the feed mnemonic

Edit Permission & Ownership

$ sudo chown root:root darkice darkice.cfg radioplay radioplay.conf
$ sudo chmod 755 radioplay darkice
$ sudo chmod 644 radioplay.conf darkice.cfg

Move Files to Destination Folders

$ sudo mv radioplay /usr/local/bin/radioplay
$ sudo mv radioplay.conf /etc/radioplay/radioplay.conf
$ sudo mv darkice /etc/init.d/darkice
$ sudo mv darkice.cfg /etc/darkice.cfg

Step 4: Test and Final Cleanup

Test DarkIce without archiving

$ sudo /usr/bin/darkice

Listen to the feed and adjust the levels as needed. If all works as expected then “ctl-c” to stop darkice. If you see this error when running darkice, “…lame lib opening underlying sink error…” then darkice was unable to connect to the server. Check “/etc/darkice.cfg” for the proper entries and make sure the RasPi can access the internet.

Finalize the Installation

Update the root's crontab

$ sudo crontab -e

...and add the following lines

00 * * * *   [ -x /usr/local/bin/radioplay ] && /usr/local/bin/radioplay cron > /dev/null

Start DarkIce

$ sudo /etc/init.d/darkice start

Update the DarkIce startup script to run at boot

$ sudo update-rc.d darkice defaults


There is a live working feed accessible here


Dropbox Uploader (third-party download)

Dropbox Uploader is a BASH script which can be used to upload, download, delete, list files (and more!) from Dropbox, an online file sharing, synchronization and backup service.

It's written in BASH scripting language and only needs cURL.

Why use this script?

Portable: It's written in BASH scripting and only needs cURL (curl is a tool to transfer data from or to a server, available for all operating systems and installed by default in many linux distributions). Secure: It's not required to provide your username/password to this script, because it uses the official Dropbox API for the authentication process. Please refer to the ( for tips and additional information about this project. The Wiki is also the place where you can share your scripts and examples related to Dropbox Uploader.

Dropbox Purge (Dbpurge)

Dropbox purge (dbpurge) is an independent script that allows the user to purge their Dropbox app folder of the oldest archive recording. The script runs as a cron job (user-defined scheduling) and periodically deletes the oldest file using the Dropbox

Ensure that you have the gawk package installed on your OS (apt-get install gawk)

$ sudo apt-get install gawk -y

Download dbpurge Script

$ cd /usr/local/bin
$ curl "" -o dbpurge

Edit Permission & Ownership

$ sudo chmod 755 dbpurge

Download dbpurge.conf Configuration File

$ sudo mkdir /etc/dbpurge && cd /etc/dbpurge
$ curl "" -o dbpurge.conf

Edit Permission & Ownership

$ sudo chmod 644 dbpurge.conf