Examiner2 is the main program that come with the TSID2 user package.
The porpoise of this program is to scan all the stored TSID2 information
and produces useful statistics.
It is a console program, so use:
-h display this screen
---
-u show unsorted list
-s show sorted list
-x do not use the index (less accurate engine)
---
-t show single tune list (unsorted and/or sorted)
-f show songs (files) list (unsorted and/or sorted)
-a show author list (unsorted and/or sorted)
---
-l show order list as listen time
-n show order list as number of listen
-p show order list as pondered
---
-g generate playlist files
To understand the meaning of these options you must understand witch
information are stored by a player that use TSID2 library.
When you listen a tune, TSID2
library stored the number of seconds you listen this tune and the number
of time you listen it. The information are stored in .ini files and
are located into the directory .tsid2.
So if we scan these files, we are able to identify how much time or
often you listen to an sid author or a sid tune.
Examiner is so able to produce list of sorted/unsorted elements as: single tunes, single files and single author. If you choose sort, you can select if order by listen time, number of listen, and as soon as implemented with pondered score.
Here an examples of result of sorted list:
******** LISTEN TIME SORTED LIST OF SINGLE TUNES ***********
1 9038 13
/Galway_Martin Yie_Ar_Kung_Fu_II.sid #1
2 6500 6
/Beben_Wally Dark_Side.sid #1
3 6386 8
/DEMOS Hard_Stuff_II.sid #2
4 5803 7
/VARIOUS/G-L/Gerpsnot Syncer.sid #1
5 5719 21
/BOGG Equinoxe.sid #1
6 5623 8
/VARIOUS/G-L/Jergan_Oeyvind Ragnvald.sid #1
7 5431 6
/Hubbard_Rob Monty_on_the_Run.sid #3
8 5417 16
/Gray_Matt Tusker.sid #1
9 5242 4
/Gray_Matt Vendetta.sid #1
10 5210 6
/VARIOUS/S-Z/Sad L_Amour_Toujours.sid #1
...
******** LISTEN TIME SORTED LIST OF SONGS (FILES) **********
1 17124 55
/Gray_Matt Last_Ninja_2.sid
2 10810 34
/Gray_Matt Tusker.sid
3 9038 13
/Galway_Martin Yie_Ar_Kung_Fu_II.sid #1
4 7999 21
/Daglish_Ben Last_Ninja.sid
5 6739 10
/DEMOS Hard_Stuff_II.sid
6 6500 6
/Beben_Wally Dark_Side.sid #1
7 5808 8
/Hubbard_Rob Monty_on_the_Run.sid
8 5803 7
/VARIOUS/G-L/Gerpsnot Syncer.sid #1
9 5719 21
/BOGG Equinoxe.sid #1
10 5689 16
/Ouwehand_Reyn Last_Ninja_Remix.sid
...
******** LISTEN TIME SORTED LIST OF AUTHORS ****************
1 51488 142
/Gray_Matt
2 38919 113
/DEMOS
3 29260 79
/Galway_Martin
4 28004 120
/DEMOS/UNKNOWN
5 23945 85
/Hubbard_Rob
6 22546 91
/Bjerregaard_Johannes
7 15783 97
/GAMES/M-R
8 15048 28
/VARIOUS/G-L/Gerpsnot
9 13473 28
/SoedeSoft
10 13411 36
/Blidon_Jens
...
*** STATISTICS ***
LISTEN SECONDS: 811999
NUMBER of LISTEN: 2962
As you see, the first number is the position of on element in the
list, the seconds is the number of seconds you listen, then the number
of listen, after the author (as HVSC directory).
After that can be the tune file name (ended with sid) and
the subsong tune.
Even if these list can showing how is your best composer/sid, if
you want to listen again to the tunes, a playlist files will be better.
So the -g option creates some playlist files (with the standard
names: ulost.spl, tslost.spl, nlslost.spl, pslost.spl, ulos.spl, ltslos.spl,
nlslos.spl, pslos.spl that depends by the other options you choose).
The x option is to exclude the use of an special index. In this case the path/name of files are
the one stored inside the ini file. But if you want ot have an index like the one of TSID and HVSC,
you must use the file index.ini
Actually, you have to manually build it with makeindex.pl script as examiner2 is still in testing