File: README

package info (click to toggle)
cmus 2.3.3-2
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 1,440 kB
  • ctags: 3,053
  • sloc: ansic: 25,337; sh: 1,111; makefile: 181; python: 26
file content (112 lines) | stat: -rw-r--r-- 2,468 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

                     cmus - C* Music Player

		    http://cmus.sourceforge.net/

	 Copyright 2004-2008 Timo Hirvonen <tihirvon@gmail.com>
	 Copyright 2008-2010 Various Authors


Configuration
-------------

List available optional features

  $ ./configure --help

Auto-detect everything

  $ ./configure

To disable some feature, arts for example, and install to $HOME run

  $ ./configure prefix=$HOME CONFIG_ARTS=n

After running configure you can see from the generated config.mk file
what features have been configured in (see the CONFIG_* options).

NOTE: For some distributions you need to install development versions
of the dependencies.  For example if you want to use 'mad' input plugin
(mp3) you need to install libmad0-dev (Debian) or libmad-devel (RPM)
package. After installing dependencies you need to run ./configure
again, of course.

If you want to use the Tremor library as alternative for decoding
Ogg/Vorbis files you have to pass CONFIG_TREMOR=y to the configure
script:

  $ ./configure CONFIG_VORBIS=y CONFIG_TREMOR=y

The Tremor library is supposed to be used on hardware that has no FPU.


Building
--------

  $ make

Or on some BSD systems you need to explicitly use GNU make:

  $ gmake


Installation
------------

  $ make install

Or to install to a temporary directory:

  $ make install DESTDIR=~/tmp/cmus

This is useful when creating binary packages.

Remember to replace 'make' with 'gmake' if needed.


Manuals
-------

  $ man cmus-tutorial

And

  $ man cmus


Mailing List
------------

To subscribe to cmus-devel@lists.sourceforge.net visit

  http://lists.sourceforge.net/lists/listinfo/cmus-devel

The list is open but moderated (you can post to the list without
subscribing but it's not recommended because I have to accept each email
form non-subscribed users).  Traffic of the list is low.


Reporting Bugs
--------------

After a crash send bug report with last lines of ~/cmus-debug.txt to
cmus-devel@lists.sourceforge.net.  The file exists only if you
configured cmus with maximum debug level (./configure DEBUG=2).


Git Repository
--------------

gitweb: http://gitorious.org/cmus
clone:  git://gitorious.org/cmus/cmus.git


Hacking
-------

cmus uses the Linux kernel coding style.  Use hard tabs. Tabs are
_always_ 8 characters wide.  Keep the style consistent with rest of the
code.

Use git format-patch to generate patches from your commits.
Alternatively you can use "diff -up" if you don't want to use git.