TourManager

A tool to easily organize shows and events. Made for artists, musicians, bookers, and event managers.

Description:

TourManager is a tool to help artists, musicians, bookers, and event managers with the organization of shows and events. TourManager wants to be simple and powerful, and it has a lot of tools to help organize your shows efficiently. It has a map to show your venues, a travel costs calculator, notes, statistics, links to locate addresses and get directions, it can generate calendar files for your favorite calendar application, export the upcoming shows into html, and many more useful tools. It will definitely reduce the boring tasks, making the booking processes enjoyable, and even bring multi-user cooperation!

Main Features:

• Manage your shows
• Manage your venues and events
• Map
• Travel costs calculator
• Locate addresses and get directions on OSM or Gmaps (via Web Browser)
• Generate calendar files for calendar applications
• Notes
• Statistics
• Search shows and venues
• Filter shows and venues
• Monitor (according to search and filters)
• Specific show folders for your related documents
• Tags
• Backup
• Dedicated working folder (can be shared with cloud applications)
• and many many more...

Easy Installation (Binaries):

Linux: Grab the newest release linux zip file, extract it, cd into folder and run

./TourManager

Windows: Grab the newest release windows file, extract it and start

TourManager.exe

Installation (Python Source):

1. Clone the whole TourManager folder on your system

git clone https://github.com/sonejostudios/TourManager.git

2. Install dependencies:

pip install PySide6 pandas folium ics tabulate humanize pyqtdarktheme-fork

3. Start TourManager with:

./TourManager.sh

Get Started:

1. First, open config.ini and set it up as wanted:

• Add your homebase city and its geo-coordinates
• Your default artist name,
• Default currency
• Distance unit
• Default travel price

2. Start TourManager. You will see a example databases with 3 shows and venues/events. Read the comments to get more information.

3. Create a new venue:

• Click on Add New in the venue section on the bottom right (green section)
• Enter the venue's name, city and country. The venue is created
• Fill the venue fields as wanted: add the address, geo-coordinates, website, etc. and hit Save Venue
• If you want, press Locate to locate the address, Route to calculate the directions, Map (yellow section) to show the venues on the map

4. Create a new show:

• Select the new venue and press Add New in the show section on the bottom left (red section)
• Set a date and press ok. The show is created with the selected venue
• Fill the show fields as wanted: set the booking status, add contacts, create a specific show folder if needed, and hit Save Show
• To change the venue, just select a new one on the venue list and hit Save Show

5. Important:

• After filling in the fields (shows and venues), always hit Save Show or Save Venue, otherwise, your modifications will not be saved.

6. Play around:

• Search the show list and apply booking status filters
• Search the venue list and apply venue filters
• Explore the Monitor (according to searches and filters!): Notes, Paths, Statistics, Lists, Emails and Tags (blue section)
• Explore the Map (according to venue searches and venue filters!): Click on the venue's 'markers to show more information (yellow section)
• Press Route to get the distance to your homebase
• Open the Travel Costs Calculator and enter that distance to know the travel costs (yellow section)

Config.ini:

[defaults]
homebase_city = Homebase City (please setup config.ini)
homebase_geocoordinates = 0.0, 0.0
artists = My Artist
currency = EUR
distance_unit = km
travel_unit_price = 0.30

[paths]
working_directory = 

[settings]
auto_export_shows = 0
auto_export_calendars = 0
theme = none #auto #dark #light
map_provider = osm #gmaps

• Defaults:

  • homebase_city = Enter your city or where you want to start your trip
  • homebase_geocoordinates = It's geo-coordinates (in decimal form, e.g. 47.994853, 7.843950 )
  • artists = Your default artist's name
  • currency = The default currency code you want to use (e.g. EUR or USD)
  • distance_unit = the default distance unit (e.g. km)
  • travel_unit_price = The default price per unit (e.g. 0.30€/km)

• Paths:

  • working_directory = Enter the path of your working folder. If empty, the application's folder is used. See chapter "Working Folder".

• Settings:

  • auto_export_shows = If 1, the upcoming shows will be exported as .html on application closing
  • auto_export_calendars = If 1, the calendars will be exported as .ics on application closing
  • theme = Enter dark, light or auto (follows OS color theme) to use pyqtdarktheme. For some unknown reasons, it doesn't work with the released binaries.
  • map_provider = Enter gmaps if you want to use google maps instead of open street map

Working Folder vs Application Folder:

Working Folder:

The following files are stored into working folder:

• The databases (shows.csv and venues.csv)
• The show folders (Shows)
• The notes (Notes.txt)
• The exported files:
  • UpcomingShows.html
  • TourManagerShows.ics
  • TourManagerEvents.ics
  • TourManagerEventsForecast.ics

You can use a shared folder that is synchronized over internet to use TourManager from different computers and users. It works nicely with DropBox but should also work with others like NextCloud, etc. Using the working folder that way, you can have access to the files from everywhere. So you can have a look at the upcoming show on your mobile phone and subscribe the calendars with your calendar application.

Working Folder:

The following files are stored into application folder:

• All application files
• The database backups (Backups folder)
• config.ini

As you can see, the shared files are placed in the working folder and the user's configuration files and backups in the application folder.

Exports:

In the menu Export, you can export the upcoming shows as .html file or the calendars as .ics files. If set up in config.ini, these files are automatically exported on application closing.

Upcoming Shows:

• UpcomingShows.html: Open this file (e.g. from your mobile phone) to have a quick view of the upcoming shows. This is really handy when you are on tour without a computer with TourManager

Calendars: Subscribe to these .ics files with your favorite calendar application (only tested with Thunderbird).

• TourManagerShows.ics: A calendar with all your shows
• TourManagerEvents.ics: A calendar with all events (all venues with start and end dates)
• TourManagerEventsForecast.ics: A calendar with all events postponed 1 year ahead. This can be handy to guess when an event could be even if you don't have the exact date yet.

How to subscribe to the calendars with Thunderbird:

• Select Pathsin the Monitor (blue section)
• Copy the path of the file you want to subscribe to. E.g. file:///path/to/my/workdir/TourManagerShows.ics
• Open Thunderbird, go to calendar
• On the bottom left, press New Calendar...
• Select On the Network (yes, even if the file is local)
• Copy the file path to Locationand check This location doesn't require credentials
• Press Find Calendars
• If everything works as expected, Thunderbird will find the calendar. Then press Subscribe