Table of Contents
I. empxform
empxform -- Manipulation of rmp/emp files from emusic

I. empxform

Table of Contents
empxform -- Manipulation of rmp/emp files from emusic

empxform

Name

empxform -- Manipulation of rmp/emp files from emusic

Synopsis

empxform [-nhl] [-f format] filename.emp

Description

empxform is designed as a mime handler/processor for emp/rmp music description files used by services like emusic. It can be used to download complete albums using wget(1) or curl(1), create playlists in m3u or xml format and launch arbitrary applications based on the contents of the rmp file.

To use empxform from your web browser create a mime type for "application/vnd.emusic" for files matching *.emp and set empxform as the handler.

  • Mozilla - New mime types can be added by going to [Edit]->[Preferences]->[Helper Applications]->[New Type]

  • Konqueror - New mime types can be added by going to [Settings]->[Confugure Konqueror]->[File Associations]->[Add]

The configuration file lists a number of format templates with variables used to represent information from the rmp file like the artist and album names, track titles, etc. When invoked the program generates output for each of the specified formats in sequence. The following fomrats are supported in the default distribution:

  • download-curl - Download with curl

  • download-wget - Download with wget

  • log - log the download to working-dir/empxform.log

  • pjb - create a script to send the disc to a pjb mp3 player

  • play-noatun - play from a local copy, should be combined with a dowload

  • play-xmms - play from a local copy, should be combined with a dowload

  • playlist-m3u - Create a m3u format playlist

  • playlist-m3u-remote - Create a m3u format playlist that plays directly from the network

  • playlist-xml - create an xml playlist

  • remote-play-noatun - play with noatun directly from net with no download

  • remote-play-xmms - play with xmms directly from net with no download

Options

-n, --no-wait

Dont wait for child processes before continuing with the next format.

-h, --help

Display a brief help message.

-l, --list

List the available output formats.

-f, --format=name

Process the emp file with this format, this may occur more than once and formats will be executed in the order they appear on the command line. If this option is given the default formats in the config file are ignored. If a format name starts with the '<' character it's treated as an inline format and pased as though it was the contents of format entry in the config file (see empxformrc(5) for details). For example, to display all the track names in an rmp file use empxform -f "<track>%t</track>" emp_file Inline formats should not include the <format> tag.

Files

/usr/share/empxform/empxformrc, /usr/local/share/empxform/empxformrc

The system wide configuration files, see empxformrc(5) for details

~/.empxform.xml

Per user configuration file, see empxformrc(5) for details

Author

Cameron Dorrat ()

Examples

  • To list all the track names in Trance_Nation.emp:

    empxform -f "<track>%t</track>" Trance_Nation.emp

  • To perform the set default actions on Trance_Nation.emp:

    empxform Trance_Nation.emp

  • To download a complete album with wget and create a m3u format playlist:

    empxform -f download-wget -f playlist-m3u Trance_Nation.emp

  • To play the album specified in Trance_Nation.emp directly from the network:

    empxform -f playlist-m3u-remote Trance_Nation.emp

See Also

empxformrc(5)