details.

.RE

.RS

History of added tracks created when \fBhistory\fP is set to \fBtrue\fP in

sima v0.3.0

 * check playlist queue to add tracks, not only history.

 * Rename history history.pkl

 * add new command line options

 * Now create configuration file looking for available environment variables

   MPD_HOST and MPD_PORT.

 * add --version|-v and --help|-h command line options

 INSTALL

-=-=-=-=-

No installation nor compilation necessary.

    If you set up environment variables MPD_HOST and MPD_PORT then

    MPD_sima will use them to create the conf file.

    Running MPD on localhost should also be fine for MPD_sima even

    If your MPD serveur is not localhost or protected with a password

    set it up in $XDG_CONFIG_HOME/mpd_sima/mpd_sima.cfg

    Usually $XDG_CONFIG_HOME is set to "$HOME/.config/".

    The shell script is just provided as an example, functional though.

    		"sh ./launch.sh"

    		"python ./src/mpd_sima.py --pid=/path/to/my_PID_file.pid"

 CONFIGURATION

You should not need special configuration for regular use apart from

MPD server host/port/password settings.  But if you want more control

over MPD_sima behaviour such as how many track to add to the playlist or

 DEPENDENCIES

 DESCRIPTION - advanced use

-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

present all defaults values for options in both mandatory and optional

MPD_sima will add tracks in your playlist following suggestions from

be defined in the configuration file (mpd_sima.cfg) otherwise the

default values will be used:

queue_length = 2

MPD_sima is controlling MPD's state regularly, the "main_loop_time"

 efficient way to refresh only modified entries (cf. audioscrobbler

 library). Hence, once created, the cache will remain unchanged.

Cache and history files are saved to standard directory $XDG_DATA_HOME,

if not set the default $HOME/.local/share/ is used.

History and cache file are saved only if respective option are set to

true and when you stop MPD_sima properly sending it a SIGTERM (15) or a

SIGINT (2, a.k.a.  interrupt from keyboard / CTRL-C).

 FEED BACK

#

# If you need special settings, rename this file as mpd_sima.cfg within

# your $XDG_CONFIG_HOME (default is $HOME/.config/mpd_sima/)

########################## MANDATORY SECTION ##########################

#

[MPD]

host = localhost

port = 6600

# password is optional, a warning will raise though

password = false

# But well you got bored of the way MPD_sima is behaving, well then go ahead

# play with it :)

[log]

# message are logged to console

#

# verbosity in : debug, info, warning, error

# default if not specify is "info"

verbosity = info

##

#CORE

[sima]

#

# keep history between sessions (pickle/unpickle history)

# to forget history remove $XDG_DATA_HOME/mpd_sima/add_history.pkl

# value: True | False

history = False

# …

# to reset cache remove $XDG_DATA_HOME/mpd_sima/similar_cache.pkl

cache = False

# Missing Description…

queue_length = 2

main_loop_time =  4

#

from __future__ import (with_statement)

__revison__ = "$Revision$"[11:-2]

__author__ = "$Author$"

__date__ = (

from lib.audioscrobbler import (AudioScrobblerQuery,

        AudioScrobblerConnectionError)

import lib.mpdConnector as mpdConnector

from utils.leven import levenshtein_ratio

from utils.logutil import (sima_logger, LEVELS)

from utils.startopt import StartOpt

            track = artist_nolist(track)

            if not self.is_inqueue(track) and \

               track not in self.tracks_to_add:

                if not self.is_inhist(track):

                    selected_track = track

                    break

        mpd_status = self.mpd_connection.status()

        queue_lgh = self.sima_config.getint('sima', 'queue_length')

        mfile = self.mpd_connection.currentsong().get('file', None)

        if (int(mpd_status['playlistlength']) - int(mpd_status['song']) - 1 >

            int(queue_lgh)):

            return False

            return False

        if not title:

        # MPD state

        #self.current_title = title

        #self.current_artist = artist

            unplayed_track = self.extract_unplayed(mpd_find)

            if not unplayed_track:

                SIMA_LOGGER.info('Unable to find title to add'+

                if artist in self.mpd_add_history:

                    SIMA_LOGGER.info(

                            'History already gathers %i titles for %s.' %

            pickle.dump(cache_stamp, cache_fd, -1)#}}}

def similar_artist(s_artist):#{{{

    """

    """

    as_artist_names = []

    if s_artist in CACHE:

        as_artist_names = CACHE[s_artist]

        SIMA_LOGGER.debug('"%s" already in cache, not requesting last.fm.' %

                s_artist)

    else:

        for artist in as_artists.similar():

            as_artist_names.append(str(artist.name))

        CACHE[s_artist] = as_artist_names

    return as_artist_names#}}}

    SIMA_LOGGER = sima_logger()

    StartOpt(SIMA_LOGGER,(__version__, __revison__, __date__))

    # Configuration manager Object

    CONF_MANAGER = ConfMan(SIMA_LOGGER)

    CONFIG = CONF_MANAGER.control_conf()

    # Load Cache

    if CONFIG.getboolean('sima', 'cache'):

        CACHE, CACHE_STAMP = load_cache(CONF_MANAGER.similar_cache)

    # Logging settings

    # Define the logger following user conf

    #  default log level is INFO.

        except KeyboardInterrupt, int_err:

            if CONFIG.getboolean('sima', 'history'):

                SIMA.writehist(CONF_MANAGER.history_file)

                writecache(CONF_MANAGER.similar_cache)

                if CACHE_STAMP:

                    DELTA = date.today() - CACHE_STAMP['DATE']

# IMPORTS {{{

from __future__ import with_statement

import sys

from os import (makedirs, environ, stat, chmod, rename)

from os.path import (join, isdir, isfile, expanduser)

#}}}

#DEFAULTS{{{

CONF_FILE = 'mpd_sima.cfg'

# Mandatory user options

M_SECTIONS = ['MPD']

        'sima': {

            'history': "false",

            'cache': "false",

            'queue_length': "2",

            'track_to_add': "1",

            'main_loop_time': "4"},

#}}}

#CONFIG MANAGER CLASS{{{

        self.conf_file = None

        self.history_file = None

        self.similar_cache = None

        self.config = None

        self.defaults = DEFAULT_CONF

        self.sima_logger = logger

        self.control_mod()#}}}

    def mpd_environ(self):#{{{

        mpd_host_pass = environ.get('MPD_HOST').split('@')

        if mpd_host_pass[0]:

            self.sima_logger.info('MPD_HOST set to "%s", setting up conf file.' %

        self.similar_cache = join(data_dir, "similar_cache.pkl")

        self.conf_file = join(conf_dir, CONF_FILE)

        # Load conf

        if not isfile(self.conf_file):

            self.config_write_default()