Skip to main content

Script for checking TekSavvy (and other ISP) Quotas

Project description

Interface for querying your ISP download quota.

“Have you had to much to download?”

Build Status Latest Version released on PyPi Latest Version released on Github License


Works with python 2.7, 3.4, 3.5

Pull your ISP Quota and act on it.

Supported ISPs:

To avoid using command line flags create a config file at:


Place the following variables within the config file:

API=<your API KEY from>
CAP=<your cap in GB>
WARN_RATIO=<ratio % to warn in 0.1 increments up to 1.0>


To install, run the following:

pip install tekuila

Or, if you wish to install the latest from source:

git clone
cd tekuila
python install

API Usage


Console Usage

Console command help:

tekuila -h
usage: tekuila [-h] [-c CONFIG] [--cap CAP] [--api API] [--warn WARN] [-v]
               [-s] [--version]

Check TekSavvy Cap

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        Alternative config file
  --cap CAP             Your cap in GB, causes nonzero return code if exceeded
  --api API             API Key
  --warn WARN           Warn ratio against data cap, causes nonzero return
                        code if exceeded, in range 0.1 to 1.0
  -v, --verbose         Show output, don't just use return code
  -s, --startca         Use StartCA instead of TekSavvy API
  --version             show program's version number and exit

Pull Requests and Issues

Pull requests very much welcome. Check that it complies with pep8, please make sure the documentation builds.

Please use elementary commits vs big commits and try and have your commit messages be detailed. See Tim Pope’s excellent Guide.



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tekuila-3.0.2.tar.gz (15.5 kB view hashes)

Uploaded source

Built Distribution

tekuila-3.0.2-py2-none-any.whl (16.3 kB view hashes)

Uploaded py2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page