titome ⏰ time-to-meet

1 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.

2 Install

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

3 Usage

By default it will tell you times for today.

titome
         today: Friday 06/04 09:00 (in 12 hours)          
┏━━━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┳━━━━┓
┃ 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: Saturday   
06/05 10:00 (in a day) 
┏━━━━━━┳━━━━┳━━━━┳━━━━┓
┃ 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 │
└──────┴────┴────┴────┘

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.

[zones]
bnl = US/Eastern:BNL
fnal = US/Central:FNAL
lbnl = US/Pacific:LBNL
ral = Europe/London:RAL
cern = Europe/Zurich:CERN
kek = Japan:KEK

Author: BV

Created: 2021-06-03 Thu 20:23

Validate