ICumulus for iPhone

From Cumulus Wiki
Jump to navigationJump to search
Name: iCumulus
Type: HTML & Javascript
Author: David Jamieson
Contact: DAJ
Last update: 13 Sept 2009
Version: 1.2

iCumulus is a free third party addon for Cumulus which will present users with an iPhone friendly web interface detailing the key values of the weather station.

The Basics

  • Firstly, download the following file...(Link to Original Zip deleted, it was to David Jamieson's site that is no longer operative). It contains a few graphics, a style sheet, some Javascript and HTML

Alternative source

(Also available in French .. (deleted for same reason as previous link). "Thanks to Patrice Godard for the translation" and in Italian... "Thanks to Gianni Salvi for the translation - this zip is still available on that site")
  • Unzip the contents
  • Copy all the files to your web site -- to a subfolder. Call it iPhone, iCumulus, Mobile, or....your choice
  • Put a copy of index.html somewhere on the PC which is running Cumulus. I would suggest a subfolder just to be tidy.
  • In Cumulus click Configuration, Internet, Files. Using a blank entry complete it as follows.....


The left hand box is where you have put index.html on the PC running Cumulus. The right hand box is the folder and filename (index.html) where you uploaded your zip contents to on the webserver. You must tick the box for FTP and Process
  • Now, each time Cumulus updates your website files it will also process the index.html for iCumulus and upload this too, with the correct values.


At this point I suggest you test it by forcing a web update in Cumulus (File, Web Update). Once complete you should be able to directly visit this new section of your site using the full URL including the subfolder you used (example

If all looks well then congratulations, if not check you have completed all the above steps successfully.

If you do not have an iPhone you can get a feel for how the site will look by using an iPhone emulator. Example

Notes on the emulator:

  • although this will work on most web browsers, for the most realistic look and feel you should use the emulator within the Apple Safari web browser.
  • the emulator will NOT identify itself as an iPhone to the browser so your code to auto detect the iphone will NOT work. You will need to manually visit the section of your site as defined in document.location above.

Add a link to this new page from your website, or.....


Let's give your main site some intelligence. If a user visits your website using an iPhone we will automatically show them the new site....

Edit the index.html or index.htm of your main site using a text editor. Copy and paste the following code somewhere between the <HEAD> and </HEAD> tags...

<script type="text/javascript">
if (((navigator.userAgent.indexOf('iPhone') != -1) || (navigator.userAgent.indexOf('iPod') != -1))
&& (window.orientation == 0))
document.location = "";

Once pasted, edit the line document.location to the URL and the folder where you are storing your iCumulus files

The above code does a quick check and if the browser is an iPhone or iPod and the phone's orientation is normal it will redirect the user to the new site. If the phone is held in wide/landscape mode it will continue on with the full site

Feel free to edit the files to suit your own needs. I am also happy if you wish to edit the detail in the "About" section.

Homescreen Icon

In version 1.2 a homescreen icon was added (see example below); if a user bookmarks your iCumulus page onto their Homepage of the iPhone/iPod Touch it will display a simple icon rather than a default blank one.

To achieve this, create an icon that is 57x57 pixels and save it as a PNG file format in the same folder as your iCumulus files on the web server.

In the <head> section of the iCumulus page add the following line:

<link rel="apple-touch-icon" href="icumulus-icon.png"/>

changing the href to the name of your icon file.

Save your HTML page and remember to also update the one in the local PC folder which will be updated by Cumulus.

Sample Screen Shots

A few screen shots on the iphone


The iCumulus icon on the Home page of the iPhone