Every time Giocoso plays music in Database Play Mode, it stores details of what it has played within the database itself. Over time, it becomes possible to query Giocoso's database to produce reports on what has been played, the size of the music collection, the number of unique composers it contains and so on. All the following parameters are used to assist in this database reporting process.
|--report=xxxx||An instruction to not play any music but, rather, to report on the current state of the PLAYS table within the Giocoso music database (whose name must be specified by the presence of a --dbname parameter). The parameter takes two possible values: either a full path and filename to which the report can be written as a pipe-delimited text file; or the word screen, which directs the report output into a scrollable listing within the terminal session.|
|--reportsort=n||Alters the sort-order of the --report output. By default, the report is listed in date/time order, with the oldest plays being listed first. By supplying different values for n with the --reportsort parameter, you can have the same data listed in composer (n=2), composition (n=3), genre (n=4) or duration (n=5).|
|--reportdays=n||Restricts the --report output to only include plays made within the past n days. Thus --reportdays=10 would display only the last 10 days of play history. |
Giocoso works in whole days: if you ask for a --reportdays=10 report at 6pm on the 30th June, the report will include plays from any time on the 20th June onwards.
The parameter value must be a positive integer. if you try supplying negative or non-integer values, then Giocoso will silently apply a value of 36,500. That is the number of days in a century and thus effectively means 'no date restrictions apply at all'.
|--recordinglist=xxxx||An instruction to not play any music but, rather, to report on the current state of the RECORDINGS table within the Giocoso music database (whose name must be specified by the presence of a --dbname parameter). The parameter takes two possible values: either a full path and filename to which the report can be written as a pipe-delimited text file; or the word screen, which directs the report output into a scrollable listing within the terminal session.|
|--composername=xxxx||Restricts the --recordinglist output to only include those recordings which have been attributed to the composer whose name (or part name) is supplied as the parameter value. Note that Giocoso assumes the ARTIST tag will contain the composer of a work and thus it is with this tag's data that the parameter value is compared for reporting purposes.|
Composer names can be in any case and are wild-carded. Thus 'bRi' will effectively match "Benjamin Britten" as well as "Frank Bridge". Composer names containing spaces or apostrophes should be enclosed within double quotation marks
|--stats||Triggers the production of a simple on-screen report of aggregate statistics about your music collection, its duration distribution, and how much of it Giocoso has played, over time. As with all reporting parameters, the --dbname parameter must be present, so Giocoso knows from which database we should collect statistics.|