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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
DigitalDJ
=========
DigitalDJ is an SQL-based mp3-player frontend. It is designed to work with
Grip. When Grip encodes mp3 files, it will place all of the song information
into an SQL database. DigitalDJ can then use this information to create
playlists based on any number of criteria.
Requirements
============
To use DigitalDJ, you must have:
o Grip (see http://www.nostatic.org/grip)
o GTK+ (see http://www.gtk.org)
o POSIX thread support (http://pauillac.inria.fr/~xleroy/linuxthreads)
o mysql (both the server and the development package --
see http://www.tcx.se)
o an mp3 player (such as mpg123)
Installation
============
If you obtained DigitalDJ from an RPM distribution then it is already
installed. If you have the source distribution, you need to compile it.
To install DigitalDJ, simply go through the following steps:
o after unpacking the source tarball, cd to the extracted directory
o './configure'
o 'make'
o become root if you are installing in a non-user directory
o 'make install'
For information on options to the configure process, run:
./configure --help
DigitalDJ adds the following options that can be specified to configure:
--disable-shared-lirc -- This will for DigitalDJ to link statically with
the lirc client library
--disable-lirc -- This disables linking with lirc entirely
Running DigitalDJ
=================
Digital DJ's usage is:
ddj [options]
where the available options are:
-s Launch in "small" (cd-only) mode
-p Start playing immediately
-t TV mode
-c Console mode (no gui)
-v Verbose (debug) mode
Configuring DigitalDJ
=====================
Before you can use DigitalDJ (or have Grip add song information to the
database) you need to create an SQL user account and initialize the
database. DigitalDJ will attempt to do this automatically for you. If this
fails, you will need to do it manually.
First, configure the options in the "Client" section of the "Config" tab
(see below for more details). Then go to the "Server" tab, enter your mysql
root password (blank if you have not changed it) and click "Log in". Enter
the Username/Host/Password information you entered in the "Client" section,
and click "Add user account". Make sure you click on "Save Configuration" to
save your settings to disck. You are now ready to use DigitalDJ!
Here is a more detailed description of the options under the "Config" tab:
The "Options" tab:
o Player executable: This is the program that will be used to play MP3
files. The switch '%f' will be replaced by the MP3
filename, and the switch '%r' will be replace by
the disc gain adjustment in dB.
o Use X10 serial remote: Select this if you have an X10 remote connected to
your serial port.
o X10 serial device: The serial device the X10 remote is connected to.
o Status output file: DigitDJ will write out information about the song
currently play to this file.
o Album cover directory: If you put album cover art in this directory,
named "<album_id>.jpg", DigitalDJ will dislay the
album cover in TV mode.
o Song list query limit: The maximum number of songs to be pulled from a
database query.
The "Client" tab:
o SQL host: The machine the mysql server is running on. This will generally
be "localhost".
o SQL database: The name of the database that song information will be
stored in.
o SQL username: The username to be used to access the song database.
o SQL passowrd: The password to be used to access the song database.
The "Server" tab:
o Root Password: You need to enter the SQL root password here before you
can acess the server options. On a default mysql
configuration, the root password is blank.
o Log in: Click here after you have entered your root password.
o Initialize SQL database: Clicking this button will create the database
tables that DigitalDJ needs. This should only be
done once.
o User/Host display: This shows the current users for the DigitalDJ
database.
o Username: The name of the SQL user account.
o Host: The host that the user is allowed to access the database from. Use
'localhost' if the server is running on the same machine as the
client.
o Password: The password for the account.
o Add user account: Clicking this button will add the current user to the
access list.
o Delete user account: Clicking this button will remove the current user
from the access list.
Using TV Mode
=============
In TV mode, DigitalDJ will create a 640x480 display to show what is
currently playing. Control currently requires an X10 remote control. The X10
key mapping is as follows:
Play: Start playback or pause
Stop: Stop playback
FF: Skip to the next song
REW: Skip to the previous song
Pause: Pause or resume playback
Vol Up: Increase the volume using the mixer device
Vol Down: Decrease the volume
Mute: Mute the volume
Title: Speak the current song artist/title (requires Festival)
Return: Exits DigitalDJ
Display: Toggle extended track info display
Recall: Return to previous songlist
AB: Randomize current songlist
1: Begin randomized playback of all songs
2: Play songs by the current artist
3: Play songs on the current disc
4: Play songs from the current genre
5: Play songs with the current title
7: Play songs from the current year
8: Play songs within two years
9: Play songs from the current decade
0: Play songs added within the last 30 days
Getting More Help
=================
If you need more help with DigitalDJ, your best resource is the mailing
list. You will find it at:
http://lists.sourceforge.net/mailman/listinfo/ddj-users
Be sure to check the mailing list archives for answers to any questions you
may have.
To report a bug with DigitalDJ, or to submit a patch. Please do so at the
DigitalDJ section on sourceforge.net:
http://sourceforge.net/projects/ddj
License and Disclaimer
======================
DigitalDJ is Copyright (c) 1998-2002 by Mike Oliphant. It may be used and
distributed under the terms of the GNU General Public License. All other
brand and product names are trademarks, registered trademarks or service
marks of their respective holders.
These programs are 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 distribution; if not, write to the Free Software Foundation, Inc., 59
Temple Place, Suite 330, Boston, MA 02111, USA.
Acknowledgments
===============
Thanks go to:
o Everyone involved in GTK development for a wonderful GUI
o Michael Hipp and everyone else involved in creating mpg123
o Robert Leslie for madplay
o Everyone else who has given me feedback and helped test DigitalDJ
---
Mike Oliphant (grip@nostatic.org)
http://nostatic.org/ddj
|
