titome ⏰ time-to-meet

Overview

Often I want a fast way to see and communicate available times in the time zones of various colleagues. With major inspiration from https://superuser.com/a/1397116 this package provides such a display.

Install

Package installs in the usual Python way or place the titome script in your PATH.

Usage

By default it will tell you times for today.

titome

        today: Thursday 06/03 09:00 (10 hours ago)        
┏━━━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┓
┃ zone ┃  9 ┃ 10 ┃ 11 ┃ 12 ┃ 13 ┃ 14 ┃ 15 ┃ 16 ┃ 17 ┃ 18 ┃
┡━━━━━━╇━━━━╇━━━━╇━━━━╇━━━━╇━━━━╇━━━━╇━━━━╇━━━━╇━━━━╇━━━━┩
│ BNL  │  9 │ 10 │ 11 │ 12 │ 13 │ 14 │ 15 │ 16 │ 17 │ 18 │
│ FNAL │  8 │  9 │ 10 │ 11 │ 12 │ 13 │ 14 │ 15 │ 16 │ 17 │
│ LBNL │  6 │  7 │  8 │  9 │ 10 │ 11 │ 12 │ 13 │ 14 │ 15 │
│ RAL  │ 14 │ 15 │ 16 │ 17 │ 18 │ 19 │ 20 │ 21 │ 22 │ 23 │
│ CERN │ 15 │ 16 │ 17 │ 18 │ 19 │ 20 │ 21 │ 22 │ 23 │  0 │
│ KEK  │ 22 │ 23 │  0 │  1 │  2 │  3 │  4 │  5 │  6 │  7 │
└──────┴────┴────┴────┴────┴────┴────┴────┴────┴────┴────┘

You can check times for other days an limit the hours

titome tomorrow -t 10,12,15

tomorrow: Friday 06/04 
  10:00 (in 14 hours)  
┏━━━━━━┳━━━━┳━━━━┳━━━━┓
┃ zone ┃ 10 ┃ 12 ┃ 15 ┃
┡━━━━━━╇━━━━╇━━━━╇━━━━┩
│ BNL  │ 10 │ 12 │ 15 │
│ FNAL │  9 │ 11 │ 14 │
│ LBNL │  7 │  9 │ 12 │
│ RAL  │ 15 │ 17 │ 20 │
│ CERN │ 16 │ 18 │ 21 │
│ KEK  │ 23 │  1 │  4 │
└──────┴────┴────┴────┘

Configuration

On first run, a configuration file will be generated. It may be edited to change zones and their displayed labels. Here is an example.