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
|
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
============
Configure the Makefile for your system. The INSTALLDIR must be the same
directory that you have Grip installed in. Type 'make' and then 'make
install'.
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. 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:
MP3 options:
o MP3 executable: This is the program that will be used to play MP3
files. The switch '%f' will be replaced by the MP3
filename.
o MP3 file format: This is the format of the full path to the actual mp3
files stored on your system. This should look like the
"Output directory" and "MP3 file format" fields from
Grip combined into a full path. The '%' switches are
a subset of those used in Grip:
o %n - Name of song
o %t - Track number of song
o %a - Artist of song
o %A - Artist of disc
o %d - Name of disc
o Underscore spaces: Use the same setting as you use in Grip.
o Also underscore: Use the same setting as you use in Grip.
Client options:
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.
Server options:
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.
License and Disclaimer
======================
DigitalDJ is Copyright (c) 1998 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 Everyone else who has given me feedback and helped test DigitalDJ
Revision History
================
v0.6 -- November 7th, 1999
--------------------------
o removed "save configuration" button -- config now saved on exit
o added panes to the query window (thanks to Brian J. Murrell for this)
o got rid of ddj's .rc file. the current implementation of themes makes it
all but impossible to have application-specific .rc files handled
intelligently
o overhauled the way input widgets work (lots of effort for no difference
to the end-user, but it was the right thing to do...)
o filenames are now stored in the database, rather than calculated
o *** The database format has changed -- this version is *not* backward
compatible. sorry... :-(
v0.5 -- June 28th, 1999
-----------------------
o track number in mp3 file format is now correct
o fixed crash if query got too long
o added %A switch for disc artist
o fixed "flickering" in disc clist when artist selection changed
o hitting the "previous track" button only goes back a song if playback
is less than a second in (otherwise it restarts the current track)
o fixed a problem that caused a hang if you quit or stopped while paused
o the window now moves if it gets resized off of the screen
o critical colors now done internally rather than through a gtkrc
file. this was necessary because themes (brokenly) override application
rc files
v0.4 -- June 4th, 1999
----------------------
o added a database re-scan button
o ~ now supported in filenames
o clists now use "extended" instead of "multiple" select
o %% now translates as % in switch translation
o ddj is can now insert records even if the user has added database
fields (thanks to John Hoffmann for the patch)
o RPM now installs mp3insert (DOH!)
v0.3 -- May 26th, 1999
----------------------
o disc and song tables now created properly
o year field now supported by mp3insert
o year field now editable in DigitalDJ
o reorganized the server config again
o fixed a problem ddj had in handling blank string fields
v0.2 -- May 24th, 1999
----------------------
o clicking on a song now plays it if there is currently another song
playing
o fixed a problem creating a user account on a remote server
o added a play time indicator
o added an "about" page
o MP3 player is now configurable
o ddj now keeps track of how many times a song/artist/disc has been played,
and when the last time was
o quotes in artist/disc/genre names now escaped properly
o updating of song information now done throuth SQL "update"
o redesigned the BPM calculation interface
o clicking on the LCD display now give "super-condensed" mode
o separated config into "client" and "server"
o made the server config more user-friendly
o a message now pops up at startup if the database does not yet exist
v0.1 -- May 12th, 1999
----------------------
o first beta release
---
Mike Oliphant (oliphant@gtk.org)
http://nostatic.org/ddj
|
