-
Notifications
You must be signed in to change notification settings - Fork 0
/
ntfy_cd.txt
717 lines (506 loc) · 25.9 KB
/
ntfy_cd.txt
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
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
Notify CD Player
for Windows 95, Windows NT 4.0, Windows 2000 and Windows XP
Version 1.61
Copyright (c) 2004, Victor Luchits
http://ntfycd.sourceforge.net
Copyright (c) 1996-1998, Mats Ljungqvist
http://www.artech.se/~mlt/software
Snail: Mats Ljungqvist
Patron Pehrs v. 27
S-141 35 HUDDINGE
SWEDEN
--- Contents ---------------------------------------------------------------
1. Introduction
2. Legal stuff
3. How to install/uninstall
4. How to use
- The fast left-click functions
- The right-click context menu
- CD Info/Program
- Options
- CD Database Editor
5. Command-line options
6. Feedback, suggestions, bug-reports
7. Credits
--- 1. Introduction --------------------------------------------------------
Notify CD Player is a CD player for regular audio CD's (including mixed
data/audio) and resides in the systray (Also called Notify Tray).
It works on Windows 95, Windows NT 4.0, Windows 2000 and Windows XP.
Built in support for the Internet based CD database CDDB which
currently has more than 100,000 CD entries. (http://cddb.com).
You might also want to check FreeDB CD database (http://freedb.org).
The original Notify CD Player was written by Mats Ljungqvist ([email protected]).
The CDDB database was originally developed by Ti Kan ([email protected]) and
the CDDB server by Steve Scherf ([email protected]).
Fast operation of the most commonly used actions by left-clicking a
configurable number of times on the icon or click-draggin the icon.
System-wide hotkeys can alse be configured to control the same functions.
It has an extensive amount of functionality in the context menu shown by
right-clicking the icon.
Tray displays current "play" status.
Other features include:
- Compatible with the CD database used by the standard CD Player.
- Highly configurable tooltip and caption CD/track information display.
- Configurable track menu that shows the actual track names.
- Programmed play.
- Random/Repeat (Whole or Track).
- Skip function to change position inside a track.
- CD DB Editor with Export/Import functions.
- Responds to different Windows requests to allow autoplay etc.
- Can be set to exit when the CD is removed for seamless operation.
--- 2. Legal stuff ---------------------------------------------------------
Notify CD Player for Windows 95, Windows NT 4.0, Windows 2000 and Windows XP
Copyright (c) 2004, Victor Luchits ([email protected])
Copyright (c) 1996-1998, Mats Ljungqvist ([email protected])
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; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
Source code should be available at
http://sourceforge.net/projects/ntfycd/
and
http://artech.se/~mlt/software/src/
--- 3. How to install/uninstall --------------------------------------------
Run the NCDSetup.exe file supplied with this archive and follow instructions.
Use the control panel "Add/Remove Programs" applet to completely
uninstall Notify CD Player.
--- 4. How to use ----------------------------------------------------------
- Fast control of misc functions
--------------------------------
For faster operation a number of functions can be configurably
controlled by clicking a number of times on the icon, click-dragging
on the icon or by pressing a configurable hotkey.
All these operations can be configured in the Controls tab
The default settings are:
Pause/Resume 1 click
Play/Next 2 click
Prev 3 clicks
Stop 4 clicks
So to start playing Your CD, if it's not already playing due to
Windows autoplay, You can click once on the icon.
Note how the icon change from the "stop" icon to the "play" icon!
To pause, click two times on the icon. The icon changes to a "pause"
icon.
To resume click one or two times (in this case Play/Next is the same
as resume). The CD starts to play again.
Change to the next track by clicking one time on the icon.
Stop the CD by clicking four times. The icon changes back to the
"stop" icon.
- The right-click context menu
------------------------------
The right-click context menu contains everything Notify CD Player can
do besides the fast left-click functions.
The common Play/Stop/Next/Prev etc are all there, so are a Tracks
menu, open and close options, play mode etc
Play mode
---------
- Repeat. Repeat the current playlist.
- Random. Random play the playlist.
- Play whole which causes the player to bypass any playlist You might
have set up in the CD Info/Program dialog, but it doesn't remove
the playlist from the configuration for this CD.
- Repeat Track causes the current track to be repeated.
Tracks
------
Choose the Tracks submenu and You'll see the names of the tracks (if
You have any DB with data in it) or the default "Track 1" names along
with track lengths. You can choose which track to play by selecting
it in the tracks menu.
The tracks menu can also be configured to be a separate column in the
context menu and then the Tracks submenu will dissapear.
The tracks menu can also be divided into submenys if the CD You
currently have in the player has more than 25 tracks.
This function can be disabled in the options dialog if You have a
high screen resolution and therefore doesn't need to break up the
tracks.
Other
-----
The Other submenu contains less used commands.
The functions found here are:
- Set absolute position can be used to move to a specified track and
a specified position on that track. For example if there is
some interesting sound at a specific position on a certain track
this can be used to find it again.
- Skip lets You cue inside the current track.
- CD Database Editor brings up the database editor described below.
- Add to queue. Add the current CD to the retrieval queue.
- Get queued items. Retrieves CD information from the CDDB database
for the discs that are queued for retrieval.
- Remove queued items. Empty the retrieval queue.
- CD Info/Program
-----------------
The CD Info/Program dialog plays a central role in Notify CD Player
since it's the place where You enter information about the CD
playing, like Artist, tracks etc. This is also where You set up
a playlist where You can program tracks in a certain order or play
the same track many times etc.
- Playlist tab: This is where You enter the name of the CD and it's
tracks. This is also the place where You program the CD
- More CD info tab: This tab handles additional information about
the CD.
- More track info tab: This tab handles additional information about
the track.
Internet DB menu:
- Get from Internet. This option queries the remote server for info
about the current CD.
- Send to Internet. This option send this CD information to the
central CDDB repository by e-mail.
- Add to queue. Adds the current CD to the retrieval queue.
NOTE: The mail is sent using MIME and the text is encoded using
Quoted-Printable. If your mailserver has a problem with this you
can disable it by setting No_MIME in the [CDDB] section of
CDPLAYER.INI to 1.
- Options
---------
The options dialog is where You configure all the different functions
found in the player. It consist of a number of tabs described below.
General tab
===========
This is where You configure the general (whoha!) options!
Misc options
------------
- Stop CD on exit. Causes Notify CD Player to stop playing
before exiting.
- Stop CD on start. Causes Notify CD Player to stop playing
when starting.
- Exit on CD remove. Cause Notify CD Player to exit when the
CD is removed. This can be pretty nice when used together
with Windows autoplay since the Autoplay function will start
Notify CD Player again when a CD is inserted.
- Prev always prev track. By default Notify CD Player restarts
the current track if prev is choosen and more than five
seconds have been played of the track instead of selecting
the prev track. This option causes the player to always
choose the prev track and never restart the track when
prev is choosen.
- Remember status. Causes the player to remember certain
status flags such as repeat and random between runs.
- No insert notification. Can be used on older CD devices
or drivers that doesn't send notification messages when a
CD is inserted/removed. This option is also needed if You
have disabled the insert notification in Windows 95.
- Tracks menu as column. Causes the tracks menu to dissapear
and appear as a second column in the context menu.
Check it out! It's pretty neat!
- No bitmap in menu. Turns of the bitmap shown in the context
menu.
- No menu break. By default Notify CD Player breaks up the
tracks menu into submenus when a CD with more than 25
tracks is used. This option prevents this.
- Artist/Title in menu. Show artist and title at the top in the
popup menu.
- Automatically check for new version. Makes Notify automatically
check for a new version every time Notify is started and every
time a new disc is entered. This is done in the background and
doesn't influence the regular operation.
Register Notify CD Player as default player
-------------------------------------------
This button registers Notify as the default CD Player on the
system.
Default CD Device
-----------------
Specifies which CD device to use by default when starting up and no
other device is specified on the command line. Only used by users
with multiple CD devices.
Poll status every
-----------------
Is used when no CD is in the drive or when the full status check
option is used. A value of 1 is ok.
External program to run when a new disc is inserted
---------------------------------------------------
Enter the path to an program You want to run when a new CD is
inserted. Artist and CD title will be sent as argument 1 and 2
to the program. The MCI and CDDB ids are sent as argument 3
and 4.
This can be used to update the .plan file to
include the name of the CD You are currently listening to or
whatever.
Controls tab
============
This is where You configure the controls for different CD
playing functions.
The left column indicates the number of clicks or click-drag
operations available.
The middle column is an optional hotkey to use the the specified
action.
The right column is where You select the function you want to
be controlled.
Tooltip/Caption tab
===================
Caption
-------
- Show info on active caption. This option displays the same
information as the tooltip in the caption (title bar) of the
active window.
- Font. By selecting this option You can choose the font to use
when displaying info in the caption.
This is where You configure what is to be shown in the tooltip
and the active caption.
Tooltip and Caption buttons
===========================
Press one of them to select information regarding that type
Format
------
This is where you enter the string to be parsed and displayed.
Format specifiers are translated to the actual CD information
run-time. For example: "%0 - %1" will show
"New Artist - New Title" if no information is available.
Example
-------
Shows how the format string will look like on the tooltip/caption
using the current CD information.
Format specifiers
-----------------
The available information that can be used in the format string.
%% gives a single %.
Database tab
============
This is where You configure different database options Notify
can use.
What type of local database to use
----------------------------------
- CDPLAYER.INI database. This will use the regular CDPLAYER.INI
as local database. Note that INI files are limited to 64K
under Windows 95.
- CDDB local database. This will enable the use of the CDDB
local database format. This format will create a number of
directories in the path specified in the CDDB Local tab and
store CD entries in one of the two formats available. Use
this if Your database exceeds the Windows 95 limit on the
INI file.
What to automatically query when a new CD is inserted
-----------------------------------------------------
- Local database. This will query the local database for CD
information each time a CD is inserted.
- Remote CDDB database server. This will query the remote
CDDB server configured in the CDDB Remote tab if the CD
was not found in the local database.
Queue options
-------------
- Add CD to queue if information could not be retrieved.
This will add the CD to the retrieval queue if the
information could not be retrieved at the moment.
I.e. if the server reports some error. If the query
goes through, but no disc information is available, the
CD will *NOT* be queued.
- Automatically get queued CD info when retrieving other CDs
This option will make Notify to try to get the queued items
after an automatic remote query has succeeded.
What to store in local database
-------------------------------
- Store changes in local database. This will store
modifications to the CD entry in the local database.
- Store remote query result. This will directly store a
found CD entry in the local database after querying the
remote CDDB server.
CDDB Local
==========
This is where You configure the local CDDB database (if used)
The path where the local CDDB database will be stored
-----------------------------------------------------
This is the path where the CDDB database will be stored. The
player will create directories in this path as they are needed
and store files in the format specified below.
Type of local CDDB database
---------------------------
This specifies the type of local CDDB database to use. The
Unix format is faster but wastes much space on FAT partitions.
The Windows format is not as fast but wastes less space since
it will store multiple CD entries in each file.
CDDB Remote
===========
This is where You configure the remote CDDB server used by
the remote query function.
Protocol
--------
- HTTP. Uses standard port 80 HTTP protocol to query for CD
information.
- CDDB. Uses the CDDB server protocol on port 888 to query for
CD information. May not work on many firewalls.
- Port is only used by the CDDB protocol and should, for the
moment, always be set to 888.
Server
------
This specifies the fully qualified hostname of the server to
query for CD information.
Query this server for site list
-------------------------------
Query the selected/configured server for a list of servers
For an updated list of servers, check out
http://www.cddb.com/sites.html
HTTP Path
---------
This is the path to the CGI script that runs the remote query.
Should almost always be /~cddb/cddb.cgi. This is only used
for HTTP queries.
Proxy
-----
This is where You configure Your proxy server if needed.
There is no SOCKS support.
- Use proxy. Check this button to enable the use of a proxy
server.
- Proxy server. Enter the fully qualified hostname of the
proxy server.
- Proxy port. The port that the proxy server listens to
HTTP requests on.
- Use Proxy Authentication. Check this button to enable support
for proxy servers that require authentication.
- User. Fill in your proxy user name here.
- Ask for password. Check this if you don't like the fact about
storing your password in the CDPLAYER.INI file described below.
- Password. Fill in your proxy password here.
Be aware that the password "encryption" used to store the
password in the INI file isn't exactly rocket science so
you store it there on your own risk!
Besides the source code used to store the password is free
and the mangling of it is reversable so anyone with access
to your CDPLAYER.INI and the source code could easily
steal it!
NOTE: Proxy authentication uses the
"Proxy-Authorization: Basic <user>:<password>" standard where
<user> and <password> are sent base64 encoded. If your proxy
doesn't use this standard, proxy authentication will not work.
Timeout for remote operations
-----------------------------
This specifies the general timeout (in seconds) for all
the remote operations.
e-mail tab
==========
This is where You configure e-mail information used by the
submit feature.
E-mail address
--------------
Your e-mail address.
SMTP server
-----------
The fully qualified hostname of Your mail (SMTP) server.
Note: If Your server doesn't like the MIME headers that Notify
will send You can disable them by adding a No_MIME=1 to the
[CDDB] section in CDPLAYER.INI
Categories tab
==============
Choose this to alter the default set of categories.
- CD Database Editor
--------------------
The CD Database Editor is used to alter CD information or to export or
import CD information.
Note that the DB Editor might be slow on LARGE local CDDB databases.
Changes are not saved until you exit the editor and choose to save
changes.
Menu layout:
File
====
Export
------
Lets you export the database to the internal Notify format or
to a List Character Separated File (CSV) suitable for importing
into applications like Excel and Access.
Import
------
Lets you import an exported database in the Notify format.
Report
------
Produces a text file report of your database.
Statistics
----------
Shows some basic statistics on your database.
Close
-----
Exit the DB Editor
Search
======
This menu lets you search different parts of the database
Disc
====
This menu is only available when a disc is selected in the tree
Send to Internet
----------------
Submit this entry to the CDDB repository.
Set category
------------
Change the category of this disc.
Make alias
----------
Make the current (in the CD-ROM drive) disc an alias
of the selected entry. This only works with INI file
storage.
Delete
------
Delete the disc from the database
Edit in CD Info dialog
----------------------
Let's you edit playlist and extended information in the CD Info
dialog.
--- 5. Command-line options ------------------------------------------------
Notify CD Player supports a number of command-line options which
can be used when starting up. If the program is invoked as a second
instance it will send the commands to the already active instance.
Using the command-line options makes it possible to make keyboard
shortcuts that pause or selects the next track etc.
-PLAY [track path]
Starts playing the disc from the start or from the track number
specified by track path. Track path must include a drive specifier.
If the disc is paused it will continue.
Example: "NTFY_CD -PLAY Z:\TRACK03.CDA" will play track 3 on drive Z
-PAUSE
Toggles pause mode. If the disc is playing it will be paused,
otherwise it will continue to play. If this is the first instance
it will start the player in pause mode.
-STOP
Stops the playing
-NEXT
Selects the next track in the playlist or restarts from the first
track if the last one is playing.
-PREV
Selects the previous track in the playlist or restarts from the
last track if the first one is playing.
-RANDOM
Toggles random mode
-REPEAT
Toggles repeat mode
-OPEN
Open the CD-ROM drive
-CLOSE
Close the CD-ROM drive
-EXITIFNODISC
Exit the first instance upon startup if no disc is in the CD-ROM drive
Some of them can be used together, You could probably figure out which
ones. Some of them work a little different when controlling an already
running instance than they do when controlling the startup of the first
instance.
--- 6. Feedback, suggestions, bug-reports ----------------------------------
All feedback, suggestions and bug-reports to [email protected].
Please check the FAQ page at http://www.artech.se/~mlt/software/faq.html
before sending a question! Your question might already have an answer!
If you are submitting a bug-report, please check
http://sourceforge.net/tracker/?group_id=107012&atid=646371 and
http://www.artech.se/~mlt/software/bugs.html before you send it to make
sure you submit a new bug.
To submit a bug-report, after checking the BUG list, please use
NOTIFY-BUG in the subject line and include a logfile of a failing
session.
To enable the logfile add LOGFILE=1 in the [NTFY_CD] section
of CDPLAYER.INI as shown below:
[NTFY_CD]
LOGFILE=1
The resulting logfile is written to %Installation Path%\NTFY_CD.LOG
Also don't forget to include the version You are using. This is found in
the about box.
--- 7. Credits -------------------------------------------------------------
I would like to thank everyone that have supplied me with valuble
feedback and suggestions for new features as well as the beta testers
which at times have gotten their hands on more or less useless version
of this program. Thanks for Your patience! :-)
For more credits, press the credits button in the About box
Notify CD Player is written in plain C with plain Win32 and MCI API calls
using Microsoft Visual C++.
Well, thats about it, happy playing!