Audiogenerators

mpd

picks howmany song randomly from your mpd library. It follows this strategy: it picks howmany artists from your MPD library, then picks a random song for each one

if you specify a prefix, then only files inside the prefix directory will be picked.

randomdir

Given a directory path, scan it recursively, then picks howmany random files. Only files whose filename ends in mp3/ogg/oga/wav are considered . Files are copied to TMPDIR before being returned.

static

That simple: every element in paths is returned. Before doing so, they are copied to TMPDIR.

http

Given a sequence of urls, downloads each one and enqueue it.

This is not suitable for streams (a fundamental limitation of larigira), only for audio files.

mostrecent

It is similar to randomdir, but instead of picking randomly, picks the most recent file (according to the ctime).

podcast

This is probably the most powerful generator that comes included with larigira. To use this generator, you would need to have a valid podcast URL. Beware, here the world podcast refer to its very specific meaning of an xml-based format which resembles a RSS feed but has more media-specific entities. See this specification for more technical details.

So, if you have a valid podcast URL, larigira can look at it, extract audios,

download and play the most recent one. Here are some typical usecases for this: * You want to play replica based on what you host on your radio’s website. * You want to play some audio from some other radio (or other kind of podcast

source)

The podcast form has many many options, but I promise you that 90% of the cases are easily solved using ONLY the first option: enter the URL of the podcast and… it works!

So, what are all the other options for? Well, to cover some other use cases.

For example, let’s say that at night you want to play a random show (not the last one, which is the default) that happened on your radio. Then you can change the “sort by” to be “random”. Easy, right?

Another typical usecase is selecting an audio that has a duration which “fits” with the schedule of your radio: not too long and not too short. You can do that with the “min len” and “max len” fields. For example, setting a min_len of 30min and max_len of 1h15m you can avoid picking flash news (too short) and very long shows.

You can do many other things with its options, but I left those to your immagination. Let’s just clarify the workflow:

  • the podcast URL is fetched and audio information is retrieved
  • filter: audios are filtered by min/max length
  • sort: audios are sorted according to sort_by and reverse
  • select: the n-th episode is fetched, according to start field