File: README

package info (click to toggle)
irmp3 0.4.3pre6-2
  • links: PTS
  • area: main
  • in suites: woody
  • size: 584 kB
  • ctags: 374
  • sloc: ansic: 3,955; makefile: 212; pascal: 39
file content (138 lines) | stat: -rw-r--r-- 4,196 bytes parent folder | download
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

	IRMP3 - multimedia audio jukebox for Linux
	http://www.dpotter.com/irmp3/

	Copyright (C) by Andreas Neuhaus and David Potter
	<andy@fasta.fh-dortmund.de> <dp-irmp3@dpotter.com>

	Please send comments, questions, submissions to 
	David Potter <dp-irmp3@dpotter.com>

GENERAL
-------

IRMP3 is a multimedia audio jukebox for Linux. Normally it runs in
background and does not provide any screen output. IRMP3 can be used
to play mp3 files and has support for several input and display devices,
like IR remote controls, LCD displays and keypads. A flexible,
modularized source allows easy implementation of new functions.


COPYING
-------
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program in a text-formatted file named COPYING; if 
not, write to the Free Software Foundation, Inc., 59 Temple Place - 
Suite 330, Boston, MA  02111-1307, USA.


FEATURES
--------
 - Plays mp3 files and http streams (mpg123 required).
 - Plays audio CD's and manages CD media load/eject
 - Powerful configuration for easy customization.
 - Playlist loadable from file or by recursively scanning dirs.
 - Support for alarms, cron-triggered events.
 - Can produce audible beeps for users without a display.
 - Repeat single, repeat all and shuffle functions.
 - Mixer support for volume, balance, bass and treble settings.
 - Sleep timer with volume-fadeout.
 - Support control with IR remote controls (LIRC required).
 - Display status (song name, time, volume, etc) on LCDisplays (LCDproc
   required).
 - External keypad to control player (LCDproc required).
 - Flexible, modularized source allows easy implementation of new functions
   to developers.


OPTIONAL SOFTWARE
-----------------

IRMP3 does not handle everything itself but may use external programs
for it (e.g. for playing mp3 files). Depending on what you want to do,
you may require one or more of the following programs:

 - mpg123 (for playing mp3 files or streams)
	Version 0.59r or later is required (control_generic support
	is required).

 - LIRC (if you want to control your jukebox with an IR remote control)
	Version 0.5.1 or later required.

 - LCDproc (if you want LCD output or keypad input)
	Version 0.4-pre6 or later required.
	NOTE:  version 0.4-pre9 appears to SEGFAULT when used with IRMP3.
	version 0.4-pre8 does not have this problem.

 - a utility to play soundfiles (.wav .au) on your system.


RELATED LINKS
-------------

The IRMP3 homapge:
	http://www.dpotter.com/irmp3
The mpg123 homepage:
	http://www-ti.informatik.uni-tuebingen.de/~hippm/mpg123.html
The LIRC homepage:
	http://fsinfo.cs.uni-sb.de/~columbus/lirc/
The LCDproc homepage:
	http://lcdproc.omnipotent.net/


MORE INFORMATION
----------------

See the following files for more information:

COPYING		GNU General Public License
INSTALL		Installation guide for IRMP3
CONFIG		How to configure IRMP3
COMMANDS	List of IRMP3 commands
PROBLEMS	Troubleshooting
DEVELOPER	Information for developers
HISTORY		Version history


MAILING LIST
------------

There's a mailing list for the discussion of IRMP3
usage, development, problems.  This is also used
to announce new versions. If you want to join,
simply visit:
	http://lists.sourceforge.net/lists/listinfo/irmp3-discussion


CREDITS
-------

Thanks to everybody who helped develop and test this 
program, including:

	Josh Pieper <josh@nemonet.com>
		who provided me may ideas and code
		examples, especially with the module
		support and the message passing
		interface. Thanks a lot, Josh.

	David Glaude <dglaude@comtech.be>
		for his help on LCDproc.

	Wilton Wong <wwong@blackstar.net>
		for "playlist jumpdir" and some other
		improvements.

	Vladimir Nadvornik <vnd@seznam.cz>
		for mod_cd.