Audiogenerators
===============

mpdrandom
---------

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

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).

script
--------

see :doc:`audiogenerators-write`
