Back to files

Appointment 0.6

Copyright 2002 Leigh L. Klotz Jr. <klotz@graflex.org> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Danger and Hiptop are trademarks of Danger. Sidekick is a trademark of T-Mobile.
Outlook is a trademark of Microsoft.

TODO:

• Repeating appointments
• Updating appointments
• Notes
  1. Untar appointment-0.6.tar.gz to ~/procmail/.
  2. Edit add-outlook-appointment.pl Edit the following variables:
     • $allowedsenders A regular expression. See my examples. Don't forget to put \ before any @ in the string.
     • $adminaddress Where responses come from. Take care not to make this the address of the script, since you don't want mail loops!
     • $adminfullname Name that shows up on responses.
     • $subjectprefix If you choose to use subject-based filtering (i.e., all messages go to you, but ones with a certain subject get added as appointments), you will need to add the prefix you use to this regular expression. For example, if you want all messages starting with Subject "APPT: " and Subject "APPT: Fwd: " to be handled as appointments, change it to $subjectprefix="(APPT: )|(APPT: Fwd: )".
     • $logfile Errors go to this file. It should be writable to you.
     • $debug Turn on for testing -- it inhibits adding appointments and sending mail. Check the logfile.
     • $log Turn off to remove logging.
  3. procmail.sample Edit this file according to your taste, and append to your ~/.procmailrc. You must be able to receive mail at the specified address. If you choose to use subject-based filtering instead of address-based, change $subjectprefix above.
  4. Run ~/procmail/login to create the cookies.
  5. Test You are done reading this file. Now either add you@appointment.example.com to a new Outlook appointment, or forward an existing appointment to you@appointment.example.com. (No, don't really use example.com -- use the right address.) Don't use iCalendar format, but make sure you get an appointment message that is non-empty. The message should look something like this:

     From: "Sue" <sue@example> To: "Fred" <fred@appointment.example.com> Subject: FW: [1:30-3:30 PST] Plan for 2003 Date: Tue, 19 Nov 2002 11:07:08 -0800

     When: Tuesday, November 19, 2002 1:30 PM-3:30 PM (GMT-08:00) Pacific Time
     (US & Canada); Tijuana.
     Where: Main Conference Room

     *~*~*~*~*~*~*~*~*~*

If the message is multipart MIME and contains the above as a text/plain part, that's fine. If the message is empty, then that's a problem.