Get RIMA!
Latest Stable Version: 0.2 on Aug 02, 2009
Features
-
Why Ruby?
-
Ruby is simple, elegant and well supported. It's easy to learn and understand. It's free.
-
Why Imap?
-
Imap is better than POP. And using standard Imap commands you can control your Mailbox.
-
Why Mailbox?
-
Almost every mailbox I've seen is messy and filled up. So you need RIMA!
-
Why Archiver?
-
Because information costs real $$! And you don't want to throw away money searching for lost emails!
-
What do you need?
-
Uh... An Imap Account; a Linux/Unix/OsX box with Ruby installed on; an internet connection; some spare time!
-
RIMA is actively supported?
-
Hey, I've just uploaded version 0.2! It's Brand New!
If you like it, I'll be glad to continue work on it! And I like your contribution too!
-
Can I trust it?
-
Of course you can!
Better after a backup...
-
Is it simple to use?
-
Yes! Just edit only one little configuration file!
But you have to read the instructions...
-
Is it free?
-
RIMA is licensed with a MIT License, so it is!
Download RIMA to obtain the source code!
-
But... free as in beer?
-
How RIMA works?
- Upon the execution, RIMA.rb reads and parse the configuration file Settings.yml
- For each mailbox in Settings.yml, RIMA.rb create a new Mailbox object and puts it into an array
- For each Mailbox in the array, RIMA calls archive on it. That's:
- The Mailbox object create the connection to the server
- When ready, it creates the archive folders (named like 2009-04), and selects the messages that needs to be moved
- Each message is copied from Inbox to the new folder and flagged as deleted into the Inbox
- Mailbox calls the Imap function expunge to effectively delete the flagged messages
- Mailbox disconnects itself from the server
Instructions (a.k.a. TFM!)
Installation:
- Download RIMA and unzip the file to your favourite directory
- Permit the execution of the file RIMA.rb (if you want)
$> chmod +x RIMA.rb
Basic Usage:
Step One:
Open Settings.yml with a simple text editor.
For each mailbox you want to archive, you have to edit name, server, user, password and ssl fields.
You can add or wipe mailboxes definitions as you want, following the example. (I don't have tested more than two mailboxes...)
Step Two:
For interactive execution, just type
$> ruby RIMA.rb
or if you have chmodded it for execution
$> ./RIMA.rb
or add it to the Cron (or Anacron) records for scheduled execution.
You know how.
Step Three:
There is not Step Three =)
Notes:
- Please (please, please!) consider to make a backup of your entire mailbox before executing RIMA script.
Even if I tested it, this Software might make the worst things with your precious messages (a.k.a. deletion).
I will not be responsible for any loss or damage to your data.
No claims. Never!
Chuck Norris is my lawyer. So be responsible!
- The execution time is proportional to the number of messages in your mailbox.
- Sometimes ssl to imap connections fails. In case, try with
ssl: false
instead of
ssl: true
in Settings.yml
To Do:
- Standard log messages and errors appears to the stdout. I will move it to stdout and stderr in the next version.