Manual

Find artists nearby who wish to collaborate.

Start a new instant session, or just look for a running session nearby.

Use

Allow location detection or set a starting location by clicking on the map.
Within the blue markers popup, whether choose to just search, or to create an instant session.

To see details of any session, move your pointing device to the marker or click on it for even more details.

Any session will be visible on the map for not longer than one hour. Start a new one if you are still in progress, so others know it is still time left to join. ;-)

The screen will refresh every 5 minutes. Hit the refresh button of your browser to update in between this interval.

You can share a sessions - Link and its location on the map from within a map markers popup.

Sessionfinder Readme

I created this small web app to be used in the coming summer, to find other musicians for spontaneous sessions and to learn about azure web apps.

Self hosting

Actually the app is prepared to run as Azure Web App (Python)

clone this git repo, install dependencies, configure and run.

Configure

Configuration must be set in localconf.json in project root:

{
  "web_contact_info": "",                 -> App Setup
  "web_legal_info": "",                   -> App Setup
  "de_map_url": "",
  "de_map_attribution": "",
  "en_map_url": "",
  "en_map_attribution": "",
  "nominatim_url": "",
  "db_account_name": "",                  -> Azure Tables
  "db_account_key": "",                   -> Azure Tables
  "ad_consumer_key": "",
  "ad_consumer_secret": "",
  "ad_tenant_name": "",
  "schedules_secret": "",
  "temp_map_url": "",
  "temp_map_attribution": " ",
  "wind_map_url": "",
  "wind_map_attribution": " ",
  "rain_map_url": "",
  "rain_map_attribution": " ",
  "session_secretkey": " ",               -> App Setup
  "az_maps_clientid": "",                 -> Azure Maps
  "az_maps_key": ""                       -> Azure Maps
}

or may be set via environment variables.

Deploy

by Azure pipeline. Create a Python Webapp, Azure devops Project, and edit/run the azure-pipelines.yml, after set up.

Dependencies

Python

Python 3.7 / Python 3.9 with

azure
geopy
flask
Markdown
flask_oauthlib
oauthlib
requests-oauthlib
python-dotenv
Flask-Session
werkzeug
pyOpenSSL
setuptools
requests
flask-login

Javascript

Download

Leaflet 1.7.1 https://leafletjs.com/download.html
Font Awesome 4.7 https://github.com/FortAwesome/Font-Awesome/tree/fa-4
Latest https://github.com/nickpeihl/leaflet-sidebar-v2
Latest https://github.com/lvoogdt/Leaflet.awesome-markers
Latest https://spin.js.org/

and extract into

static/leaflet
static/fontawesome
static/sidebar
static/markers
spin

Data

The app itself stores:

The Users browser will store a functional cookie with a unique session id like

"Session":"d894ba8d-8923-4d46-9d10-155020fb6fa6"

The storage backend will store a session like:

unique instant session or scheduled session id,
its position and type
the time of the request

{ 'uuid': session['uuid'], 'timestamp': str(int(time.time())), 'schedule_when': 'Now', 'managed_by': '', 'lat': mysession['latitude'], 'lon': mysession['longitude'], 'type': mysession['type'] }

This data is stored for one hour.

Caching of Web Requests

Certain internal API requests are cached for a configurable amount of time .

Storage backends, Service Providers, 3rd parties

The App uses

Azure Tables
Azure Maps
Azure Maps

and these collect Metrics and Logs about a visitor.

Service Contact: services(at)kreaterra.net

Legal: https://services.kreaterra.net/

Instant sessions are kept alive for one hour. Start a new one to let others know its still running.

Session Finder