SC2Ranks Custom Division Profiler

Last Update
Kevin Gardthausen
VB.Net 4.0
Visual Studio 2012

Windows Desktop application for generating a statistical (HTML) snapshot of a custom division of SC2Ranks. Also works under Linux using Mono (v3.3.0).


What is SC2Ranks?

SC2Ranks is a StarCraft II statistics aggregation site for all realms.


[wpfilebase tag=file id=1 /]

Command Line Switches

  • /config=FILEPATH
    • The path to the config file. Other command line flags override the config.
  • /customdivisionid=51e882c969d5386f5900cac4 OR /cid=51e882c969d5386f5900cac4
    • Set the custom division. Default: 51e882c969d5386f5900cac4 (HwC Clan Division)
  • /commandline OR /cl
    • Starts the app in command line mode.
  • /refresh OR /r
    • Refreshes the players in the custom division.
  • /autodownload OR /ad
    • Automatically start the download the when the program starts.
  • /autoclose OR /ac
    • Automatically close the program after a download has automatically started (/autodownload).
  • /disableautosave OR /das
    • When specified does not automatically save the data to file.
  • /filename=FILENAME
    • Specify output file name. Default: StarCraft 2 Rankings.htm
  • /savepath=DIRECTORYPATH
    • Specify save path. Default: Program working directory
  • /template
    • Specify a template for writing data. Values:
      • $achievement$
        • Achievement Points Ranking Table
      • $1v1$
        • 1v1 Ranking Table
      • $2v2$
        • 2v2 Ranking Table
      • $3v3$
        • 3v3 Ranking Table
      • $4v4$
        • 4v4 Ranking Table
      • $timestamp$
        • Timestamp when the file was generated (Format: yyyy-MM-dd HH:mm:ss.fff)
      • $version$
        • Version used (Format: vMajor.Minor.Build [SVN Revision Revision])
      • $generatedby$
        • User who generated the file (Format: Computer\Username)
      • $generatedin$
        • The time in seconds it took to retrieve all data and generate the file
      • $customdescription$
        • As specified in custom description.
  • /verbose OR /v
    • Provides more details in error messages.
  • /retrycount=3
    • The number of retries per data request to before giving up. Default: 3 (Valid Range: 0-5)
  • /retrywaittime=15
    • The number of seconds to wait between retries. Default: 15 (Valid Range: 0 -180)
  • /reset
    • Sets all saved setting back to application default.


Requires the Microsoft .Net Framework 4.0:


Installing Mono on Ubuntu 12.04 LTS/13.04

Mono 3.3.0 or higher is required to run the NuGardt Custom Division Profiler. You can install the deb packages from Meebey or compile Mono 3.3.0 yourself (not shown here).

Add “deb /” (without quotation marks) to the file “/etc/apt/sources.list” and run the commands below (Source:

Setting up a cronjob

Included in the setup is a shell script called ‘’. Find these in the “\Tools\Linux” folder. These scripts must be amended to reflect you path on Linux.

Open the crontab editor via the command line

Add the following line to start job every day at 02:00:

Open source

Download the source at

Developed with Microsoft Visual Studio 2010 in .NET Framework 4.0.



    • V2.0.0.1  (2013-08-09)
      • Fixed retry count of 0.
      • Entering an incorrect API key no longer results in retries.
    • V2.0.0.0  (2013-08-08)
      • Open Source release.
      • Removed custom division refresh.
      • Faster server query through new API (less calls) provided by SC2Ranks.


NuGardt SC2Ranks Custom Division Profiler
Copyright (C) 2011-2013 NuGardt Software

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program.  If not, see <>.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.