Skip to content

A simple and elegant timer with a focus on user experience.

License

Notifications You must be signed in to change notification settings

JohnStephens1/Timerrhymer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Table of Contents

  1. Let's Get Right Into It
    1. Let's Go Through An Example
    2. The Beauty...
    3. Uses
  2. How to Install
  3. More Tools From Me
  4. Support

Let's Get Right Into It

It's quite straight forward.

Greeting

What makes Timerrhymer unique (apart from its astonishing display of beauty) is the way the time is formatted.

A table with examples should be clearer than any explanation:

Input Rendered Time
45 45s
130 1m 30s
4500 45m 00s
13000 1h 30m 00s
123456 12h 34m 56s

You can even enter things like 90 seconds or 90 minutes.

Input Rendered Time
90 1m 30s
9000 1h 30m 00s
9090 1h 31m 30s

You can also add spaces wherever you like, if that's what you're into.

Input Rendered Time
13000 1h 30m 00s
1 30 00 1h 30m 00s
  13   0   0 0 1h 30m 00s

Let's Go Through An Example!

Let's say we want a timer for 12h 34m 56s. So we enter:

greeting-filled

and hit enter, or click OK if our keyboard fell out of a skyscraper.

Then, Timerrhymer is nice enough to inform us of the result of the time we entered and asking us for confirmation.

stage-2

In this example you can clearly see why this time format is substantially simpler than entering the required seconds for example.

Since the formatted time is correct, let's hit enter again.

stage-2

And there we go! Our timer is running, happily ticking away wherever you like to put it. Minimizing it works just fine as well of course.

Hovering over the windows icon in the taskbar shows us the remaining time as well.

And once the time runs out, Timerrhymer gently informs us of this matter by coming into the foreground and playing a sweet lullaby to gently pry our attention away from whatever we were doing.

To close the window once the alarm goes off, bring it into focus and press space, enter or escape, and Timerrhymer will shut down.

The Beauty...

...lies in its simplicity.

So Timerrhymer's whole lifecycle looks like this:

  1. start Timerrhymer
  2. enter time
  3. hit enter 2 times

and you're done! Timer's going, and you can go along your business again as well, a matter of 5 seconds.

Uses

The core uses for Timerrhymer are

  • doing something for n minutes
    or
  • doing something in n minutes

Examples for my personal primary uses for which I can highly recommend it:

  • getting food out of the oven in n minutes
  • or out of the pot in n minutes
    and
  • leaving in n minutes
  • relaxing before studying in n minutes and
  • studying for m minutes before taking a break (for n minutes before studying for...)

How to Install

Simply download Timerrhymer.exe from the Releases section, and you're good to go! No installation required, not even Python.

The first time running the .exe file you might get a warning saying that the app isn't recognized, but after clicking 'More Info' and 'Run anyway' the warning shouldn't pop up anymore.

The only way to get rid of the warning would require me to buy a yearly subscription costing hundreds of euros, and since this is free, open-source software, that isn't in the cards for now.


Alternatively, if you prefer to use Python to run the program instead, clone the repository and run main.py using a Python environment containing the packages listed in requirements.txt, which can simply be installed by running:

python -m pip install -r requirements.txt

More Tools From Me

If you enjoyed Timerrhymer, feel free to check out my other quality-of-life tools, all free and open-source as well, no ads and no nonsense.

(coming soon)

Support

If you found anything useful, sharing them with people who might profit from them as well would be highly appreciated.

Alternatively, any and every donation would mean a lot and help me keep making them.

https://www.paypal.com/donate/?hosted_button_id=L4X2DFAYMJ72U