Home Explore Help
Register Sign In
boyska
/
larigira
1
0
Fork 0
Files Issues 13 Pull Requests 0
Tree: d19b18eb3c
Branches Tags
larigira
/
README.rst

README.rst 1.8 KB
History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364 
  1. =========
    2. 

  2. larigira
    3. 

  3. =========
    4. 

  4. 

  5. .. image:: https://travis-ci.org/boyska/larigira.svg?branch=master
    6. 

  6.     :target: https://travis-ci.org/boyska/larigira
    7. 

  7.     :alt: Build status
    8. 

  8. 

  9. .. image:: https://drone.degenerazione.xyz/api/badges/boyska/larigira/status.svg?branch=master
    10. 

  10.     :alt: Build status on self-managed CI server
    11. 

  11. 

  12. .. image:: https://img.shields.io/pypi/v/larigira.svg
    13. 

  13.     :target: https://pypi.python.org/pypi/larigira
    14. 

  14.     :alt: Latest Version
    15. 

  15. 

  16. 

  17. About
    18. 

  18. -------
    19. 

  19. 

  20. A radio automation based on MPD. Larigira will sit right to your mpd player and
    21. 

  21. will keep your playlist never empty. It will also manage a db of "events", so
    22. 

  22. that you can schedule shows, play jingles every X minutes, etc.
    23. 

  23. 

  24. Software stack
    25. 

  25. ---------------
    26. 

  26. 

  27. * MPD, of course
    28. 

  28. * python3.5 or greater
    29. 

  29. 

  30.   - gevent as an async framework
    31. 

  31.   - flask to provide web interface and rpc
    32. 

  32. * tinydb as an embedded database
    33. 

  33. 

  34. Why? (aka design features)
    35. 

  35. --------------------------
    36. 

  36. 

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

  38. 

  39. Separating the player from "action loops" makes it easy to work on this. For
    40. 

  40. example, you can stop larigira for some minutes, and the audio will keep
    41. 

  41. playing. It also means that you can easily replace specific parts of your radio
    42. 

  42. automation.
    43. 

  43. 

  44. The "continous playing" part is separated from the "events" part.  ``larigira``
    45. 

  45. can be run to perform one, the other, or both.
    46. 

  46. 

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

  48. 

  49. Installation
    50. 

  50. -------------
    51. 

  51. 

  52. Just run ``python setup.py install``. It will, of course, also work in a
    53. 

  53. virtualenv. Apart from running an MPD server, there is no additional setup.
    54. 

  54. 

  55. You will find some command in your PATH now; they all begin with ``larigira``,
    56. 

  56. so the usual ``<TAB><TAB>`` is a good way to explore them ;)
    57. 

  57. 

  58. The name
    59. 

  59. ---------
    60. 

  60. 

  61.     larigira mai la sbaglia...
    62. 

  62.     
    63. 

  63.     -- https://www.youtube.com/watch?v=K9XJkOSSdEA
    64. 

  64.