Getting Started

Before you start

In order to use Remote Messages, you will need to 'jailbreak' your device. This could either be quite simple or impossible, depending on how recent your hardware or iOS firmware is. To find out how to jailbreak your particular device, you can use this simple walkthrough.

If you are new to jailbreaking, you can find out more information about it on Wikipedia.

Acquiring and installing Remote Messages

Launch Cydia.

Tap 'Search', at the bottom right of the screen.

Type in 'Remote Messages' into the search bar, then tap through to the product page.

You should now be able to purchase Remote Messages.

Once purchased, you should see a button to install the software.

Once installed, Cydia will ask you to 'Respring' your device, tap the button to proceed.

Please note: We publish our software to the BigBoss repo exclusively, any other repos hosting Remote Messages cannot be trusted as we have no control over the contents of these packages. For the best experience and free updates, make sure to get it from BigBoss.

Configuring Remote Messages

Open Settings.

Scroll down and tap 'Remote Messages', it is usually situated close to the bottom.

Set the username and password you wish to log in with.

If you like, you can also set the port number you wish to use. (Ports range between 0 and 65535)

Slide the 'Enable' toggle to the 'On' state. Please allow the server a few seconds to start. If you have any trouble starting the server, a reliable solution is to simply reboot your device once.

Connecting over Wi-Fi

Make sure your device is connected to the same network as your computer.

On the 'Remote Messages' settings panel, note the IP address displayed at the top.

You should be able to ping this IP address from your computer. Read how to ping in Windows or Mac OS X.

Enter the IP into the address bar of your web browser, followed by : , then the port number. For example: http://192.168.0.5:333

At the prompt, authenticate using the username and password you set

Connecting over USB

Make sure you have iTunes installed.

We recommend a utility called itunnel-mux, builds for both Windows and Mac OS X are available.

Windows

Download and extract 'itunnel_mux_rev71.zip'. Right click 'itunnel_mux.exe' and click 'Create shortcut'. Right click the new shortcut, and click 'Properties'. In the 'Target' field at the top, add the following on to the end: " --lport 333 --iport 333" (Where 333 is the port number you set in the settings pane). Don't copy the quote marks, and make sure there is a space inbetween '.exe' and '--lport'. Running this shortcut will create a USB tunnel, and you can now access your device from the IP address '127.0.0.1'. In your web browser, visit http://127.0.0.1:333/ (333 being the port specified in settings).

Mac OS X

Download and extract 'itnl_rev8.zip'. Open Terminal on your Mac and navigate to the location you extracted the zip. How to use Terminal. When you are inside the same folder as 'itnl', execute the following command:

./itnl --lport 333 --iport 333

(Change 333 to match the port specified in the settings panel.) This command will create a USB tunnel, and you can now access your device from the IP address '127.0.0.1'. In your web browser, visit http://127.0.0.1:333/ (333 being the port specified in settings).



Alternatively, you can use i-FunBox to create a USB Tunnel.

General usage tips

Force Wi-Fi connections to remain active

If you find that you keep losing connection to Remote Messages, it is likely that your device is entering it's power saving mode in which it disconnects from Wi-Fi. To resolve this, either disable the 'Auto-lock' feature in Settings and keep your phone unlocked, or install a tweak that keeps disables this behavior such as KeepAwake or Insomnia.

Problems?

If you've run into an unexpected problem whilst following this guide, please first check to see if your problem has been resolved in the FAQs section. If not, then feel free to request assistance in the forum.

If you would like to help us develop Remote Messages, or if you've encountered a crash, navigate to the settings panel, slide the 'Send crash reports' toggle to 'On' and start/restart the service using the 'Enable' toggle. All crash reports are completely anonymous and contain no personal information.

Almost all first-time startup crashes are due to incompatibilities with other 3rd party tweaks, please try to isolate which tweak is causing the problem and let us know so we can look into fixing it for a future release.