README

   1
   2                      cmus - C* Music Player
   3
   4                 http://onion.dynserv.net/~timo/cmus.html
   5
   6          Copyright 2004-2006 Timo Hirvonen <tihirvon@gmail.com>
   7
   8
   9 Installation
  10 ============
  11
  12 Configuration
  13 -------------
  14
  15 List available optional features
  16
  17   $ ./configure --help
  18
  19 Auto-detect everything
  20
  21   $ ./configure
  22
  23 To disable some feature, arts for example, and install to $HOME run
  24
  25   $ ./configure prefix=$HOME CONFIG_ARTS=n
  26
  27 After running configure you can see from the generated config.mk file
  28 what features have been configured in (see the CONFIG_* options).
  29
  30 NOTE: For some distributions you need to install development versions
  31 of the dependencies.  For example if you want to use 'mad' input plugin
  32 (mp3) you need to install libmad0-dev (Debian) or libmad-devel (RPM)
  33 package. After installing dependencies you need to run ./configure
  34 again, of course.
  35
  36 If you want to use the Tremor library as alternative for decoding
  37 Ogg/Vorbis files you have to pass CONFIG_TREMOR=y to the configure
  38 script:
  39
  40   $ ./configure CONFIG_VORBIS=y CONFIG_TREMOR=y
  41
  42 The Tremor library is supposed to be used on hardware that has no FPU.
  43
  44 Building
  45 --------
  46
  47   $ make
  48
  49 Or on some BSD systems you need to explicitly use GNU make:
  50
  51   $ gmake
  52
  53 Installation
  54 ------------
  55
  56   $ make install
  57
  58 Or to install to a temporary directory:
  59
  60   $ make install DESTDIR=/tmp/cmus
  61
  62 This is useful when creating binary packages.
  63
  64 Remember to replace 'make' with 'gmake' if needed.
  65
  66
  67 Mailing List
  68 ============
  69
  70 To subscribe to cmus-devel@lists.sourceforge.net visit
  71
  72   http://lists.sourceforge.net/lists/listinfo/cmus-devel
  73
  74 The list is open (you can post to the list without subscribing).
  75
  76
  77 Reporting Bugs
  78 ==============
  79
  80 After a crash send bug report with last lines of /tmp/cmus-debug (or
  81 $TMPDIR/cmus-debug) to cmus-devel@lists.sourceforge.net.  The file
  82 exists only if you configured cmus with maximum debug level
  83 (./configure DEBUG=2).