Access user generated MMS content quickly

MMS2R is a library that decodes the parts of an MMS message to disk while stripping out advertising injected by the mobile/cellphone carriers. MMS messages are multipart email and the carriers often inject branding into these messages. Use MMS2R if you want to easily get at the real user generated content in a MMS without having to deal with the extra content added by the carriers.


Branding is explicitly removed from the following carriers. Contact the author to add support for additional carriers not listed below.

If MMS2R is not aware of a particular carrier no extra processing is done to the MMS other than decoding and consolidating its media.

Greedy (default) or lazy processing of MMS

Supports representing content as CGI.rb temp file objects for AttachmentFu integration

Access content through media Hash attribute or through block on #process


As simple as:

require 'mail'
require 'mms2r'
mms ='some_saved_mail.file'))
file = mms.default_media
and later when the application is done with the temporary files produced by mms2r

MMS2R Book

MMS2R @ PeepCode


MMS2R project page

MMS2R on github

In depth coding examples listed in the MMS2R API documentation

Flickr page for MMS2R



sudo gem install mms2r


sudo gem sources -a

sudo gem install monde-mms2r

As Seen On The Internets


Shane Vitarana:

"MMS2R saved me two weeks worth of work I would have had to do on my own"

Luke Francl:

"Thanks for creating MMS2R! It made integrating our Rails app with mobile messages simple and saved us a lot of time -- and kept our client happy."

Will Jessup:

"assert mms2r.not.suck == true"

Layton Wedgeworth:

"MMS2R has been a lifesaver and I will forever be in it's deb"


Rails Magazine, Issue #3, "Receiving E-Mail With Rails", By Jason Seifer

Mike Mondragon (Sasqutch, Inc.) and Luke Francl (Slantwise Design, USA) MMS2R PeepCode

Luke Francl (Slantwise Design, USA) Published: MMS2R PeepCode and Advanced Rails Recipes

Luke Francl (Slantwise Design, USA) Announcing FanChatter: mobile sports chat

Luke Francl (Slantwise Design, USA) Rails and Mobil World @ Ostrava On Rails

Luke Francl (Slantwise Design, USA) Using MMS2R for mobile integration with Rails