ClashFinder

Tools to export raw data from festival applications and transform into Clashfinder schedules

Supported Festival Platforms

• Appmiral
• Shambhala Festival

Setup

Required tools for use:

• curl
• jq
• uv
• python 3+

Extract the application session key using a MITM proxy tool like Charles Proxy or mitmproxy.

Within the desired festival application directory, add the extracted SESSION_KEY to a .env file (e.g. festivals/shambhalafestival/.env). The format should be:

SESSION_KEY=VALUE_HERE

Usage

• Setup the python virtualenv using uv

uv venv
source .venv/bin/activate

• Extract all scheduling data by running an extract script

pushd festivals/shambhalafestival
./2025.sh
popd

• Render the scheduling data as Clashfinder markup and paste the output from the transform script into the Clashfinder data field:

./bin/appmiral_transform.py --tz "US/Pacific" --artists festivals/shambhalafestival/2025/shambhalafestival.artists.json --stages festivals/shambhalafestival/2025/shambhalafestival.stages.json

Clashfinder Data Format

Each performance is composed of an act object with start, end, stage, and act keys.

timezone = US/Pacific

act = {"start": "2024-07-24 07:30", "end": "2024-07-24 09:00", "stage": "Pagoda", "act": "Justin Martin", "blurb": "Some text about this artist.", "url": "https://example.com/artist"}

The schedule dictates the festival's local time zone. While performing a data transform, set the --tz flag to match this timezone to ensure accurate schedules are produced. TZ values are defined by the TZ database.