A radio automation based on MPD.
Find a file
boyska e98737e549
FIX crash on file:// if MPD_HOST is not a socket
mpd allows inserting file:/// only through a unix-domain socket, not
through TCP. This was causing the player to crash when such a thing was
happening. This will now not crash, only log the error
2016-07-20 11:07:00 +02:00
doc/source FIX apidoc generation 2016-07-19 16:52:49 +02:00
larigira FIX crash on file:// if MPD_HOST is not a socket 2016-07-20 11:07:00 +02:00
.gitignore FIX apidoc generation 2016-07-19 16:52:49 +02:00
conftest.py http testing 2014-10-27 00:44:55 +01:00
MANIFEST.in FIX larigira.dbadmin packaging 2015-02-19 20:29:54 +01:00
README.rst s/ejdb/tinydb, clear eventmodel, some testing 2015-01-24 00:33:09 +01:00
requirements.txt celery is not used anymore 2016-07-19 15:19:03 +02:00
setup.py WebUI supports frequency timegen 2016-07-18 14:38:03 +02:00

=========
larigira
=========

About
-------

A radio automation based on MPD. Larigira will sit right to your mpd player and
will keep your playlist never empty. It will also manage a db of "events", so
that you can schedule shows, play jingles every X minutes, etc.

Software stack
---------------

* MPD, of course
* python2
  * gevent as an async framework
  * flask to provide web interface and rpc
* tinydb as an embedded database

Why? (aka design features)
--------------------------

Reinventing a player is a bad idea. MPD provides an eccellent base.

Separating the player from "action loops" makes it easy to work on this. For
example, you can stop larigira for some minutes, and the audio will keep
playing. It also means that you can easily replace specific parts of your radio
automation.

The "continous playing" part is separated from the "events" part.  ``larigira``
can be run to perform one, the other, or both.

The "audio generation" part can be used separately by any script that you like.

Installation
-------------

Just run ``python setup.py install``. It will, of course, also work in a
virtualenv. Apart from running an MPD server, there is no additional setup.

You will find some command in your PATH now; they all begin with ``larigira``,
so the usual ``<TAB><TAB>`` is a good way to explore them ;)

The name
---------

    larigira mai la sbaglia...
    
    -- https://www.youtube.com/watch?v=K9XJkOSSdEA