tmdconv is my entry for OFFLFIRSOCH 2024, the inaugural OFFLine-FIRst SOftware CHallenge, announced by Solderpunk in the beginning of the month.
The idea of OFFLFIRSOCH is to write and share a piece of software that is offline-first, during the month of March. The software should either not use the internet at all, or be able to work well when a connection is not available.
To quote Solderpunk:
[The software should be] fundamentally designed around the assumption that the internet is not always available and maintains 90% or more of its functionality when used offline, and will continue to do so no matter whether it gets internet access once per week, once per month, once per year or even longer.
I love the idea, because it challenges and invites us to take a stand against 'Service as a Software Substitute' or SaaSS, and perhaps help others do the same by sharing our work. I highly recommend reading the entire announcement.
Who Does That Server Really Serve?
But back to tmdconv.
I happen to currently work for a geographically distributed company where members of each team may be located in several different time zones across the globe. As such, I regularly have to convert times in one time zone to another for meetings, etc. I do most of the commonly-used conversions in my head, but for the less frequently used ones or around daylight saving changes, it can be very tempting to reach for online tools for the conversions. tmdconv is how I've stopped doing that. :)
tmdconv.sh, the tiny menu-based date converter, is a small POSIX shell script for converting date/time in one time zone to another, using the 'date' utility, as provided e.g. by GNU coreutils. It has a default 'terminal' interface mode, where the date/time and time zone prompts are done using 'fzf', and the result is printed to stdout. There is also a 'graphical' mode, where prompts are done using 'dmenu' if on X11 and 'wmenu' if on Wayland, and the result is displayed as a system notification using 'notify-send'.
tmdconv.sh lets me do this computation on my own machine, which I own and control, and do it *much* more efficiently and simpler too, by skipping the bloated and likely nonfree implementations in JavaScript, and instead using the lovely date utility from GNU coreutils on my Debian-based system.
If like me you also like small, composable tools that do one thing and do it well, give tmdconv a try - you might like it too! Have any comments or feedback? Write to me at bandali@kelar.org via email, I'd be happy to hear from you.
Take care, and so long for now.
P.S. Happy Pi Day! Enjoy the Pi symbol ASCII art by jgs.
,;;;;;;;;;;;;'
;;'';;'';;'''
' ;; ;;
;; ;;
jgs ;; ;;
;' ;'