musicpal 0.1.3

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.

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
menu_collapse	close menu on display
play	play media file from (http) url
power_down	suspend device
power_up	wake-up device
show_list	display a list, arguments are the list items
show_msg_box	display a message box
favorites	list favorites if called without arguments, supply favorite index (starting from 0) to select
info	retrieve network information
next_song	skip to next favorite / playlist item
now_playing	WIP
play_pause	toggle playback
show_clock	display clock
volume_dec	turn volume down
volume_inc	turn volume up
volume_set	print current volume if called without arguments, supply value between 0 and 20 to set
reboot	reboot device
restart	restart Nashville
state	display various information about device state

Links

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