titome ⏰ time-to-meet

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.

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

By default it will tell you times for today.

titome

         today: Sunday 09/15 09:00 (4 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 │
│ LANL │  7 │  8 │  9 │ 10 │ 11 │ 12 │ 13 │ 14 │ 15 │ 16 │
│ 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: Monday 09/16 
  10:00 (in 20 hours)  
┏━━━━━━┳━━━━┳━━━━┳━━━━┓
┃ zone ┃ 10 ┃ 12 ┃ 15 ┃
┡━━━━━━╇━━━━╇━━━━╇━━━━┩
│ BNL  │ 10 │ 12 │ 15 │
│ FNAL │  9 │ 11 │ 14 │
│ LANL │  8 │ 10 │ 13 │
│ LBNL │  7 │  9 │ 12 │
│ RAL  │ 15 │ 17 │ 20 │
│ CERN │ 16 │ 18 │ 21 │
│ KEK  │ 23 │  1 │  4 │
└──────┴────┴────┴────┘

On first run, a configuration file will be generated into ~/.config/titome/titome.cfg (or as directed by XDG_CONFIG_HOME). You may then edit the file for future use. The format is:

[zones]
Label1 = Zone/Name

Here is a full example.

[zones]
BNL = US/Eastern
FNAL = US/Central
LANL = US/Mountain
LBNL = US/Pacific
RAL = Europe/London
CERN = Europe/Zurich
KEK = Japan