User’s Guide

This User’s Guide aims to get you started with SwirlyMMS. It gives detailed description of the installation and set-up processes and then shows the basic usage of the application. The User’s Guide is divided in the following sections:

Prerequisites

There are not many prerequisites to use SwirlyMMS. But there are at least two obvious ones…

Installation

This section describes how to use Cydia to download and install SwirlyMMS.

Setup

In order to be able to send and receive MMSs you must first configure SwirlyMMS with appropriate settings that are specific for your Service Provider.

SwirlyNet Setup

One of the most compelling features of SwirlyMMS is the ability to send messages to your SwirlyMMS friends for free. Learn how to do that here.

Buy SwirlyMMS from within SwirlyMMS

How to buy from within SwirlyMMS if you preferred not buying via Cydia Store.

Usage

The basic usage of SwirlyMMS is described here, even though the usage should be “obvious”.

Additional Information

Did we miss to answer some of your questions in this User’s Guide?

Prerequisites

The prerequisites to use SwirlyMMS is that you:

Installation

If you are all set, start the installation program Cydia.
SwirlyMMS is one of the Cydia Store applications. Therefore, SwirlyMMS can be found in the Cydia Store: Products list.
Scroll down a bit (close to the bottom of the list) and you will see SwirlyMMS. The price is $6 for an upgrade from a SwirlyMMSv1 license or $12 for a new license.

Tap SwirlyMMS to see its details.

Here you can press the yellow Purchase Package button (in this case an upgrade purchase) which will lead you to the normal Cydia Store purchase & install procedure.

You can also press the Install Trial button which will directly install SwirlyMMS without purchasing it. In this case you can purchase it later from within SwirlyMMS. See instructions below.

If you press Install Trial you can start SwirlyMMS and look around but you cannot use it to send and receive MMSes. For that you need to purchase it.

To confirm to start installing SwirlyMMS tap the Confirm button.

After having clicked the Confirm button, the download will begin. After SwirlyMMS has been download it is automatically installed by Cydia.

When Cydia is finished installing SwirlyMMS you will be asked to reboot the iPhone device. It is mandatory that you do reboot the iPhone for SwirlyMMS to operate properly!

After the iPhone has rebooted you will find SwirlyMMS on the Home Screen.

Installation is now complete and you may now launch SwirlyMMS!

However, before you can send and receive MMSs, you must setup the application as described in the next section.

Setup

In order to be able to send and receive MMSs you must first acquire a license and configure SwirlyMMS with appropriate settings that are specific for your Service Provider. The settings are MMSC and Proxy together with APN, Username and Password. Optionally, you may change the default image size when sending a picture and specify a User Agent.

So, without further ado, tap the SwirlyMMS icon to launch the application.
When you start SwirlyMMS it will always verify that you have a valid license. Since this is your first start you don’t have any license yet but SwirlyMMS will immediately start an attempt to fetch your license.

If you purchased your license from within Cydia Store then a license will be found.

If you didn’t then the license fetch will fail and you will be presented with this screen. How to buy SwirlyMMS now is described in the section Buy SwirlyMMS from within SwirlyMMS
below.

This is how it looks if a valid license is found right away!
Ok, you are now ready to configure SwirlyMMS. Push the Arrow button to jump into SwirlyMMS!
This is the main screen and it shows the different folders where sent and received MMSs goes.

Take note of the “m” in the statusbar. It indicates whether we have a valid MMS session or not. It is most often grey after a new installation of SwirlyMMS. To be able to send and receive MMSs however, this “m” must be green. In order to make it green we need to configure the settings.

So, the first thing to do is go to the SwirlyMMS’s Settings screen. Therfore, tap the Settings icon in the bottom bar.

It is very important that you get these settings right. If they are not 100% correct, you will not be able to send and receive MMSs!!

The settings are specific for your Service Operator. The settings shown in the picture to the left are Telia’s MMS settings in Sweden. Contact your Service Operator to find out your settings! Alternatively, you can scan our forum’s Usable Settings section, or check this list or request the Settings over-the-air (OTA) by pressing that button below.

MMSC and Proxy must always be filled in.

APN, Username and Password may be empty but should oftentimes be defined. If APN, Username and Proxy are correct, you will see a green “m”.

Image size, is set to Medium by default. If you know that your Service Operator can manage large pictures you can change this setting. Note that many Operators have a size limit of 300KB.

User Agent, some Service Operators only accept messages from known handsets. In this case, you can set your handset to be something else. Normally, this is not needed though.

Press the Save button to save your settings.

SwirlyNet Setup

SwirlyNet™ is a free service provided by SwirlySpace allowing you to send MMSes for free* to your SwirlyMMS friends. To make the SwirlyNet service work, and allow you as well as your friends to send and receive messages over the SwirlyNet, you must activate it by providing your iPhone phone number, including your national prefix. SwirlySpace will only use the phone number you provide to send messages via the SwirlyNet. SwirlySpace will under NO circumstances give out the information you have provided to any third party.

* The cost for you to send an MMS via the SwirlyNet depends on what connection type and data plan you have. For example if you have Wifi access or if you have a flat-rate cellular data plan then the cost is really nil, otherwise the cost will depend on your data plan.

So, lets get started. Go into the settings page by pressing the settings button.
On the settings page there is a section called SwirlyNet. The first row shows the state of your SwirlyNet activation. It can be a red cross (not activated), a blue clock (pending activation) and a green check mark (activated).

In this case it is a red cross meaning SwirlyNet is not activated.

Press the blue arrow-button to come to the activation page.

Enter your iPhone phone number and press Activate. It is very important that you enter this number correctly and that it includes your national prefix.

Now we go…

For a short while you will see this page. Normally it only takes a few seconds for the activation to complete so just be patient.

Never close SwirlyMMS while waiting for the activation confirmation. If you do so you must start the activation from the beginning (see picture above).

When the activation confirmation arrives you will see this popup. Just press Close…
…and you will get here. The activation is now completed and you can start sending via SwirlyNet right away.
Normally SwirlyMMS will first try to send an MMS via SwirlyNet and if that is not possible the MMS will be sent via your carriers MMS network.

In the settings you can select that you always want your MMSes being sent via SwirlyNet and never via your carrier (1). If you have done that choice you will get an alert message if the MMS wasn’t possible to send via SwirlyNet.

In the settings you can also choose to use SwirlyNet only when Wifi is available (in contrast to use it with Wifi as well as with your cellular data) (2).

Finally you can also decide if you want that SwirlyNet MMS notifications shall be fetched in the background or not (3). if you turn background fetching off you will not get notified about new messages coming via SwirlyNet until you start SwirlyMMS so best is to leave this on.

Buy SwirlyMMS from within SwirlyMMS

SwirlyMMS costs $6 for an upgrade and $12 for a new license. Buying it involves just a few steps, as described below. In short, the steps are: Press Buy, read and accept license agreement, follow the secure link to PayPal’s payment page, enter credit card information and complete the payment. After having received the confirmation email from SwirlySpace, activate the license by pressing the Buy button followed by Activate. You’re done!

So, in order to make a purchase, just press the Buy button.
Read and review the Information and License agreement. If accepted, go ahead and press Buy button to launch the Safari Web browser.
Read the information on this page, scroll down and press the Buy Now button which open a secure link to PayPal’s payment page.Note: For those of you that hesitate to use your Credit Card on the iPhone, you can make the purchase directly from your desktop computer. In order to do that you must navigate to exactly the same link as shown on this current page! The easiest way to do so is to email this page’s link to your desktop computer by pressing the ‘+’-sign in the bottom, then selecting “Mail Link to this Page”. Alternatively, you can manually enter the same link as shown on this page, i.e.: http://www.swirlyspace.com/PayPal/BuyNow.php?purchase_code=xxx, where the somewhat longish xxx is your unique code. It is very important that you enter everything exactly as shown on this page! Failure to do so will result in an invalid license!
This is a secure link to PayPal, which you use to complete the purchase. Have your credit card ready and click Continue.
Enter your Credit card, address and email
information, then Review your order and Continue.Confirm and complete your purchase.
After having completed the purchase on the PayPal site, you will receive an email confirming your purchase together with instructions how to activate your license.Once email has been received, click the Buy button again to bring up the Activate button.
Click Activate to fetch the full license.
If everything goes well, you will see the “Fetching full license - DONE!” message. Dismiss the message and you are ready to send and receive MMSs to and from anyone! Happy MMSing!!Note: If the fetching process failed, please try again later. If the problem persists, toggle your WiFi setting, i.e. if it was switched ON, then switch it OFF, or vice versa, and try to fetch the license again.

Usage

So, you have now downloaded, installed and properly configured SwirlyMMS and are therefore ready to start using the application. We will start by sending an MMS to ourselves. Actually, some Service Operators requires that you activate your MMS account by sending an MMS to yourself! Also, ensure that you have MMS on your service plan!

To send an MMS, press the Compose button.
To compose an MMS a recipient must be defined, either by selecting a contact from the Address Book (1) or by entering the name or number directly (2).

A short subject can be entered (3).

An MMS is composed of several media parts. SwirlyMMS is able to create an MMS with up to 10 parts. However, some Service Providers limits the number of parts and/or the size of a part and/or the size of the complete MMS. So start out small…

To compose an MMS with pictures taken from the Camera Roll or Photo Album, press the Photo Album button (4).

To snap a new picture with the iPhone, press the Camera button (5).

To write a textual message, press the Text button (6).

To select an existing file, like a video or audio clip, browse the filesystem by pressing the Finder-like button (7).

To record & attach an audio-clip press the microphone button (10).

To rearrange the media parts and/or delete parts from the MMS, press the Media Parts button (8).

Finally, when the MMS has been composed and is ready to be sent, hit the Send button (9).

Ok, lets compose an MMS and have it sent to ourselves.

Enter phone number (2) or select your contact in the Address Book (1) and a short subject title (3).

Then pick a photo from the Camera Roll (4) or from a Photo Album (4) or snap a picture with the camera (5).

Also, we add a text part to the MMS (6).

We have now composed an MMS with two media parts: one picture and one text part.

Let’s test to send it to ourselves by pushing the Send button (9)!

The MMS is being sent…
If everything goes well, you will hear a sound notification within a few seconds, which indicates that you have received an MMS notification.

Note: you do not need to have SwirlyMMS running to be able to receive MMS notifications since this is handled in the background. In addition to the sound alert, a visual alert shows the number of unread MMSs on the SwirlyMMS icon’s badge in the Home screen.

Navigate to the Inbox folder. There you should see the MMS notification, marked with a blue bullet indicator. Tap it to fetch the MMS!

Note: Some Service Operators, e.g. Telia Sweden, do not send out the Subject title in the MMS notification. Therefore, the space below the Senders name/phone number marked with the pink rectangle, may be empty.

The retrieval of an MMS is two-folded: first, an MMS notification is sent out to you as an SMS, informing that there is a new MMS ready to be fetched. Second, you fetch the MMS.

So, after you tapped the MMS notification, SwirlyMMS connects the Proxy and then begins fetching the MMS.

After the MMS has been fetched, its first media part is automatically shown in the MMS viewer.

If the MMS contains a subject it is shown in the top middle. The number of media parts is indicated with an Indicator (2). So, in this case the MMS contains three media parts and currently the second part is shown.

You can navigate back and forth between the media parts by sliding left & right over the screen (1).

You can double-tap a picture to view it in full screen.

You can save a media part to the file system by clicking the Save button (4). You can also save a picture to the camera roll by holding on the picture for 1 second.

You can Reply, Reply with SMS, and Forward an MMS by clicking the Reply/Forward button (5).

You can jump back to where you came from (3).

Additional Information

Did we miss to describe anything in this User’s Guide? Maybe we could have described something more clearly? You are welcome to send us feedback and help improve this User’s Guide!
To do so, feel free and drop a note to: [email protected]!

Other sources of information are the FAQ, which answers the most frequently asked questions and the community Forum where you can find lots of information, get support, discuss, voice your opinions and help others out.