public
Description: Crème Rappel—the little reminder app with a silly French name.
Homepage: http://hans.fugal.net/src/creme
Clone URL: git://github.com/fugalh/creme.git
fugalh (author)
Fri Mar 27 05:14:21 -0700 2009
commit  61d8c37483c5d628b9ba4c5652875ce07aa5406a
tree    9ca2d4abc6ddf1caaa0cacc66d78c3edda131f27
parent  6c5ae2b0c0c659716e7cc29a315228f34967744d
creme /
name age message
file .gitignore Fri Mar 27 05:14:21 -0700 2009 The full app in git. Don't forget to run make. [fugalh]
file .hgignore Fri Oct 10 13:00:42 -0700 2008 now with self-contained application bundle, coo... [fugalh]
directory Crème Rappel.app/ Fri Mar 27 05:14:21 -0700 2009 The full app in git. Don't forget to run make. [fugalh]
file LICENSE Fri Feb 15 10:13:29 -0800 2008 initial [fugalh]
file Makefile Fri Mar 27 05:14:21 -0700 2009 The full app in git. Don't forget to run make. [fugalh]
file README Thu Mar 26 09:18:13 -0700 2009 github [fugalh]
file README.timespec Tue Feb 26 08:42:59 -0800 2008 zulu [fugalh]
file Rakefile Thu Feb 28 13:20:47 -0800 2008 gem [fugalh]
file TODO Fri Oct 10 13:00:42 -0700 2008 now with self-contained application bundle, coo... [fugalh]
file VERSION Sun Jun 08 20:42:05 -0700 2008 growlnotify is fixed in Growl 1.1.3, no need fo... [fugalh]
directory bin/ Fri Oct 10 13:00:42 -0700 2008 now with self-contained application bundle, coo... [fugalh]
file gemspec Thu Feb 28 13:20:47 -0800 2008 gem [fugalh]
directory lib/ Fri Aug 01 22:47:01 -0700 2008 fix for "noon tomorrow" [fugalh]
file setup.rb Thu Feb 21 13:37:47 -0800 2008 refactor, now in ruby [fugalh]
file synopsis.png Thu Feb 21 14:35:48 -0800 2008 synopsis image showing +30[ms] [fugalh]
directory test/ Tue Feb 26 08:42:59 -0800 2008 zulu [fugalh]
README
Crème Rappel
http://hans.fugal.net/src/creme/

Synopsis
--------

    creme 1200 lunchtime
    creme 1710 go catch the bus
    creme +1h zone check

Requirements
------------

    - Ruby (included in OS X Tiger and above)
    - Growl
    - growlnotify (distributed with Growl in the Extras folder. Run install.sh)

Installation
------------

Look at the top of bin/creme and make any configuration changes you like. Then,
do

    sudo ruby setup.rb

Details
-------

    creme [timespec [message]]

If message is omitted, it is expected on stdin. If both are omitted, then
multiple notifications can be specified, one per line.

Timespecs are compatible with at(1), but more friendly. For example, you can do 
"+5m" instead of "+ 5 minutes".

Application Bundle
------------------

Crème Rappel now has a self-contained application bundle, so you can put it in
the dock or launch it with quicksilver. It requires only Growl. When you give
it a command it will display the timestamp and pid in a growl message.

If you put a command in ~/.creme/default it will be the default. This is useful
if you frequently need to issue the same command (e.g. whenever my wife tells
me she's coming to pick me up, I do "+7 erin" so I can meet her outside).

Troubleshooting
---------------

If bash can't find creme after running setup.rb, you may need to symlink or
adjust PATH if you're using Leopard's Ruby.  Something like this in your
~/.bashrc :

    export PATH=$PATH:/System/Library/Frameworks/Ruby.framework/Versions/1.8/usr/bin

If you get an annoying warning something like this

    creme:9: warning: Insecure world writable dir /usr/local/mysql/bin in PATH, mode 040777

then you can add -W0 to the shebang line (the first line of the script). So the
new shebang line would look like

    #! /usr/bin/ruby -W0

But really, see if there's another safer way to work around the MySQL
wonkiness, than a world-writable path entry.

Development
-----------
http://github.com/fugalh/creme

Author
------
Hans Fugal <hans@fugal.net>

License
-------
Copyright (C) 2008  Hans Fugal

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

The icon is from the Crystal Clear icon set by Everaldo Coelho, licensed under
the LGPL.