MYO6 - a quick tutorial

(updated for version 1.2)

MYO6 is an evolution of MYO5, which was a complete rewrite of any previous MYO versions. Totally new animation, based on weather images being used in iOS7, no more iframes that call external html pages for the weather conditions, all done with Jquery/Javascript/CSS now.

MYO6 is a full weather theme for the lockscreen, but due to the fact that "too much stuff and not enough space on the screen", I have split it into 3 parts. This can only be done because it is a cydget. By pressing the home button you can cycle through your cydgets.

So, MYO6 are 3 cydgets, one for the current weather condition with time, date and location, the next cydget is a 5 day/night forecast cydget which shows the forecast in text format (in the language and the units -Celsius or Fahrenheit- you have choosen), the final cydget is a 36 hour by hour forecast, again in the language and units (temperature and time display) you have choosen.

This is the 5 day/night cydget from my iPhone 5S, language is British English and units are Celsius and km/h.

As there is more text the screen can be scrolled upwards to show the remaining forecast.

The 36 hour by hour forecast looks like this, again British English with Celsius and also 24 hour display selected.

I hope you have noticed that the background is the same in these 2 cydgets. That's because it is the background I selected for the current condition cydget and that looks like this, which is also the default setup for MYO6.

In this guide I will use screenshots from my iPhone 5S (iOS 8.4) and my iPad mini (iOS 8.3), which both run MYO6. I also use "older" screenshots from the MYO5 guide as it saves time to do them again.

One new feature is the GPS & weather info update. After you opened the Lockscreen you will see a text something like this "Updated: some time display". If you tap this text it will update to the latest weather info for your present GPS position. A successful update will show the Update text in yellow with newer time or not (in case you had already the latest weather info). If there are changes, like new location, different weather condition, temperature they will be automatically updated. This update feature will make a url call to WeatherUnderground, so it could take some time if you are not on WiFi or 3G/4G.

MYO6 version 1.2 update:

If you use the update touch feature, it will not only update the weather info on the lockscreen display, but also save a new xml file, which then can display the latest weather info in the forecast and hour by hour cydget.

The graphical setup has changed as well, with more features and enhanced layout with text comments for easier understanding what you have to do if you want to customise MYO6, which you should! There is a database already included as you do not need to include your free WeatherUnderground API any more, more to that later.

The database has grown as a result of the new features. It has 19 tables with 100 fields! That is a lot to set up if there is no supplied "default" database. This database will store YOUR setup of font choice (choice of 15 different fonts), font color, font size, text position based on top left corner and for the city name even an angle to display your current location vertical, horizontally or any angle between. That's for text alone, but it also keeps your choice of wallpapers and the text you want to hear when you use the touch-to-speech icons, again more later. Furthermore the database also keeps your selected iDevice screen size, your metric or imperial unit preference, Fahrenheit or Celsius display, 12 hour or 24 hour clock display, summertime/wintertime adjustment to calculate sun and moon rise and set times and position on your screen -rises left and sets right, and includes an On/Off switch for animation (weather with sun and moon).

The "default" database is set for iPhone 5/5S screen, but can be changed to work with iPhone 4/4S, 6 and 6+ as well as iPad Retina, iPad Mini Retina or iPad 2/Mini.

Everything you see can be changed. A new feature is the On-Screen "drag & drop". This means you can move items around where you want them. Before you needed to enter the graphical setup menu and change the position of each item ( top and left), well, you still can do this to fine tune the setup. For example the 4 touch to speech icons are very hard to set on the same distance from the top, but in the graphical setup menu I set them all to 680 pixels from the top, so now they are all aligned now.

I had to make an "edit mode" to use "drag & drop" in order to avoid accidental movement of any item when they get touched. So in order to enable "edit mode" you need to touch the top left corner of the screen, see green "Touch here". You will see when you are in "edit mode" as the screen will look something like this.

As you can see all items that can be moved are in red, apart from the "Save!" text, which marks the touch zone to save your new layout. After you finished moving items around you touch the "Save!" text and a confirmation window will pop up. Just a way to let you know that your new layout will be saved after tapping "OK". It looks like this.

After you tapped "OK" the screen will remain in "edit mode", just press the power button to close the lockscreen and press the home button to activate the Lockscreen again and you will see your new layout. If you need to do some fine tuning then unlock and open the graphical setup by taping this home screen icon on your home screen.

It looks like this on the home screen.

After taping that icon a new window will open showing you the graphical setup menu.

The menus with a "+" sign can be expanded to show more submenus like this.

OK, now lets run through each menu!

The General Setup menu has the elements that concern the general setup, like iDevice model, units, etc. After tapping it a new pop up window will show you something like this.

As you can see my selected iDevice is the iPad 2/Mini, as I have taken these screenshots with the iPad mini, the default database will say iPhone 5/5S, change this to whatever is your iDevice. Tap it and a selection menu will show, like this

This menu will look different on different iDevices, my iPhone 5S shows this.

All of the elements in each submenu have now a bit of text to explain what you have to do, also if you completely delete the existing entery a placeholder will show you a value you should enter as a guideline. PLEASE enter values in exactly the same way they have been entered, otherwise you could render the theme unresponsive. For example if it say enter the distance from the top in pixels, just enter the number and NOT the "px", as the value gets the "px" added in the theme.

IMPORTANT! After you did changes you have to tap the "Save" button, located on the top left next to the "Back" button in order to get your changes saved in the database. Again a pop up confirmation window will show, just tap "OK" and your changes have been saved. This is the same in ALL menus and submenus, apart from the wallpaper once, where you tap your choosen wallpaper and that will save it, with confirmation pop up window.

OK, lets say you use the "drag & drop" in "edit mode" and now you want to fine tune the positions. You would go to "Fonts & Positions" and then enter the submenu "Positions". This is a rather long submenu, you have to scroll to see it all.

As you can see each item has its own section with adjustable top and left position values.

Tap on the number and the iOS keyboard will come up and then edit the value.

Don't forget to save your changes!

The wallpaper selection is simple, just touch the wallpaper you want and it will be saved automatically after the confirmation pop up window and the "OK" tapping.

There are 24 wallpapers for day time and 12 wallpapers for night time. In case you set Day/Night ( General Setup menu) to Off, you can choose from the "Day/Night Off" submenu which has 11 wallpapers for selection plus a twelveth one, see red circle in next screenshot, which is just a transparent picture, which when selected will show the wallpaper you set in iOS Setting-> Wallpaper menu for the Lockscreen.

I am not going through every submenu as they all work in the same way. So lets take the temperature one as an example.

Really do not have to explain much. 2 input fields for font size and custom color and 2 drop down menus for preset font color and font style.

Preset font color do NOT have any alpha values (these determine the transparency). So if you want slightly transparent fonts then use the custom color.

Now to the new touch to speech features!

First you have a general voice submenu.

These need to adjusted to your iOS language. For example, if my iOS language is German then I need to change the last entery, Voice Language, to "de". I tried this with having my iOS language changed to German, but forgot to change this Voice Language from "en" to "de". After having changed all texts to be spoken into German, it sounded like a native German speaker with broken english aczent. LOL

All other values should be fine, but feel free to play with them.

This brings us to the next subject of the touch to speech feature. You can enter your own text in your own language in all 4 touch to speech menus. I will demonstrate this on the weather speech menu.

In the above example I would hear the following text, assuming my city name is London and I have selected metric units, the temerature is -1.2 degrees C and the weather description is "mostly cloudy".

"In my village London the temperature is minus one point 2 degrees Celsius and it is mostly cloudy"

Let's say I have a German setup with German text it would say.

"In meiner Stadt London ist die Temperatur minus eins Komma 2 Grad Celsius und es ist meist bew├Âlkt"

The iOS language will adapt to the local way of reading decimal numbers and the weather condition is automatically translated into German, or any other of the 83 available languages, that WeatherUnderground offers.

You will need a free WeatherUnderground API key, which you can get from here. Just choose "Anvil" and Developer plan for $0 USD. Your free API key will be on the same url after you registered and logged in. Really it is sooooo simple to get a brilliant weather service for free. Once you got your free API key you have to enter this, together with your prefered language in the WUG Setup menu which you can find in iOS Settings menu.

Your choosen language will affect in what language the weather info is recieved. No more translation javascript files for maybe 6 languages and that's it. Not any more.

Now the last thing for me to do is to thank Oldster for the touch to speech idea and original code, Junesiphone for the help regarding cycript coding and the WidgetWeather Team for the idea to have a theme load its data from a local file rather then to make url calls, which can take ages in areas with bad signal, e.g. GPRS or EDGE.

Be creative!

Rasputin007