Slots
About
This tool shows all slots where attendees are free. It uses Microsoft Outlook to read agenda. Windows and Mac are supported
Prerequisites
- mac or windows
- python3.9+
- Microsoft Outlook
Example
python3 slots.py --attendees 'attendee1@domain.com; Atten Dee <attendee2@domain>' -tz 'America/New_York'
? Select a Timeslot to create a meeting:
Cancel (CTRL+C)
---------------
Thursday 20 January 14:00 - 15:00 CET / 08:00 - 09:00 America/New_York
Thursday 20 January 16:00 - 18:00 CET / 10:00 - 12:00 America/New_York
Friday 21 January 14:00 - 15:00 CET / 08:00 - 09:00 America/New_York
>Friday 21 January 15:30 - 18:00 CET / 09:30 - 12:00 America/New_York
Monday 24 January 15:00 - 18:00 CET / 09:00 - 12:00 America/New_York
Tuesday 25 January 15:00 - 18:00 CET / 09:00 - 12:00 America/New_York
Wednesday 26 January 16:00 - 18:00 CET / 10:00 - 12:00 America/New_York
Thursday 27 January 14:00 - 15:00 CET / 08:00 - 09:00 America/New_York
Install
mac
pip install -r requirements/macos.txt
win
pip install -r requirements/windows.txt
Advanced usage
Show all slots where 5O% of attendees are free and show alternative timezone:
python3 slots.py --attendees 'attendee1@domain.com; Atten Dee <attendee2@domain>' --rate 50 -tz America/New_York
Show full agenda:
python3 slots.py --attendees 'attendee1@domain.com; Atten Dee <attendee2@domain>' --rate 50 --full
More:
❯ python3 slots.py --help
Usage: slots.py [OPTIONS]
Options:
-a, --attendees TEXT A semicolon separated list of contacts
--start TEXT Begining of the date range to find available
slots. Iso date or Arrow Humanised time (ex:
"in 30 days"). See https://arrow.readthedocs.io/en/latest/#dehumanize.
Default is today.
--end TEXT The end of the date range to find available
slots. Iso date or Arrow Humanised time (ex:
"in 30 days"). See https://arrow.readthedocs.io/en/latest/#dehumanize.
Default is "in 7
days".
--full / --only-slots Show slots or a full agenda (default=only
slots)
-r, --rate INTEGER Acceptable share of available attendees in
percent(%)
--tentative / --no-tentative Treat tentative meetings as free
-l, --lenght INTEGER Length of the meeting, in minutes
-tz, --alternative_tz TEXT A comma separated list of alternative
Timezones. if "auto" script will fetch
timezones from slack (mwinit --aea requied).
-hr, --hours TEXT Find availability between the hours of...
Default = "0800-1900".
-f, --fmt TEXT Time format in list of available slots.
"HH:mm" or "h:mma". Refer to https://arrow.rea
dthedocs.io/en/latest/#supported-tokens.
Default "HH:mm".
--help Show this message and exit.