 KK  KK EEEEEE YY  YY  GGGG  EEEEEE NN   NN MM   MM UU  UU  SSSS    ii    CCCC 
 KK  KK EE     YY  YY GG  GG EE     NN   NN MMM MMM UU  UU SS  SS        CC  CC
 KK KK  EE     YY  YY GG     EE     NNN  NN MMMMMMM UU  UU SS     iiii   CC    
 KK KK  EE     YY  YY GG     EE     NNNN NN MM M MM UU  UU  SS      ii   CC    
 KKKK   EEEEE   YYYY  GG     EEEEE  NN NNNN MM M MM UU  UU   SS     ii   CC    
 KK KK  EE       YY   GG GGG EE     NN  NNN MM   MM UU  UU    SS    ii   CC    
 KK KK  EE       YY   GG  GG EE     NN   NN MM   MM UU  UU     SS   ii   CC    
 KK  KK EE       YY   GG  GG EE     NN   NN MM   MM UU  UU SS  SS   ii   CC  CC
 KK  KK EEEEEE   YY    GGGGG EEEEEE NN   NN MM   MM  UUUU   SSSS  iiiiii  CCCC 

\               ۱                 /
>>\\                        //<<
  >>{PRESENTS}<<
>>//                        \\<<
/               ۱                 \

                                    MODlist

     Author:   keygenmusic
     Contact:  keygenmusic@nm.ru
     Homepage: http://www.keygenmusic.net/

     ====:: Introduction ::===================================================
MODlist - is a program to create list of tracker modules, MIDI, and stream 
audio files(like MP3, etc) in chosen folder. List includes: filename, title, 
length, file size. List is formatted according to template, so list's file 
format can be any format, that can be edited as text(html, csv, etc).
MODlist is freeware program providing under terms of GNU General Public Licence

     ====:: Supported File Types ::===========================================
Tracker modules, MIDI, etc:
XM, MOD, S3M, IT, MO3, MTM, UMX, 669, MID, V2M, OXM, RMI, STC, ASC, STP, PSC 
FLS, FTC, PT1, PT2, PT3, SQT, GTR, FXM, PSM, VTX, PSG, YM, OUT, ZXAY, AY, AYM
Stream audio files:
MP3, MP2, MP1, OGG, WAV, AIFF, WMA, MPC, AAC, VQF, APE, FLAC, WVC, WV, TTA, 
OFR, M4A, AC3

     ====:: Usage ::==========================================================
In editbox "Folder" enter path or browse for a folder containing tracker
modules to list with "Browse..." button. Editbox "File header" contains text
that will be added at the beginning of list file. Editboxes "Row start",
"Between rows", "Row end" contains rows formatting text. The same is for
"Columns formatting" group of editboxes. Type letters corresponded to column 
in "Include columns" EditBox(see tip in program's window), order of this 
letters changes order of columns(Artist column is not supported for some file
types). "File footer" contains text that will be added at the end of list. 
"Include file types" editbox contains list of file extension to index. 
Extension must start with dot "." symbol and end with ";"(without quotes). 
Press one of three buttons below to quickly choose only trackers, stream, or 
all file types. "Include non-audio & too large files" will include files that 
are not really contain audio data and files that are larger then specified 
size. Set other options as you wish. "Convert title strings to HTML format" 
options is useful for html list format, it will change symbols that browser 
can't show into html format, so they'll be shown fine in browser. "Add HTML 
links to columns" option makes HTML links(<a href=) from text in specified 
columns (use letters like in "Include columns" editbox), links can begin with 
some prefix like website address. "Make list" button opens file save dialog for
 list file. You can use already made templates by pressing "Load template" 
button and choosing template file. You can save template by pressing "Save 
template" button. "Clear all" button clears all template text in editboxes.

To insert total size in footer type "%/TSIZE"(without quotes), to insert total 
playing time in footer type "%/TTIME"(without quotes). Note that date and time 
can be properly inserted only in footer of list! To insert current date/time 
in header or footer type:"%Dformat%/D" (without quotes), where "format" is 
date and time formatting string that can contain following pictures (case 
sensitive):

DATE PICTURES
d    Day of the month as digits without leading zeros for single digit days.
dd   Day of the month as digits with leading zeros for single digit days
ddd  Day of the week as a 3-letter abbreviation as specified by a
LOCALE_SABBREVDAYNAME value.
dddd Day of the week as specified by a LOCALE_SDAYNAME value.
M    Month as digits without leading zeros for single digit months.
MM   Month as digits with leading zeros for single digit months
MMM  Month as a three letter abbreviation as specified by a LOCALE_SABBREVMONTHNAME value.
MMMM Month as specified by a LOCALE_SMONTHNAME value.
y    Year represented only be the last digit.
yy   Year represented only be the last two digits.
yyyy Year represented by the full 4 digits.
gg   Period/era string as specified by the CAL_SERASTRING value. The gg
format picture in a date string is ignored if there is no associated era
string. In Enlish locales, usual values are BC or AD.
TIME PICTURES
h    Hours without leading zeros for single-digit hours (12-hour clock).
hh   Hours with leading zeros for single-digit hours (12-hour clock).
H    Hours without leading zeros for single-digit hours (24-hour clock).
HH   Hours with leading zeros for single-digit hours (24-hour clock).
m    Minutes without leading zeros for single-digit minutes.
mm   Minutes with leading zeros for single-digit minutes.
s    Seconds without leading zeros for single-digit seconds.
ss   Seconds with leading zeros for single-digit seconds.
t    One charactertime marker string (usually P or A, in English locales).
tt   Multicharactertime marker string (usually PM or AM, in English locales).

     ====:: Version history ::================================================

0.34 - 25.12.2007
----------------
+fixed bug with .wav files without RIFF tags

0.33 - 23.12.2007
----------------
+total size and playing time can now be inserted in list footer
+changed 'b' to 'B' for displaying bytes

0.32 - 13.09.2007
----------------
+support for WVC, WV, TTA, OFR, M4A, AC3 formats
+option to add HTML link to specified columns' text
+compiled with latest versions of KOL&MCK, GrushControls, Audio Tools Library, 
 expect minor bugfixes
+changed copyrights to copylefts :)

0.31 - 31.07.2006
----------------
+add space char in empty cell function
+non xp-skinned scrollbars

0.30 - 11.07.2006
----------------
+support for STC, ASC, STP, PSC FLS, FTC, PT1, PT2, PT3, SQT, GTR, FXM, PSM, 
 VTX, PSG, YM, OUT, ZXAY, AY, AYM formats (thanks to Sergey Bulba)
+support for WMA, MPC, AAC, VQF, APE, FLAC formats
+RIFF WAVE title support
+Better "About" and "Make List" dialog boxes

0.27 - 05.05.2006
----------------
+RMI midi support
+OXM module support
+ability to cancel list creation process
+fixed wrong midi time calculation for some files
*probably fixed strange crashes after pushing "Make list" and "Save" buttons

0.26 - 10.04.2006
----------------
+MIDI file support
+V2M file support (thanks to kb / farbrausch)
+save settings to *.ini

0.25 - 28.02.2006
-----------------
+changed file indexing engine, slower but less buggy(can index 1000's of files)
+MP3, MP2, MP1, OGG, WAV, AIFF support
+Artist column (MP3, MP2, MP1, OGG only)
+Choose needed file types
+Choose not to index files larger then specified size
+Smaller font to fit more things in main window (buy glasses if you can't see:)
+better "About" dialog :)

0.19 - 14.02.2006
-----------------
+choose columns and it's order
+insert current date/time (so, html.kgmusic.mod.mlt template was updated)
+drag'n'drop folder or template
+music by dualtrax
+"About" dialog
+bass.dll now external

0.17 - 08.02.2006
-----------------
+save/lod current template in current.mlt file, when exiting/launching program
+new interface

0.15 - 05.02.2006
-----------------
+uses Bass.dll by un4seen.com
+play time(only for XM, MOD, S3M, IT, MO3, MTM)
+include subfolders
+additional options
+new template by smartie
+GNU GPL (open-source:))

0.1 - 31.01.2006
----------------
!Initial version.

PS: If you know how to calculate play time of 669 and other not supported 
tracker modules, please tell me. I will be very thankful for this and will add 
you to thank list and Hall of fame on my homepage: keygenmusic.net.

     ====:: Thanks and greetings to ::========================================

	kb_ / farbrausch
	Sergey Bulba
        smartie
	un4seen.com

2007 denis111 (keygenmusic)