Skip to main content

crtools – Clash Royale Clan Dashboard generator

This is a tool for creating a dashboard for clan participation in ClashRoyale. See https://developer.clashroyale.com to sign up for a developer account and create an API key to use with this.

For an example dashboard created for the clan Agrassar (#JY8YVV), see: https://agrassar.com/

This tool is a static site generator – it generates static HTML, JavaScript, and CSS used to render the dashboard. If you wish to use this, you should set it up to run once per hour on your web server.

Installation

This requires Python 3 and pip on your machine. To install, use

pip3 install crtools

If you have an older version installed, to upgrade to the latest version, run:

pip3 install -U crtools

Syntax

Usage:

crtools [-h] [--locale LOCALE] [--config CONFIG-FILE] [--api_key KEY]
        [--clan TAG] [--out PATH] [--favicon PATH] [--clan_logo PATH]
        [--description PATH] [--canonical_url URL] [--debug]
        [--version]
optional arguments:
-h, --help

show this help message and exit

--locale LOCALE

Locale if language other than English is desired. Currently, only “fr” is valid.

--config FILE

configuration file for this app.

--api_key KEY

API key for developer.clashroyale.com

--clan CLAN

Clan ID from Clash Royale. If it starts with a ‘#’, clan ID must be quoted.

--out PATH

Output path for HTML.

--favicon PATH

Source path for favicon.ico. If provided, we will copy to the output directory.

--clan_logo PATH

Source path for clan logo PNG. Recommended at least 64x64 pizels. If provided, we will copy to the output directory.

--description PATH

Source path snippet of HTML to replace the clan description. Should not be a complete HTML document. Sample here: https://github.com/AaronTraas/crtools-agrassar-assets/blob/master/description.html If provided, we will copy to the output directory.

--canonical_url URL

Canonical URL for this site. Used for setting the rel=canonical link in the web site, as well as generating the robots.txt and sitemap.xml

--debug

Turns on debug mode

--version

List the version of crtools.

Optional config file

crtools looks for a config file in your home directory called .crtools

This is an INI file. As of current version, there’s only one possible parameter: api_key. The file should look like:

[API]
# API key provided for your account at https://developer.clashroyale.com
# Note that the key is limited to a specific list of public IP addresses
api_key=<YOUR-API-KEY>

# Your clan tag
clan_id=#JY8YVV

[Paths]
# your output path. Where you want the static website to live.
out=/var/www/html

# Path to the logo artwork for clan. Must be PNG. Recommended at
# least 64x64 pixels.
clan_logo=~/myclan/logo.png

# Path to the favicon file you want to use for this
favicon=~/myclan/favicon.ico

# Path to a file that contains arbitrary HTML for the site.
description_html=~/myclan/body.html

[www]
# Canonical URL for this site. Used for setting the rel=canonical
# link in the web site, as well as generating the robots.txt
# and sitemap.xml
canonical_url=https://yourclan.com/

For more details, see samples/crtools.ini

Other languages/locales

Crtools currently supports English and French. If you’d like to use French, add the following switch on the command line:

--locale=fr

If you wish for crtools to be available in another languages, reach out to me.

Suggested usage on a Linux web server

This tool is a static site generator – it generates static HTML, JavaScript, and CSS used to render the dashboard. If you wish to use this, you should set it up to run once per hour on your web server using cron or similar. Below is an example setup on Linux.

Assuming root is going to be running the script:

  1. Download and install this application

  2. Install nginx or apache

  3. Create /root/.crtools file as specified above, and add your API key

  4. Find your document root (e.g., /var/www/html)

  5. Create the following entry in your crontab:

0 * * * * crtools --out=[YOUR-DOC-ROOT] [YOUR-CLAN-TAG]

For example:

0 * * * * crtools --out=/var/www/html \#JY8YVV

Note the \\ character before the # – that’s important. A ‘#’ is a comment in most shells/scripting languages. You need to escape it to run it.

Contributors

All of the non-code contributors are listed in CONTRIBUTORS.rst

Image rights

All images included in this repository were created by the team, and are included in the GPL license. The SVGs were all created in Inkscape.

It was important to us to make sure the entirety of this application is open source, and not subject to takedown request. We will not ever extract assets from the game or from any other web properties.

Metadata

Release files for crtools 2.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crtools 2.1.8
File Size Uploaded Provenance Actions
crtools-2.1.8.tar.gz 52.8 kB Without provenance Details for crtools-2.1.8.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for crtools 2.1.8
File Interpreter ABI Platform Actions
crtools-2.1.8-py2.py3-none-any.whl Python 2, Python 3 none any Details for crtools-2.1.8-py2.py3-none-any.whl

Total release size: 133.1 kB

Release files / crtools-2.1.8.tar.gz

Download URL crtools-2.1.8.tar.gz
Size 52.8 kB
Tags Source
SHA-256 checksum
How to use checksums
4af194838acd54fb243d5e2c5347a9c16cc5fdc584b5465fa459c9f01a3ae24f
BLAKE2b-256 checksum
How to use checksums
bb119578cc6e922ae6d24cb4c19e0e797f0141c8d22208c2bfeb3b4bd5404292
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

Release files / crtools-2.1.8-py2.py3-none-any.whl

Download URL crtools-2.1.8-py2.py3-none-any.whl
Size 80.3 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
31abb995620e4b27ebc64a652bd9e12cb1a5a4e228bb6a29459a347bf445c881
BLAKE2b-256 checksum
How to use checksums
f0f1b7f7e599a91a0eda2c3c18bc9fcf29406e21e2d1da952b30dab53956ceba
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

Security for crtools 2.1.8

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.1.8 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page