Install

To setup a execution environment :

gem install rails
apt-get install libtagc0-ruby
cp config/database.yml.sample config/database.yml
rake gems:install db:create db:migrate

rake jobs:work &
./script/server &

The application should be available on localhost:3000/

To index recording files :

./script/console
>> Record.index "/path/to/record/directory"

Recording filenames are used to known the Record#begin, this kind of AlsaBackup configuration will work fine :

AlsaBackup.config do |recorder|
  recorder.file = Proc.new {
    Time.now.utc.floor(:min, 1).strftime("%Y/%m-%b/%d-%a/%Hh%M.wav")
  }
end

Pige API

Output formats : html, xml, json

Source

Attributes

id

unique identifier (1 by default)

name

string (‘default’ by default)

other settings should be added in the future (audio inputs, status, …)

Chunk

Attributes

begin,end

date

completion_rate

float in 0..1

source

associated Source

encoding

string (ogg;quality=n, mp3;quality=n, wav, flac)

Action create

begin,end

Date range

begin_chunck, end_chunck

Chunck identifier

Action show

id

date

GET /sources/1/chunks/1.xml

GET /sources/1/chunks/1.mp3

Action index

Action destroy

TimeLabel

Attributes

id

unique identifier

name

string

type

string

mark_at

date

source

associated Source

Action create

name, type

string

date

optional

POST /sources/1/time_labels

Action index

after, before

date range

name_contains

partial string search

type

exact match

GET /sources/1/time_labels.xml?after=2009-09-24 20:38:51.277764163+02:00&name_contains=SPORT

Action destroy

id

identifier

DELETE /sources/1/time_labels/1

Action update

id

identifier

name

string

PUT /sources/1/time_labels/1