Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 1.75 KB

README.md

File metadata and controls

58 lines (39 loc) · 1.75 KB
Raw

ClashFinder

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

Supported Festival Platforms

Setup

Required tools for use:

  • curl
  • jq
  • poetry
  • 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 Poetry
poetry install
poetry shell
  • Extract all scheduling data by running an extract script
pushd festivals/shambhalafestival
./2024.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/2024/shambhalafestival.artists.json --stages festivals/shambhalafestival/2024/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.