mpdvolup.py

#!/usr/bin/env python3

"""
Increase MPD volume using python-mpd library.

This script allows you to increase the volume of the Music Player Daemon (MPD) using the settings provided 
in the 'mpd-extended.cfg' configuration file. If the configuration file or its settings are not found, 
the script falls back to default values.

Usage:
    mpdvolup.py [amount]

Arguments:
    amount      Amount by which to increase volume

Examples:
    mpdvolup.py 5     # Increase volume by 5 units
    mpdvolup.py 10    # Increase volume by 10 units

Dependencies:
    - python-mpd library (https://python-mpd.readthedocs.io/en/latest/)
"""


import configparser
import os
import sys
from mpd import MPDClient

def read_config():
    """
    Function to read MPD configuration from mpd-extended.cfg file.
    
    Returns:
    - Dictionary containing MPD configuration.
    """
    config = configparser.ConfigParser()
    mpd_extended_cfg_path = os.path.expanduser("~/.config/mpd/mpd-extended.cfg")
    if not os.path.isfile(mpd_extended_cfg_path):
        print(f"Error: MPD extended configuration file (mpd-extended.cfg) not found at {mpd_extended_cfg_path}")
        sys.exit(1)

    config.read(mpd_extended_cfg_path)
    mpd_config = {
        'SERVER': config['MPD-SCRIPTS'].get('server', 'localhost'),
        'MPD_PORT': int(config['MPD-SCRIPTS'].get('mpd_port', '6600')),
        'MPDPASS': config['MPD-SCRIPTS'].get('password', ''),
        'toggleMaxVolume': config['MPD-SCRIPTS'].getboolean('toggleMaxVolume', fallback=False),
        'maxVolume': int(config['MPD-SCRIPTS'].get('maxVolume', 80))
    }
    return mpd_config

def main():
    # Read MPD server configuration from mpd-extended.cfg
    mpd_config = read_config()
    mpd_server = mpd_config['SERVER']
    mpd_port = mpd_config['MPD_PORT']
    mpd_pass = mpd_config['MPDPASS']
    toggle_max_volume = mpd_config['toggleMaxVolume']
    max_volume = mpd_config['maxVolume']

    # Connect to MPD server
    client = MPDClient()
    client.connect(mpd_server, mpd_port)

    # Authenticate
    if mpd_pass:
        client.password(mpd_pass)

    # Parse command-line arguments
    if len(sys.argv) > 1:
        amount = int(sys.argv[1])
    else:
        # If no arguments are provided, show usage and current volume
        current_volume = client.status().get('volume', 'Unknown')
        print(f"Usage: {sys.argv[0]} [amount]\nCurrent volume: {current_volume}")
        sys.exit(0)

    # Increase volume
    try:
        if toggle_max_volume:
            current_volume = int(client.status().get('volume', 0))
            new_volume = min(current_volume + amount, max_volume)
            client.setvol(new_volume)
            print(f"Volume increased by {new_volume - current_volume} units.")
        else:
            client.volume(f'+{amount}')  # Increase volume by specified amount
            print(f"Volume increased by {amount} units.")
    except Exception as e:
        print(f"Error: {e}")
    
    # Disconnect from MPD server
    client.close()
    client.disconnect()

if __name__ == "__main__":
    main()