diff options
Diffstat (limited to 'emms.texinfo')
-rw-r--r-- | emms.texinfo | 71 |
1 files changed, 70 insertions, 1 deletions
diff --git a/emms.texinfo b/emms.texinfo index 1b00957..0ea97fb 100644 --- a/emms.texinfo +++ b/emms.texinfo @@ -52,6 +52,7 @@ Starting out * Installation:: How to install Emms on your System. * Simple Setup:: Quick, basic default Emms setup. * Configuration:: More detailed setup and configuration. +* Quickstart Guide:: First steps with EMMS for new users. Emms basics * Basic Commands:: How to control Emms with ease. @@ -106,7 +107,7 @@ The Core File Track Information * Defining Info Methods:: Defining new info methods. -Volume +Last.fm * Submitting track informations:: How to submit track information to last.fm. * Last.fm radio:: How to listen to last.fm radio. @@ -335,6 +336,74 @@ have GNU/find installed. The method Emms will use is defined in the customisable variable @var{emms-source-file-directory-tree-function}. +@node Quickstart Guide +@chapter Quickstart Guide + +This chapter demonstrates how to setup EMMS so that you can start +listening to your music without having to read the whole docs first. + +The first thing you have to do is telling emacs where the sources of +EMMS are located. Let's say you have them in @file{~/elisp/emms/}. So +add this line to your @file{.emacs}. + +@lisp +(add-to-list 'load-path "~/elisp/emms") +@end lisp + +Further informations about installing EMMS can be found in the +installation chapter, @xref{Installation}. + +Let's say you want to enable all features which are considered stable by +the EMMS developers. To achieve this you invoke the @code{emms-all} +setup function by adding those three lines to your @file{.emacs}. + +@lisp +(require 'emms-setup) +(emms-all) +(emms-default-players) +@end lisp + +The function @code{emms-default-players} in the last line sets up the +list of default players. The list contains lightweight specialized +players like ogg123 or mpg321 and we-play-everything-players like +mplayer or xine. To be sure that emms can play all your music you should +check that the needed players are installed. + +Further informations about the several setup scripts can be found in the +simple setup chapter, @xref{Simple Setup}. + +Of course EMMS tries to display the tags of the music files you listen +to. For this to work you have to make sure that the appropriate programs +are installed. For mp3 files you need `mp3info', for ogg files you need +`ogginfo'. + +The last thing to do is to tell EMMS the root directory of our music +collection. Let's say all your music is in @file{~/Music} or in +subdirectories thereof. + +@lisp +(setq emms-source-file-default-directory "~/Music/") +@end lisp + +Ok, now we've set up EMMS. Reload your @file{.emacs} or restart Emacs to +let the changes have an effect. + +Now we will add all our music to a playlist by invoking @kbd{M-x +emms-add-directory-tree RET ~/Music/ RET}. We do this because then EMMS +will read the tags of all your music files and cache them. This is +required for the browser, @xref{The Browser}. + +To switch to the playlist buffer invoke @kbd{M-x +emms-playlist-mode-go}. You can see that most tracks are displayed with +their file name, but track by track the filename gets replaced with the +artist and track name of the file's tag. + +Hit @kbd{RET} on a track to start playback. + +Now you can start exploring EMMS. It's probably best to begin with the +basic commands (@pxref{Basic Commands}), the interactive playlists +(@pxref{Interactive Playlists}), and the browser (@pxref{The Browser}). + @node Basic Commands @chapter Basic Commands |