Add iOS remote section

manual/source/android-remote.rst

@@ -1,7 +1,7 @@
-.. _android:
+.. _android-remote:
 
-Android App
+Android Remote
-===========
+==============
 
 Installation
 ------------

manual/source/configure.rst

@@ -210,8 +210,7 @@ time when saving your service file.
   name when saving the file.
 
 **Note:** If the date and time format does not suit your needs and you are 
-technically inclined, there is more information at 
+technically inclined, there is more information at `Python.org`_.
-`Python.org <http://docs.python.org/library/datetime.html#strftime-strptime-behavior>`_.
 
 Data Location
 ^^^^^^^^^^^^^
@@ -316,9 +315,9 @@ players control the following:
    This uses the well-known VLC media player to show videos. VLC has a
    reputation of being able to handle almost any video or audio format.
 
-**Note:** You must have `VLC <http://www.videolan.org/vlc/>`_ installed for the 
+**Note:** You must have `VLC`_ installed for the VLC option to be available. On
-VLC option to be available. On Windows you must install the 32-bit version of VLC.
+Windows you must install the 32-bit version of VLC. On Mac OS X you must install
-On Mac OS X you must install the 64-bit version of VLC.
+the 64-bit version of VLC.
 
 Player Order
 ^^^^^^^^^^^^
@@ -740,12 +739,13 @@ Then generate your keys and certificate::
 
 The crt and key files need to then be placed in {data}/remotes directory.
 
-Android App
+Android and iOS Remotes
-^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^
 
-You can quickly find and download the OpenLP Android application using your 
+You can quickly find and download the OpenLP Android or iOS remote apps using your 
-Android device barcode scanner or by clicking on the :guilabel:`download` link. 
+barcode scanner or by clicking on the :guilabel:`download` link. See the sections on
-More details on the OpenLP Android application can be found at :ref:`android`.
+the :ref:`android-remote` and ref:`ios-remote` for more details on how to install
+and use them.
 
 Finding your IP address
 ^^^^^^^^^^^^^^^^^^^^^^^
@@ -796,3 +796,6 @@ port number or one or both computers are not connected to the network.
 .. |BUTTONS_OPEN| image:: pics/buttons_open.png
 
 .. |BUTTONS_REVERT| image:: pics/button_rerun.png
+
+.. _Python.org: http://docs.python.org/library/datetime.html#strftime-strptime-behavior
+.. _VLC: http://www.videolan.org/vlc/

manual/source/index.rst

@@ -40,7 +40,8 @@ Reference Manual
    alert
    web_remote
    stage_view
-   android
+   android-remote
+   ios-remote
    glossary
 
 Questions and Troubleshooting

manual/source/ios-remote.rst

@@ -0,0 +1,143 @@
+.. _ios-remote:
+
+iOS Remote
+==========
+
+OpenLP gives you the ability to control your service from an iOS-based device. The
+following tutorial will describe how to install and use the application.
+
+Installation
+------------
+
+Open the *Apple App Store* and search for ``OpenLP``. You should find the
+`OpenLP Remote`_ app. Install this app.
+
+.. image:: pics/ios-app-icon.png
+   :align: center
+
+When you start the app, you will initially see the launch screen, followed by the
+service screen once the app has loaded.
+
+.. image:: pics/ios-service-screen.png
+   :width: 25%
+   :align: center
+
+Settings
+--------
+
+After the installation is complete and you open the OpenLP Remote app you will need to
+configure your settings. Open the settings by touching the settings icon in the top
+left corner.
+
+.. image:: pics/ios-settings-screen.png
+   :width: 25%
+   :align: center
+
+Server Details
+^^^^^^^^^^^^^^
+
+You will need to configure the server settings you will use with your device. You can find these instructions and
+settings in the OpenLP desktop application under :ref:`remote_tab`.
+
+**Note:** To use the OpenLP Remote you will need to be on the same network as the main computer.
+
+**Server IP:**
+    Enter the :guilabel:`Server on IP address` found in :ref:`remote_tab`.
+
+**Server port:**
+    Enter the :guilabel:`Port number` found in :ref:`remote_tab` and enter it in the box. By default this is ``4316``.
+
+**Use HTTPS:**
+    This specifies if HTTPS should be used. **Note:** To use HTTPS you must
+    setup OpenLP to be secure, see :ref:`secure_server`.
+
+Authentication
+^^^^^^^^^^^^^^
+
+**Needs auth:**
+    Tap this switch to enable authentication. Authentication needs to be set up in
+    :ref:`user_auth`.
+
+**User ID:**
+    Here you can enter a username used for accessing OpenLP remotely. This
+    must be the same as set in :ref:`user_auth`.
+
+**Password:**
+    Here you can enter a password used for accessing OpenLP remotely. This
+    must be the same as set in :ref:`user_auth`.
+
+Scrolling
+^^^^^^^^^
+
+**Use precise slide scrolling:**
+    By default, iOS's scrolling effects can make scrolling up and down the slides
+    difficult. When tapping this switch you can turn iOS's scrolling effects on and off,
+    which may result in more precise scrolling.
+
+
+Using the iOS Remote
+--------------------
+
+After you have completed the setup you are now ready to use the app. At the bottom of
+the app you can see the *Service*, *Slides*, *Alert* and *Search* tabs.
+
+Service
+^^^^^^^
+
+Selecting :guilabel:`Service` will take you to the Service tab. Selecting an item with
+a in the service manager will immediately take it live on the projection screen and you
+will stay on the service screen on your device. You can use the arrows buttons shown on
+the bottom left and right to move to the next slide inside the item. 
+
+.. image:: pics/ios-service-screen.png
+   :width: 25%
+   :align: center
+
+Along the bottom of the Service tab you can see buttons that say, *Blank*, *Theme*,
+*Desktop* and *Show*. These buttons will blank the display, set it to the current theme,
+show the main computer's desktop, or show the currently live item, respectively.
+
+Slides
+^^^^^^
+
+Selecting :guilabel:`Slides` will take you to the Slides tab. This displays what ever is
+live at the moment. You can use the arrow buttons shown on the top right to move to the
+next slide inside the item. 
+
+.. image:: pics/ios-slides-screen.png
+   :width: 25%
+   :align: center
+
+Along the bottom of the Slides tab you can also see the *Blank*, *Theme*, *Desktop* and
+*Show* buttons.
+
+Alerts
+^^^^^^
+
+To send an alert to the display, touch the *Alerts* tab at the bottom of the screen.
+Type in your alert text in the text box and press the *show* button at the bottom to
+show your alert in OpenLP. The alert will be displayed as you have it configured in
+:ref:`configure_alerts`.
+
+.. image:: pics/ios-alerts-screen.png
+   :width: 25%
+   :align: center
+
+Search
+^^^^^^
+
+If you want to search for an item that is not currently in your service, press on the
+*Search* tab at the bottom of the screen. Type your search term in the search box at the top of the tab, and then select which type of item you want to search for.
+
+.. image:: pics/ios-search-screen.png
+   :width: 25%
+   :align: center
+
+Once OpenLP has finished searching for you, the results of your search will be visible
+in the search screen. Touch a search result to add it to your service.
+
+.. image:: pics/ios-results-screen.png
+   :width: 25%
+   :align: center
+
+.. _OpenLP Remote: https://itunes.apple.com/us/app/openlp-remote/id1096218725?mt=8