File	Date	Author	Commit
LICENSE	2016-07-26	coreymwamba	[a5d754] first commit
README	2016-07-26	coreymwamba	[a5d754] first commit
bash-fuzzy-clock.sh	2016-07-26	coreymwamba	[a5d754] first commit
bash-fuzzy-clock.tar.gz	2016-07-26	coreymwamba	[a5d754] first commit
de.po	2016-07-26	coreymwamba	[a5d754] first commit
es.po	2016-07-26	coreymwamba	[a5d754] first commit
fr.po	2016-07-26	coreymwamba	[a5d754] first commit
it.po	2016-07-26	coreymwamba	[a5d754] first commit

Read Me

bash-fuzzy-clock

(c) Corey Mwamba 2015

INSTALL:

If you're on Arch Linux you can install this from the AUR:

<https://aur.archlinux.org/packages/bash-fuzzy-clock/>

If not, from a terminal:

$ tar xf bash-fuzzy-clock.tar.gz
$ sudo install -v bash-fuzzy-clock.sh -m 0755 /usr/bin/bash-fuzzy-clock

If you need the French, German, Italian, or Spanish translations, make sure you 
have LANGUAGE set in .bashrc (and for Conky, .xinitrc) or /etc/locale.conf; then

$ sudo msgfmt $LANGUAGE.po -o /usr/share/locale/$LANGUAGE/LC_MESSAGES/bash-fuzzy-clock.mo

On an Apple computer, you can use GeekTool to display the clock on your 
screen, using a Shell Geeklet: see 
<http://www.maclife.com/article/howtos/how_customize_your_desktop_geektool>

USE

Just invoke it:
$ bash-fuzzy-clock
--> nearly twenty past seven

You can use the "m" option to display the general time of day:
$ bash-fuzzy-clock m
--> morning 

WHAT IS A FUZZY CLOCK?

Fuzzy clocks display a generalisation of the time in informal or natural 
language. They are only give precise time on the hour and at 
five-minute intervals from the hour.

WHY ANOTHER FUZZY CLOCK?

There are a number of fuzzy clock implementations which

1. don't work in any other language than English;
2. are not fuzzy - they simply display the exact time in words; or
3. require Python

and at the time of first writing the script, I couldn't find a clock 
that I liked. So I made one that only required Bash, was fuzzy, and was 
(to the limits of my language knowledge) translatable.