README.md

SteamPlog

SteamPlog logs and plots your in-game time for your steam games.

Note: SteamPlog is not endorsed, sponsored, affiliated with or otherwise authorized by Valve Corporation.

Getting Started

Requirements

• Steam API Key (Powered by Steam)
• Python 2.7.6+ (lower versions untested)
• Either sqlite3 or python-mysqldb
• python-matplotlib

First time setup

$ ./steamplog.py create-config      # afterwards edit your config.json
$ ./steamplog.py update-appnames    # run when steam releases new games

You should add your API key and Steam ID to config.json. After that you may run the following commands:

$ ./steamplog.py log                # run it once a day
$ ./steamplog.py plot               # run whenever you want
$ ./steamplog.py plot -lc -o 2015-Q3 2015-07-01 2015-09-30

Run with option -h to see all available options.

$ ./steamplog.py -h
steamplog - log and plot your steam gaming time

usage:
  steamplog.py log
  steamplog.py plot [bar | point | line] [-a | [<DATE_FROM>] [<DATE_TO>]]
                    [-lc] [-o FILE | -i] [-v]
  steamplog.py update-appnames
  steamplog.py create-config
  steamplog.py stats [--full]

plot options:
  -a, --all         plot every available playtime
  [<DATE_FROM>]     include every playtime from this date (format: YYYY-MM-DD)
                    [default: last 14 days]
  [<DATE_TO>]       include every playtime from this date (format: YYYY-MM-DD)
                    [default: today]
  -c, --color       top 10 games have different colors
  -l, --legend      include a legend
  -o FILENAME, --output FILENAME
                    FILENAME of the output image without extension
  -i, --individual  plot each game in a new image

stats options:
  --full            print every game

other:
  -v, --verbose  be verbose
  -h, --help     show this help

Automating

On Linux

Edit your crontab

On Windows

Use the task sheduler