Skip to content
A plugin for accessing POP3/IMAP accounts in rails
Failed to load latest commit information.
lib improved syntax for using imap Feb 19, 2008
spec improved syntax for using imap Feb 19, 2008
MIT-LICENSE Initial import Feb 16, 2008
README Changed readme to be correct Jun 9, 2009
Rakefile Initial import Feb 16, 2008
mail_fetcher.yml.example Initial import Feb 16, 2008


Fetches emails via the Net::POP3 or Net::IMAP library over an SSL connection.
Also useful with the action_mailer_tls plugin if you want to send and receive
emails through GMail. This plugin has only been tested against Rails 2, so,
caveat emptor...

The fetcher assumes there is a mail_fetcher.yml file in the config/ directory, and a
sample can be seen in the mail_fetcher.yml.example file. The config expects a
hash, so configuring it at runtime is also possible, like so:

  MailFetcher.config = { :server => "", :username => "", :password => "mailfetchertest" }

Somewhere in your app (most likely in environment.rb) you need to specify the
mailer class you wish to use, and the protocol:

  MailFetcher.mailer_class = :my_mailer 
  MailFetcher.access = :pop (defaults to :imap)

And this would use the MyMailer class as the ActionMailer mailing class, and
set @@access to :pop, which would log into the account using Net::POP3.

To fetch email, just call MailFetcher.fetch:

  MailFetcher.fetch(:keep => true, :mailer_methods => [:receive, :spam, :forward_to_friends_and_family])

mail_fetcher.rb and the specs can show you a bunch of other handy things you can do.

Copyright (c) 2008 Steve Iannopollo (steve (at iannopollo dot com)), released under
the MIT license
Something went wrong with that request. Please try again.