Introduction

.. note::

This library is in a very early developement stage and far from being usable.

libmunin is a fancy music recommendations library which is based on datamining algorithms of all kind. Bonus: It's able to learn from you! I write it for my bachelor thesis and therefore it's still in developement.

Documentation is build on every commit http://www.readthedocs.org:

http://libmunin.readthedocs.org/en/latest/

Tests are run on every commit via http://travis-ci.org:

https://travis-ci.org/sahib/libmunin

Screenshot of the Demo GUI

.. image:: http://libmunin.readthedocs.org/en/latest/_images/gui.png :alt: demo gui screenshot

The Demo GUI is based on moosecat_. Source code is available in the naglfar branch, under moosecat/naglfar/main.py.

.. _moosecat: https://github.com/studentkittens/moosecat/tree/naglfar

Installation

.. image:: https://travis-ci.org/sahib/libmunin.png?branch=master :target: https://travis-ci.org/sahib/libmunin :alt: Travis Page

.. image:: https://badge.fury.io/py/libmunin.png :target: http://badge.fury.io/py/libmunin :alt: PyPI package link

.. image:: https://pypip.in/d/libmunin/badge.png :target: https://crate.io/packages/libmunin :alt: Number of PyPI downloads

Required externam programs

The moodbar binary is required for gthe mood-analysis. Future versions might implement the mood-analysis themselves, or at least package it along libmunin.

Your distribution might package it or you can compile it from here:

http://pwsp.net/~qbob/moodbar-0.1.2.tar.gz

The moodbar is not strictly required but recommended.

Required Python Modules

All modules are Python3 compatible:

.. code-block:: bash

$ sudo pip install -r pip_requirements.txt --use-mirrors

Optional modules and modules useful for Data-Retrieval

.. code-block:: bash

$ sudo pip install -r pip_optional_requirements.txt --use-mirrors