musicpal 0.2.1

Command line interface for remote controlling a Freecom MusicPal

musicpal

Command line interface for remote controlling a Freecom MusicPal media player.

The Freecom MusicPal is one of the early hardware media players / internet radios that was released around 2007.

At a price of 100-150 Euros, it was quite cheap and also hackable as it is running a Linux-based OS with easy debugging access and a published development toolchain.

The last stable firmware version 1.67 sports a 2.6.16 Linux kernel. All services are offered by a single application called Nashville which, unfortunately, is closed source.

Usage

usage: musicpal [--help] [-h HOSTNAME] [-u USERNAME] [-p PASSWORD] [-d] [-l]
                [command] [args ...]

Command line client for the Freecom MusicPal.

positional arguments:
  command               command for sending to the MusicPal device (default: state)
  args                  (optional) arguments for given command

optional arguments:
  --help                show this help message and exit
  -h HOSTNAME, --hostname HOSTNAME
                        IP or hostname of the MusicPal device (default: musicpal)
  -u USERNAME, --username USERNAME
                        username for HTTP authorization (default: admin)
  -p PASSWORD, --password PASSWORD
                        password for HTTP authorization (default: admin)
  -d, --debug           print additional output for debugging
  -l, --list            print list available API commands and exit

Available commands are:

Command	Description	Arguments
menu_collapse	close menu on display	None
play	play media file	HTTP URL
power_down	suspend device	None
power_up	wake-up device	None
show_list	display a list	list items to be shown
show_msg_box	display a message box	text to be shown
favorites	list or select favorites	None or favorite index (starting from 0)
info	retrieve network information	None
next_song	skip to next favorite / playlist item	None
now_playing	print currently playing track	None
play_pause	toggle playback	None
show_clock	display clock	None
volume_dec	turn volume down	None
volume_inc	turn volume up	None
volume_set	print or set current volume	None or value between 0 and 20
reboot	reboot device	None
restart	restart Nashville	None
state	display various information about device state	None

Links

• https://musicpal.mcproductions.nl/ - various information about the device