<commit_before>oiseau
------

Extremely hacky [Last.fm][lfm] scrobbler for MPD that I wrote for myself (because every other scrobbler sucked).

Pros:

- Makes sure to submit each track "at most" once.
- Supports submitting the currently playing track as "Now Playing" on Last.fm

Cons:

- Scrobbles a track immediately after the song starts.
- Doesn't have arguments/configs/documents/help etc, you have to modify the source code.
- Doesn't support the album artist tag (who cares)
- Doesn't cache tracks for later scrobbling

TODO:

- Cache tracks for later scrobbling

Usage
-----

Open `oiseau.py` and edit the following lines:

    # -------------------------
    # Configuration
    # -------------------------
    
    LFM_USERNAME = "Your Last.fm username"
    LFM_PASSWORD = "<PASSWORD>"
    MPD_HOST     = "MPD hostname"
    MPD_PORT     = MPD port
    MPD_PASSWORD = None  | If you have a password, write it in quotation marks
    MPD_UNICODE  = True  | Use unicode on MPD
    DEBUG        = False | Speaks for itself
    
    # -------------------------
    # Here be dragons ...
    # -------------------------

Mark the file as executable, move it into somewhere in the $PATH and you're ready.

Requirements
------------

- Tested on Python 2.7.6
- [python-mpd2][py27-mpd2] >= 0.5.3
- [pylast][pylast] >= 0.5.11


[lfm]: http://www.last.fm
[py27-mpd2]: https://github.com/Mic92/python-mpd2
[pylast]: https://code.google.com/p/pylast/<commit_msg>update TODO and requirements<commit_after>oiseau
------

Extremely hacky [Last.fm][lfm] scrobbler for MPD that I wrote for myself (because every other scrobbler sucked).

Pros:

- Makes sure to submit each track "at most" once.
- Supports submitting the currently playing track as "Now Playing" on Last.fm

Cons:

- Scrobbles a track immediately after the song starts. (TODO: Fix this)
- Doesn't have arguments/configs/documents/help etc, you have to modify the source code.
- Doesn't cache tracks for later scrobbling (TODO: Fix this)

TODO:

- Wait until the half of the song before scrobbling it to Last.fm
- Cache tracks for later scrobbling

Usage
-----

Open `oiseau.py` and edit the following lines:

    # -------------------------
    # Configuration
    # -------------------------
    
    LFM_USERNAME = "Your Last.fm username"
    LFM_PASSWORD = "<PASSWORD>"
    MPD_HOST     = "MPD hostname"
    MPD_PORT     = MPD port
    MPD_PASSWORD = <PASSWORD>  | If you have a password, write it in quotation marks
    MPD_UNICODE  = True  | Use unicode on MPD
    DEBUG        = False | Speaks for itself
    
    # -------------------------
    # Here be dragons ...
    # -------------------------

Mark the file as executable, move it into somewhere in the $PATH and you're ready.

Requirements
------------

- Tested on Python 2.7.6
- Requires MPD >= 0.15, tested on MPD 0.18.11
- [python-mpd2][py27-mpd2] >= 0.5.3
- [pylast][pylast] >= 0.5.11


[lfm]: http://www.last.fm
[py27-mpd2]: https://github.com/Mic92/python-mpd2
[pylast]: https://code.google.com/p/pylast/
{'fraction_non_alphanumeric': 0.16985488126649076, 'fraction_numerical': 0.0158311345646438, 'mean_word_length': 2.2061310782241015, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 11, 'https://': 4, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1102061', 'n_tokens_mistral': 999, 'n_tokens_neox': 949, 'n_words': 329}