Config
======

The configfile is using the .ini-format.
Currently all settings are read from the ``[General]``-section.

+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Key                 | Description                                                                                                                                                                     |
+=====================+=================================================================================================================================================================================+
| log                 | Path to TS3Server-logfile(s) (supports `globbing <https://docs.python.org/3/library/glob.html>`__)                                                                              |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| output              | Path to the location, where the generator will put the generated .html-file                                                                                                     |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| idmap               | Path to `IdentMap <https://teamspeakstats.readthedocs.io/en/latest/identmap.html>`__                                                                                            |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| debug               | debug mode                                                                                                                                                                      |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| onlinedc            | Add timedelta from last-connect until now to onlinetime for connected clients                                                                                                   |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| template            | Path to a custom template file (relative from ``tsstats/`` or absolute)                                                                                                         |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| datetimeformat      | Format of date/time-values used for render-timestamp and last online (using `datetime.strftime <https://docs.python.org/3/library/datetime.html#strftime-strptime-behavior>`__) |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| onlinetimethreshold | Clients with an onlinetime below that threshold (in seconds) are hidden in the onlinetime-section                                                                               |
+---------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

Example
-------

``config.ini``

.. code-block:: ini

    [General]
    log = /usr/local/bin/teamspeak-server/logs/ts3server*_1.log
    output = /var/www/html/stats.html

.. code-block:: console

  $ tsstats -c config.ini