Next: , Previous: Installation, Up: Top



3 Simple Setup

After adding the location of the Emms code to the load-path variable, see See Installation. We invoke the following using the `emms-setup' feature which allows for quick and simple Emms setup.

     (require 'emms-setup)
     (emms-standard)
     (emms-default-players)

After which Emms is set-up and ready to go!

The above will setup Emms with standard features (interactive playlists, audio track tag reading etc.) and a default list of players (ogg, mp3, mplayer etc.).

The `emms-setup' feature is provided by the file emms-setup.el. It is essentially a collection of shortcuts for setting up Emms quickly and simply. Everything you can do with `emms-setup' can also be done manually.

We use `emms-setup' by calling one of the setup functions. Each of the functions sets up Emms to include a number of features.

— Function: emms-minimalistic

An Emms setup script. Invisible playlists and all the basics for playing media.

— Function: emms-standard

An Emms setup script. Everything included in the emms-minimalistic setup, the Emms interactive playlist mode and reading information from tagged audio files.

— Function: emms-all

An Emms setup script. Everything included in the emms-standard setup and adds all the stable features which come with the Emms distribution.

— Function: emms-devel

An Emms setup script. Everything included in the emms-all setup and adds all of the features which come with the Emms distribution regardless of if they are considered stable or not. Use this if you like living on the edge.

`emms-setup' also comes with a convenience function to set a default list of media players.

— Function: emms-default-players

Set emms-player-list to emms-setup-default-player-list.

It is also worth noting that you can write your own Emms setup functions like the above by looking at the existing function definitions in emms-setup.el.