The information below will provide information about this project but remember that Air Maestro via Okta along with any calls or messages from Operations has the final say. This should reflect any changes within Air Maestro, but it may take up to 48 hours depending on the calendar service you subscribe to. This is an additional tool to make life easier with checking the roster and making plans. I will not accept any responsibility for anyone missing or running late for shifts.
You can generate your personal Air Maestro Calendar Link by scrolling to the bottom of the Schedule page of Air Maestro once you sign into Okta.
Generate (if not already active) and Copy the Calendar Link from Air Maestro and paste it in the field below and click the "Generate Modified Link" button. A new subscription URL will be created which you use in any calendar service you choose. It's recommended to complete this on the main device you plan on viewing the calendar on. This can be completed using a company computer, but it may not allow you access to your personal calendars or allow copy and paste of the long link.
Setup Instructions
Air Maestro provider Avinet has an existing how-to guide for various platforms here, but I've put together some instruction for Google Calendar, Outlook Web and Apple Calendar. This is best completed on
Note: Currently adding external calendars using a company managed Outlook Desktop application is not supported but will show up there shortly after adding it using the web version.
With you newly modified URL copied, complete the following.
Click here or the icon above to go to the Google Calendar web page,
If the link launches the application on your phone, close it and long press the link and select open in new window - some phones are smarter than they should be...
You may need to sign into the Google account that you wish to add the calendar to,
Paste the modified URL into the "URL of calendar" field and select "Add calendar",
Once added, it may take few minutes before events start to show in your calendar on the web version,
If your newly added calendar doesn't show on your mobile device, you will need to do the following,
Open the calendar application,
Go to Settings from the menu button,
Select Show More,
Find the calendar, select Sync and choose your colour,
You should now be able to back yourself out of the menu and admire your new calendar.
With you newly modified URL copied, complete the following.
Click here or the Outlook icon above to go to your personal Outlook Calendar web page,
Click here or the Microsoft Business icon above to go to the corporate M365 Calendar web page,
If the link launches the application on your phone, close it and long press the link and select open in new window - some phones are smarter than they should be...
You may need to sign into the account that you wish to add the calendar to,
Paste the modified URL into the field, give it a name and select "Import",
It will say imported successfully and then you may browse the calendar,
If your newly added calendar doesn't show on your mobile device, you will need to do the following,
Open the calendar application,
Go to the view options generally by clicking on your picture or account identifier,
Select the new calendar to display,
You should now be able to back yourself out of the menu and admire your new calendar.
With you newly modified URL copied, complete the following. If you generated the modified URL on a PC, you may need to send that link to your phone as an email or note so you can copy the link on your device.
Open the calendar application,
Select the calendar icon in the top-left,
Select "Add Calendar" in the bottom-left,
Select "Add Subscription Calendar",
Paste the modified URL into the field and save it,
You should now be able to back yourself out of the menu and admire your new calendar.
Note: Duty and Tasking Sign On - your sign on time should match the tasking event in your calendar. The web version of Air Maestro will continue to display a DUTY SHIFT overlapping with a TASKING SHIFT. The calendar service has been adjusted as per "standard roster protocols" to extend the TASKING SHIFT and remove the DUTY SHIFT.
This Project retrieves your calendar from Air Maestro and adjusts the following.
Corrects the TIMEZONE of the calendar to be suitable as per Air Maestro outputs,
Duplicate Leave types removed,
Duplicate Day Off types removed,
Duplicate Standby events removed,
Duplicate Admin events removed,
Assigned Base events removed,
All Day events such as RDOs formatted correctly,
Event names simplified e.g.,"RDO - Rostered Day Off", now "RDO",
Recency events displayed correctly for the specific day e.g., Night Surv or EPs,
Time Stamp of last Roster Sync between your calendar and Air Maestro added as the first line of all events for awareness.
Each sync request from your calendar service is retrieved from Air Maestro, corrected and filtered, and then pushed to your calendar,
No calendar event data is saved within this project,
Event start times will display in your local calendar time – If you have a 0600H sign on in Broome but your phone is still set to Darwin Time, the event will show as 0730I/K until your phone clock updates to WA,
If you generate a new link in Air Maestro – you will need to generate a new link with this website, remove your old calendar and add a new one with the new link generated,
Depending on your calendar service, it may take a short time to initially populate with events (anywhere from 5 minutes to 1 hour),
Updates may occur only once every 24 hours, but it varies between calendar services (anywhere from every 4 to 48 hours) - This is up to your calendar service and Air Maestro, I can't control it. If updates do not occur past 48 hours, there may be an issue and hopefully it'll be resolved shortly.
I have adjusted the calendar processing to suite the many but if you have any suggestions or ideas that could improve it, please let me know.
If you find that the output is not to your liking or suitable for your needs, there may be a way to personalise it with the use of API parameters.
If you want your duty and tasking to show separately, append your generated URL with &overlap=true
If you want your events to not show the time of last sync because of notifications you have already set up for changed events, append your generated URL with &hideupdate=true
More options to come if the need calls for it...
If you have any questions regarding how this project has been built, you can review the code on GitHub.
