Browse Source

DOC: complete audiogenerators

boyska 4 years ago
parent
commit
9aacbc88fb
1 changed files with 15 additions and 2 deletions
  1. 15 2
      doc/source/audiogenerators.rst

+ 15 - 2
doc/source/audiogenerators.rst

@@ -11,8 +11,7 @@ randomdir
 ----------
 
 Given a directory ``path``, scan it recursively, then picks ``howmany`` random
-files. No filename extensions checks are done, so beware of non-audio file in
-that directory. Files are copied to ``TMPDIR`` before being returned.
+files. Only files whose filename ends in mp3/ogg/oga/wav are considered . Files are copied to ``TMPDIR`` before being returned.
 
 static
 ---------
@@ -20,6 +19,20 @@ 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
 --------