Examiner2

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:

where options are:
 -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

the default options activated for each groups are: -s, -tfa, -l,

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