Artistboard

Artistboard is a self hostable web app designed to help bookers manage their artist bookings for multiple events, categorized in shows and seasons.

It helps keeping track of all the required steps of a booking and includes mailing features on different data levels to e.g. sent out info mails to all artists in the roster or remind artists about missing infos.

Made with Django.

Installation

Using a container engine (e.g. Podman, Docker)

Refer to the configuration section on what environment variables to set. Additionally, set DJANGO_SUPERUSER_USERNAME, DJANGO_SUPERUSER_PASSWORD and DJANGO_SUPERUSER_EMAIL to create the superuser and start artistboard like this:

podman run -e SECRET_KEY=veryverysecretstuff -e DJANGO_SUPERUSER_USERNAME=admin -e DJANGO_SUPERUSER_PASSWORD=secretpassword -e DJANGO_SUPERUSER_EMAIL=admin@company.com -p 8000:8000 ghcr.io/wabuehamm/artistboard:latest

Check out http://localhost:8000.

Using native python

Artistboard requires a working Python 3, It is recommended to use the virtual environment features of python to properly install it. If you download a version of artistboard, install it like this:

cd <artistboard-path>
python -m venv .venv
. ./.venv/bin/activate
pip install -r requirements.txt

Set the required configuration environment variables and then initialize the database:

python manage.py migrate

Create a superuser to access artistboard:

python manage.py createsuperuser

Finally, start Artistboard using Django's runserver:

python manage.py runserver

For production-grade systems, refer to the deployment chapter in Django's documentation.

Configuration

Artistboard is configured using this environment variables:

• DATABASE_URL: Database configuration for Django. See the dj-database-url documentation for details
• SECRET_KEY: The Django secret key
• APPLICATION_HOST: Host the application runs on (e.g. skills.company.com). Required if DEBUG is not set to true.
• DEBUG: Whether to run the application in Django debug mode [False]
• EMAIL_HOST: SMTP host to send mails
• EMAIL_PORT: SMTP port [25]
• EMAIL_HOST_USER: User to send mails
• EMAIL_HOST_PASSWORD: Password of the smtp user
• EMAIL_USE_TLS: Use TLS [false]

If you use the container solution, these variables are used to automatically create the superuser:

• DJANGO_SUPERUSER_USERNAME: Username of superuser
• DJANGO_SUPERUSER_PASSWORD: Password of superuser
• DJANGO_SUPERUSER_EMAIL: Email address of superuser

Usage

See the user documentation for details on how to use artistboard.

Development

artistboard is written in Python and made using Django with the help of iommi and other tools.

We're happy to get bug reports or feature requests on our Github repository or to receive pull requests for fixes or new features.

Data design

erDiagram
	direction TB
	Artist {
		string name  "Name of the artist"  
		boolean locked  "Is the artist locked?"  
		string contact_name  "Name of the contact"  
		text contact_address  "Address of the contact"  
		string contact_phone  "Phone of the contact"  
		string contact_email  "Email of the contact"  
		string style  "Artist style"  
		int number_artists  "Number of artists"  
		text comments  "Comments"  
		text info  "Current artist info"  
		file image  "Current artist image"  
	}

	EventArtist {
		int event_id  "Event ref"  
		int artist_id  "Artist ref"  
	}

	Event {
		int show_id FK "Show ref"  
		datetime start_timestamp  "Date and time when the show starts"  
		int booked_artist_id FK "The booked artist for the event"  
		text agreement  "Additional agreement for the artist at the event"  
		boolean todo_gema  "Planned the GEMA for the event"  
		boolean todo_got_setlist  "Got setlist from the artist"  
		boolean todo_got_invoice  "Got invoice from the artist"  
		boolean todo_gema_setlist  "Sent the setlist to the GEMA"  
		int required_free_tickets  "Required free tickets for the event"  
		int required_paid_tickets  "Required paid tickets for the event"  
	}

	Show {
		int season_id FK "Season ref"  
		string name  "Name of the show"  
	}

	Season {
		int year  "Year of the season"  
		boolean todo_sent_cfa  "Sent out the call for applications"  
	}

	Link {
		int artist_id FK "Artist ref"  
		string type  "Link type"  
		string url  "Link URL"  
	}

	MailTemplate {
		string name  "Name of template"  
		string type  "Type of template (single_season, all_artists, single_artist)"  
		string subject  "Templated subject field"  
		string to  "Templated recipient field"  
		string cc  "Templated cc field"  
		string bcc  "Templated bcc field"  
		text body_text  "Templated body field"  
		text body_html  "Templated html field"  
		boolean use_markdown  "Use the markdown-remdered version of body_text as body_html"  
	}

	Todo {
		string todo  "Name for the todo"  
		text description  "Verbose description of the todo"  
		string available_for  "For which objects is the todo available. Currently: season, event"  
	}

	SeasonTodo {
		ref season  "Season reference"  
		ref todo  "Todo reference"  
		boolean done  "Whether the todo has been done"  
	}

	EventTodo {
		ref event  "Event reference"  
		ref todo  "Todo reference"  
		boolean done  "Whether the todo has been done"  
	}

	Season||--|{Show:"is contained in"
	Show}|--|{Event:"has many"
	Artist||--o{Link:"has"
	Artist||--o|Event:"booked"
	Event||--o{EventArtist:"available"
	Artist||--||EventArtist:"  "
	Season||--|{SeasonTodo:"belongs to"
	SeasonTodo||--|{Todo:"references"
	Event||--|{EventTodo:"belongs to"
	EventTodo||--|{Todo:"references"

Loading