moparisthebest
/
mailcatcher
mirror of https://github.com/moparisthebest/mailcatcher
1
0
Fork 0
Code Issues Releases Wiki Activity
75 Commits 4 Branches 34 Tags 1.4 MiB
Ruby 62.8%
CoffeeScript 22%
CSS 10.6%
HTML 4.3%
Dockerfile 0.3%
Go to file
Samuel Cochran d07a6dff46 Version bump. 2011-05-29 21:18:15 +08:00
bin Add catchmail, a sendmail-analogue for deliverying to MailCatcher via SMTP. 2011-05-29 12:40:14 +08:00
lib Add whole-message types as well as multipart types. 2011-05-29 21:16:33 +08:00
public Fix format tabs. 2011-05-29 21:16:40 +08:00
views There should be a row in there... 2011-05-29 14:49:29 +08:00
.gitignore Ignore generated gems and rdoc 2011-05-27 20:38:39 +08:00
Gemfile Bundler for development pulling from Gemfile, no dist. 2011-05-27 21:47:43 +08:00
Gemfile.lock Version bump. 2011-05-29 21:18:15 +08:00
LICENSE Split into modules, updated style a little, switched to Jeweler, added EventMachine Channel and Skinny WebSockets for no-refresh mail notification, got rid of Sunshowers. 2010-10-28 03:12:26 +08:00
README.md Update README with new screenshot and feature. 2011-05-27 22:34:20 +08:00
Rakefile Add coffee-script. 2011-05-29 14:46:28 +08:00
VERSION Version bump. 2011-05-29 21:18:15 +08:00
mailcatcher.gemspec Add coffee-script. 2011-05-29 14:46:28 +08:00

README.md

MailCatcher

Catches mail and serves it through a dream.

MailCatcher runs a super simple SMTP server which catches any message sent to it to display in a web interface. Run mailcatcher, set your favourite app to deliver to smtp://127.0.0.1:1025 instead of your default SMTP server, then check out http://127.0.0.1:1080 to see the mail that's arrived so far.

MailCatcher screenshot

How

  1. gem install mailcatcher
  2. mailcatcher
  3. Go to http://localhost:1080/
  4. Send mail through smtp://localhost:1025

Features

  • Catches all mail and stores it for display.
  • Shows HTML, Plain Text and Source version of messages, as applicable.
  • Download original email to view in your native mail client(s).
  • Rewrites HTML enabling display of embedded, inline images/etc and open links in a new window. (currently very basic)
  • Lists attachments and allows separate downloading of parts.
  • Written super-simply in EventMachine, easy to dig in and change.
  • Command line options to override the default SMTP/HTTP IP and port settings.
  • Mail appears instantly if your browser supports WebSockets.
  • Daemonizable to run in the background.

Caveats

  • Mail processing is fairly basic but easily modified. If something doesn't work for you, fork and fix it or file an issue and let me know. Include the whole message you're having problems with.
  • The interface is very basic and has not been tested on many browsers yet.

API

A fairly RESTful URL schema means you can download a list of messages in JSON from /messages, each message's metadata with /messages/:id.json, and then the pertinent parts with /messages/:id.html and /messages/:id.plain for the default HTML and plain text version, /messages/:id/:cid for individual attachments by CID, or the whole message with /messages/:id.source.

TODO

  • Growl support.
  • Test suite.
  • Add mail delivery on request, optionally multiple times.
  • Forward mail to rendering service, maybe CampaignMonitor?
  • Package as an app? Native interfaces? HotCocoa?

Thanks

MailCatcher is just a mishmash of other people's hard work. Thank you so much to the people who have built the wonderful guts on which this project relies.

Copyright

Copyright (c) 2010 Samuel Cochran. See LICENSE for details.

Dreams

For dream catching, try this.