What is Emacs ?

Emacs is the extensible, customizable, self-documenting real-time display editor. This Editor is used to do a lot of things, from IRC to reading mails and news, along with "basic" editing, advanced macro, remote control, multimedia player, and so on..

This webpage is about EMMS, an Emacs "package" that you use to extend Emacs features to multimedia.

The cute EMMS logo

Quick-Start Guide

DISCLAIMER: EMMS is being constantly developed, and the README file is the definitive guide for using EMMS.

Installation

Get the development branch (it's very stable) via git or the latest snapshot:

 
         $ git clone git://git.sv.gnu.org/emms.git
        
If you are behind a restrictive firewall, then do the following instead:
 
         $ git clone http://git.sv.gnu.org/r/emms.git
        

Next, add the following lines to your emacs config:


        (add-to-list 'load-path "~/elisp/emms/")
        (require 'emms-setup)
        (emms-standard)
        (emms-default-players)
        
That's it, EMMS is now installed and ready to use!

Configuration

If you want to use some of the latest features, such as the collection browser, consider changing (emms-standard) to (emms-devel)

Usage

More information about keybindings, etc are available in the README file.

Further configuration

EMMS is very customizable. Here are some code snippits as examples of what can be done.

        
          ;; Show the current track each time EMMS
          ;; starts to play a track with "NP : "
        (add-hook 'emms-player-started-hook 'emms-show)
        (setq emms-show-format "NP: %s")
        
          ;; When asked for emms-play-directory,
          ;; always start from this one 
        (setq emms-source-file-default-directory "~/zic/")
        
          ;; Want to use alsa with mpg321 ? 
        (setq emms-player-mpg321-parameters '("-o" "alsa"))
      

Configuration files

Some example configuration files: