# External tools and scripts for Kanka

## External tools

* [Kanka Archive Explorer](https://bitbucket.org/jdgarrison/karex/src/main/) (KAREX) by Jonathan Garrison: A Python3 script that scans a campaign export Zip file to produce a human-readable HTML file.
* [Kanka Attribute Templates Designer](https://bitbucket.org/MaxJohnson/kanka-attribute-templates/src/main/) by MaxJohnson: *A rough and messy local workspace to approximate Kanka's layout and css capabilities for attribute template development.* Uses JavaScript to replace some of the Blade logic with placeholder text to assist in developing and testing your template’s layout locally.
* ~~Kanka.js~~ by NachtTheFerret: A JavaScript library for the API.
* ~~Kanka Ruler Calculation~~ by BrandonEchols & The Quacken: Figure out what value to input for the map measurement setting based on your image's dimensions and desired metric. The tool is no longer online, but maybe you will find the [original calculations](https://docs.google.com/spreadsheets/d/1Bt-BLbqaEJ6DZN5tTVA9B4E1OCIzqTOUQ0TrjoX0oH8/edit?gid=62519174#gid=62519174) helpful.
* [Kanka-Wordcount](https://github.com/Nekuskus/Kanka-Wordcount) by Kuskus: A Typescript utility that computes the word count of your campaigns, supporting various options and filters. Installed and run locally via NPM.
* [RealmPress](https://github.com/promiemotz/realmpress) by promiemotz: A Python script that can convert campaign exports (manually downloaded or through the API) into Markdown, HTML and PDF documents and optionally upload them to Google Drive.
* [Tag the Untagged](https://tag-the-untagged.netlify.app/) by Kelaos: An API-based utility that adds a specified tag to all of your untagged entries so you can track them down more easily.

### Discord Integrations

* [kanka-discord](https://github.com/Fallayn/kanka-discord) by Fallayn: A bridge that automatically posts Kanka changes to a Discord channel.
* [kanka-view](https://github.com/arconyx/Athena-Cogs) by Arconyx: A Red-DiscordBot cog that allows you to access your Kanka campaigns from Discord.

## User scripts

The links that follow will take you to various [Tampermonkey](https://www.tampermonkey.net) scripts designed specifically for Kanka. Those scripts are extensions that can be installed in your browser to give you additional features without affecting the actual website for other users.

### Scripts by Salvatos

Since I have accumulated dozens of scripts over the years, you can check them out [here](https://greasyfork.org/en/users/793935-salvatos?sort=total_installs), sorted by popularity. Personal favourites include the Editor Toolkit that enhances Summernote and the Automatic Table of Contents to quickly scroll to various sections of entries.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://salvatos.gitbook.io/kanka-cookbook/external-tools-and-scripts-for-kanka.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
