Metadata-Version: 2.1
Name: mpdscrobble
Version: 0.2.1
Summary: A simple Last.fm/Libre.fm scrobbler for MPD.
Home-page: https://github.com/dbeley/mpdscrobble
Author: dbeley
Author-email: dbeley@protonmail.com
License: UNKNOWN
Description: # mpdscrobble
        
        A simple Last.fm scrobbler for MPD.
        
        If you are searching for a mpd-compatible last.fm scrobbler, check out first [mpdscribble](https://github.com/MusicPlayerDaemon/mpdscribble), as mpdscrobble has less features than mpdscribble:
        - no journal of failed scrobbles
        - it needs a pair of Last.fm API key/secret instead of just username/password
        
        If you need to scrobble tracks from a mpdscribble journal file, you can use the [`mpdscribble_history.py`](https://github.com/dbeley/mpdscrobble/blob/main/mpdscribble_history.py) script.
        
        ## Requirements
        
        - mpd-python2
        - pylast
        
        ## Installation
        
        Classic installation :
        
        ```
        pip install mpdscrobble
        mpdscrobble -h
        ```
        You will then need to create a config file (see *Configuration* section).
        
        If you want the systemd-service, you will have to install it manually (see *Scheduling* section).
        
        ### Run from source
        
        #### First method
        
        ```
        git clone https://github.com/dbeley/mpdscrobble
        cd mpdscrobble
        python setup.py install --user
        mpdscrobble -h
        ```
        
        #### Second method (with pipenv)
        
        ```
        git clone https://github.com/dbeley/mpdscrobble
        cd mpdscrobble
        pipenv install '-e .'
        pipenv run mpdscrobble -h
        ```
        
        ### On Archlinux
        
        If you are an Archlinux user, you can install the AUR package [mpdscrobble-git](https://aur.archlinux.org/packages/mpdscrobble-git).
        
        ```
        yay -S mpdscrobble-git
        ```
        
        The systemd service file will be automatically installed.
        
        ## Configuration
        
        See [`mpdscrobble.example.conf`](https://github.com/dbeley/mpdscrobble/blob/main/mpdscrobble.example.conf) for an example.
        
        By default, `mpdscrobble` search a config file at `~/.config/mpdscrobble/mpdscrobble.conf`, but you can override the default location with the `-c/--config` flag (see *Usage* section).
        
        ## Scheduling
        
        ```
        curl https://raw.githubusercontent.com/dbeley/mpdscrobble/main/systemd-service/mpdscrobble.service > ~/.config/systemd/user/mpdscrobble.service
        systemctl --user daemon-reload
        systemctl --user enable --now mpdscrobble
        systemctl --user status mpdscribble
        ```
        
        If you installed mpdscrobble from source you can also use:
        
        ```
        cp systemd-service/* ~/.config/systemd/user/
        systemctl --user daemon-reload
        systemctl --user enable --now mpdscrobble
        systemctl --user status mpdscribble
        ```
        
        ## Usage
        
        ```
        usage: mpdscrobble [-h] [--debug] [-c CONFIG_FILE] [--dry-run]
        
        A simple Last.fm scrobbler for MPD.
        
        optional arguments:
          -h, --help            Show this help message and exit.
          --debug               Display debugging information.
          -c CONFIG_FILE, --config_file CONFIG_FILE
                                Config file (default: ~/.config/mpdscrobble/mpdscrobble.conf).
          --dry-run             Disable scrobbling.
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX :: Linux
Description-Content-Type: text/markdown
