Difference between revisions of "Application:ModeSwitcher"

From WebOS Internals
Jump to navigation Jump to search
m
m
Line 2: Line 2:
 
{{application
 
{{application
 
|name=Mode Switcher
 
|name=Mode Switcher
|version=Version: 1.0.9 <br />(November 10th, 2010)
+
|version=1.x/2.x
 
|type=webOS
 
|type=webOS
 
|tag=Utilities
 
|tag=Utilities
|screenshot=modeswitcher001.png
+
|screenshot=modeswitcher_2x.png
 
|description=<div style='position: absolute; bottom: 0; right: 0; padding-right: 8px; padding-bottom: 16px'>{{SconixDonation}}</div>
 
|description=<div style='position: absolute; bottom: 0; right: 0; padding-right: 8px; padding-bottom: 16px'>{{SconixDonation}}</div>
 
}}
 
}}
 
</div>
 
</div>
  
 +
== Overview ==
 +
[[image:Icon_Mode-Switcher.png|frameless|left]]
 +
Mode Switcher is a webOS application that brings profile support to your device in the form of "modes". These "modes" can nearly control every available setting in webOS and can be triggered (manually or automatically) by a number of different methods or "triggers" that in turn change settings on your device based on the configuration of the modes you created. Mode Switcher is very powerful and feature rich. You can make its use as simple or complex as you would need.
 +
<br /><br />
  
== What is Mode Switcher? ==
+
Here is a list of the controllable settings and available triggers.
 
 
{{icon|Icon_Mode-Switcher.png|float:right;}}
 
Mode Switcher brings profile support to webOS in the form of "modes" that can control nearly every available setting on the Palm Pre/Pre+ and Pixi/Pixi+.
 
 
<br />
 
<br />
Currently, MS can control:
+
''(Note: Some settings are only available and controllable when using Mode Switcher 2.x and the Advanced System Prefs patches for webOS 2.x)''
 +
<br /><br />
  
<blockquote>
+
{{article-two-columns
* Wallpaper
+
|width1=50%;
* IM status
+
|column1=
* All Volume Controls
+
'''<span style="color:#8a0002"><center>Controllable Settings</center></span>'''
* All Ringtones
+
* The wallpaper
* Display (brightness, timeout, LED/banner notifications)
+
* The status for instant messaging accounts
* Touchstone Screen On/Off
+
* All three volume levels (Ringtone, System, Media)
* All Radios (Wifi/Bluetooth/GPS/Data/Phone)
+
* Ringtones and system sounds and alerts
* Open/Close Applications
+
* The display (brightness, screen timeout, LED/banner notifications and screen on/off when on touchstone)
* Network Type
+
* All radios (Wi-Fi/Bluetooth/GPS/Data/Phone)
* Roaming (Forced, Automatic)
+
* Open and closing of applications
* E-Mail
+
* Network type
</blockquote>
+
* Roaming setting (forced and automatic)
 
+
* E-mail and messaging notifications and settings
These modes can be activated manually, or triggered automatically by a number of different methods:
+
* Security settings
 
+
* Apps that support launch parameters (like Govnah)
<blockquote>
+
|column2=
 +
'''<span style="color:#8a0002"><center>Available Triggers</center></span>'''
 
* Time of Day
 
* Time of Day
 
* Charger (touchstone, USB or wall charger. Can be set separately)
 
* Charger (touchstone, USB or wall charger. Can be set separately)
* Touchstone Orientation
+
* Touchstone orientation
* GPS Location
+
* GPS location
* Battery Level
+
* Battery level
* Bluetooth (by Profile or Device Name)
+
* Bluetooth (by profile or device name)
* Application Focus
+
* Application focus
* Calendar Event
+
* Calendar events
* Headset Connection
+
* Headset connection
 
* Wifi SSID
 
* Wifi SSID
* Silent Switch
+
* Silent switch
 
* Display state
 
* Display state
 +
}}
 +
 +
 +
==== Versions ====
 +
<blockquote>
 +
There are two versions of Mode Switcher available. What version you use is dependent on what version of webOS is running on your device. Mode Switcher 1.x is available for webOS 1.4.x and Mode Switcher 2.x for webOS 2.x.
 +
<br /><br />
 +
Mode Switcher 2 was completely rewritten into a Javascript service instead of being an application that runs in the background. It supports controlling even more system settings than MS 1.x with the help of the Advanced System Prefs patches for webOS 2.x. Mode Switcher 2 is faster, better and all around more awesome than before!
 +
<br /><br />
 +
Differences in the version's features, settings and capabilities will be noted throughout the rest of the wiki.
 
</blockquote>
 
</blockquote>
  
  
== How to Install Mode Switcher ==
+
== Installation ==
 +
 
 +
The following information will help you install Mode Switcher.
 +
 
  
 
==== Overview ====
 
==== Overview ====
 
<blockquote>
 
<blockquote>
'''Stable Releases'''
+
<span style="color:#8a0002">'''Stable Releases'''</span>
 
<br />
 
<br />
 
The stable releases of Mode Switcher can be found in the WebOS-Internals Feed and are recommended for general public use.
 
The stable releases of Mode Switcher can be found in the WebOS-Internals Feed and are recommended for general public use.
 +
<br />
 +
''(Note: Mode Switcher 2 is not yet in the public feeds.)''
 
<br /><br />
 
<br /><br />
  
'''Testing Releases'''
+
<span style="color:#8a0002">'''Testing Releases'''</span>
 
<br />
 
<br />
 
The testing releases of Mode Switcher can be found in the [http://www.webos-internals.org/wiki/Testing_Feeds WebOS-Internals Testing Feed].
 
The testing releases of Mode Switcher can be found in the [http://www.webos-internals.org/wiki/Testing_Feeds WebOS-Internals Testing Feed].
Line 67: Line 85:
 
<br /><br />
 
<br /><br />
  
'''Corresponding/Related Patches'''
+
<span style="color:#8a0002">'''Corresponding/Related Patches'''</span>
 
<br />
 
<br />
There are two patches that extend Mode Switcher's functionality.
+
There are a number of patches that extend Mode Switcher's functionality. While they are not required for Mode Switcher to function; they are recommended as they add much more functionality to your device and controlling of the functions with Mode Switcher. These patches can be found in the WebOS-Internals Patch Feed. Please follow the links for installation and other general information.
 +
 
 
<blockquote>
 
<blockquote>
 +
<u>'''Mode Switcher 2.x'''</u>
 +
* [http://www.webos-internals.org/wiki/Patch:AdvancedSystemMenus Advanced System Menu - Mode Menu]
 +
* [http://www.webos-internals.org/wiki/Patch:AdvancedSystemPrefs Advanced System Prefs Patches]
 +
 +
<br /><br />
 +
<u>'''Mode Switcher 1.x'''</u>
 
* Launch Mode Switcher on Luna Boot ''(Pre/Pre+ Only)''
 
* Launch Mode Switcher on Luna Boot ''(Pre/Pre+ Only)''
* System Menu Mode Menu
+
* [http://www.webos-internals.org/wiki/Patch:SystemMenus System Menu Mode Menu]
 +
</blockquote>
 
</blockquote>
 
</blockquote>
  
These patches are found in the WebOS-Internals Patch Feed. Neither patch is required for Mode Switcher to function. For more information on how these patches extend the functionality of Mode Switcher, please see the [[#Usage_Manual|Mode Switcher Manual]].
 
<br /><br />
 
  
The following steps will guide you through installing Mode Switcher and related patches with [http://www.webos-internals.org/wiki/Application:Preware Preware].
+
==== Method ====
<br />
 
''(These steps assume your Preware Preferences Main Scene option is set to "No".)''
 
</blockquote>
 
  
 +
The following method can be used to install Mode Switcher.
  
==== Installation via Preware ====
 
  
===== Stable Releases =====
 
 
<blockquote>
 
<blockquote>
 +
===== [http://www.webos-internals.org/wiki/Application:Preware Preware] =====
 +
 
# Open Preware
 
# Open Preware
# Tap Available Packages
+
# Start typing “Mode Switcher” (no quotes)
# Tap Application > System Utilities > Mode Switcher
+
# Tap the Mode Switcher from the list
 
# Tap the Install button
 
# Tap the Install button
 
# Tap the Ok button to restart Luna
 
# Tap the Ok button to restart Luna
Line 96: Line 118:
 
'''Or'''
 
'''Or'''
  
# At the main Preware screen, start a search for Mode Switcher by typing in "mode switcher" (without the parenthesis), then press enter.
+
# Open Preware
# Tap Mode Switcher from the list
+
# Tap Available Packages
 +
# Tap Application > System Utilities > Mode Switcher
 
# Tap the Install button
 
# Tap the Install button
 
# Tap the Ok button to restart Luna
 
# Tap the Ok button to restart Luna
Line 103: Line 126:
  
  
===== Testing Releases =====
+
==== Updating ====
''Adding the WebOS-Internals Testing Feeds''
+
 
 
<blockquote>
 
<blockquote>
# Open Preware
+
===== <span style="color:#8a0002">webOS OTA Updates</span> =====
# From the App Menu, tap Manage Feeds
+
Since Mode Switcher is an app, it is OTA (over-the-air) update safe. However, the patches that correspond/extend Mode Switchers functionality like the Advanced System Prefs patches and the Mode Menu patches are not OTA (over-the-air) update safe. When there is an OTA update to a newer version of webOS from your carrier, you must remove these patches before updating. If you do not remove them prior to running the OTA update, you most likely will need to run the Emergency Patch Recovery tool from Preware.
# Scroll past the Installed section until you see the New Feed section
+
 
# In the Name field, TYPE ''*what ever name you want to call the feed*'' (ie. webos-internals-testing)
+
 
# In the URL field, TYPE <nowiki>http://ipkg.preware.org/feeds/webos-internals/testing/all</nowiki>  
+
===== <span style="color:#8a0002">Application and Patch Updates</span> =====
# The "IS COMPRESSED" option should be set to YES
+
Updated versions of Mode Switcher and the related patches can be applied via Preware.
# Tap the Add Feed button
 
# Tap Ok at the Custom Feed alert message
 
# Gesture swipe back to go back to the main Preware screen
 
# Tap the Do It Now button at the alert message to update the package list
 
 
</blockquote>
 
</blockquote>
  
After adding the testing feed, follow the same steps under the stable releases section for installing.
 
  
 
+
== Troubleshooting/FAQs ==
===== Corresponding/Related Patches =====
 
''Launch Mode Switcher on Luna Boot patch (Pre/Pre+ Only)''
 
 
<blockquote>
 
<blockquote>
# Open Preware
+
<u>'''<span style="color:#8a0002">Mode Switcher 2.x</span>'''</u>
# Tap Available Packages
 
# Tap Patch > Misc > Launch Mode Switcher on Luna Boot
 
# Tap the Install button
 
# Tap the Ok button to restart Luna
 
</blockquote>
 
<br />
 
 
 
''System Menu Mode Menu patch''
 
 
<blockquote>
 
<blockquote>
# Open Preware
 
# Tap Available Packages
 
# Tap Patch > Top Bar > System Menu Mode Menu
 
# Tap the Install button
 
# Tap the Install / Update It button (This will install the "System Menu Mode Menu" patch and the dependent/required "System Menu Initial Framework" patch.)
 
# Tap the Ok button to restart Luna
 
 
'''Or'''
 
 
# At the main Preware screen, start a search for each patch by name, then press enter.
 
# Tap the corresponding patch from the list
 
# Tap the Install button
 
# Tap the Ok button to restart Luna
 
 
</blockquote>
 
</blockquote>
  
  
== Troubleshooting (FAQ) ==
+
<u>'''<span style="color:#8a0002">Mode Switcher 1.x</span>'''</u>
 
 
 
<blockquote>
 
<blockquote>
 
'''Q: I’m getting this error when I try to install Mode Switcher: “1 of 1 hunk failed -- saving rejects to file etc/palm/luna.conf.rej”'''
 
'''Q: I’m getting this error when I try to install Mode Switcher: “1 of 1 hunk failed -- saving rejects to file etc/palm/luna.conf.rej”'''
 
<br />
 
<br />
 
A: The patch “Launch Brightness Unlinked on Luna Boot” conflicts with the "Launch Mode Switcher on Luna Boot" patch and must be removed.
 
A: The patch “Launch Brightness Unlinked on Luna Boot” conflicts with the "Launch Mode Switcher on Luna Boot" patch and must be removed.
 
+
<br /><br />
<br/ ><br/>
 
 
 
 
'''Q: I installed Mode Switcher, but when I tap the launcher icon nothing happens.'''
 
'''Q: I installed Mode Switcher, but when I tap the launcher icon nothing happens.'''
 
<br />
 
<br />
 
A: You must perform a Luna Restart after installing/updating Mode Switcher.
 
A: You must perform a Luna Restart after installing/updating Mode Switcher.
 
+
<br /><br />
<br/ ><br/>
 
 
 
 
'''Q: Can I close / get rid of the Mode Switcher dashboard icon?'''
 
'''Q: Can I close / get rid of the Mode Switcher dashboard icon?'''
 
<br />
 
<br />
 
A: If you are on a Pixi/Pixi+, then no, the dashboard scene needs to be active for Mode Switcher to function. For the Pre/Pre+, install the Launch Mode Switcher on Luna Boot patch to get rid of the dashboard.
 
A: If you are on a Pixi/Pixi+, then no, the dashboard scene needs to be active for Mode Switcher to function. For the Pre/Pre+, install the Launch Mode Switcher on Luna Boot patch to get rid of the dashboard.
 +
<br /><br />
 +
'''Q: Can I manually or use [[Application:SaveRestore|Save/Restore]] to import my Mode Switcher 1.x modes into Mode Switcher 2.x?'''
 +
<br />
 +
A: Unfortunately, no. The differences between version 1.x and 2.x are to great to make this possible.
 +
</blockquote>
 
</blockquote>
 
</blockquote>
  
  
== Resources ==
+
== Usage ==
 
+
<blockquote>
===== Supporting Development =====
+
<u>'''<span style="color:#8a0002">Mode Switcher 2.x</span>'''</u>
 
<blockquote>
 
<blockquote>
{{SconixDonation}}
+
A new usage section is being created for Mode Switcher 2.x.
 
<br />
 
<br />
 +
Sections will be added as they are completed.
 
</blockquote>
 
</blockquote>
  
==== Official Forum ====
 
<blockquote>
 
* [http://forums.precentral.net/enlightened-linux-solutions/260212-ms-mode-switcher-1-x.html Official PreCentral Forum Thread]
 
</blockquote>
 
  
==== Official Usage Manual ====
+
<u>'''<span style="color:#8a0002">Mode Switcher 1.x</span>'''</u>
 
<blockquote>
 
<blockquote>
*[http://modeswitcher.jupiterns.org Mode Switcher Manual (current to version 1.0.7)]
+
* [http://modeswitcher.jupiterns.org Official Mode Switcher 1.x Manual]
 
</blockquote>
 
</blockquote>
 
==== Official Twitter Account ====
 
<blockquote>
 
* Follow Mode Switcher on Twitter: [http://twitter.com/modeswitcher @modeswitcher]
 
 
</blockquote>
 
</blockquote>
  
  
== Status ==
+
== Resources ==
  
==== Current Stable Release ====
+
===== Support Development =====
 
<blockquote>
 
<blockquote>
'''1.0.9 <span style="color:#ff0000">'''</span> - (''Released November 10th, 2010'')
+
{{SconixDonation}}
 +
<br />
 
</blockquote>
 
</blockquote>
  
===== Changelog =====
+
===== Official Forum =====
 
<blockquote>
 
<blockquote>
* Small change to display trigger
+
<u>'''<span style="color:#8a0002">Mode Switcher 2.x</span>'''</u>
* removed experimental code
+
* [http://forums.precentral.net/enlightened-linux-solutions/279166-ms-mode-switcher-2-x.html Official PreCentral Forum Thread]
* fixed no match calendar trigger functionality
+
<br />
 +
<u>'''<span style="color:#8a0002">Mode Switcher 1.x</span>'''</u>
 +
* [http://forums.precentral.net/enlightened-linux-solutions/260212-ms-mode-switcher-1-x.html Official PreCentral Forum Thread]
 
</blockquote>
 
</blockquote>
  
===== Known Issues =====
+
===== Official Twitter Account =====
 
<blockquote>
 
<blockquote>
* See also next release info below since it should fix all known issues
+
* Follow Mode Switcher on Twitter: [http://twitter.com/modeswitcher @modeswitcher]
* Phone call and other system tasks may interrupt or prevent mode change
 
* Launcher popup is not updated if another trigger happens while visible
 
* Requesting mode change while processing previous change might cause unexpected behavior
 
 
</blockquote>
 
</blockquote>
  
==== Next Release ====
+
===== Bug Reporting =====
 
<blockquote>
 
<blockquote>
'''1.1.0'''
+
* [http://redmine.webos-internals.org/projects/modeswitcher Official Bug Reporting Site]
* Day of event option for calendar trigger
+
:''Registration on the site is required to submit bug reports.''
* Fix interval trigger also work on manual mode starts
 
* Maybe add a signal trigger
 
* Add always on for screen timeout
 
* Timeout configuration for security settings
 
* Filemanager extension for moving files/directories
 
 
</blockquote>
 
</blockquote>
  
==== Future Releases ====
+
===== Feature Requests =====
 
<blockquote>
 
<blockquote>
* Add extension for filemanager service for renaming dirs
+
* [http://redmine.webos-internals.org/projects/modeswitcher Official Feature Requests Site]
* Individual mode triggers locking
+
:''Registration on the site is required to submit feature requests.''
* Per account ringtone settings
 
* Add per account IM configuration when WebOS/messaging plugin patches allow this
 
* Add special triggers like: Im status trigger / signal strength trigger / etc.
 
* Script for save/restore application
 
 
</blockquote>
 
</blockquote>
  
  
==== Current Testing Release ====
+
== Status ==
 +
 
 +
{{article-two-columns
 +
|width1=50%
 +
|column1=
 +
'''<span style="color:#8a0002"><center>'''Mode Switcher 2.x'''</center></span>'''
 +
<br />
 +
 
 +
:'''Changelog'''
 
<blockquote>
 
<blockquote>
'''No Testing Release currently available'''
+
:'''2.0.0 - Current Release''' - (''April 13th, 2011'')
 +
:* Initial Testing Feed Release
 
</blockquote>
 
</blockquote>
  
===== Changelog =====
+
|column2=
 +
'''<span style="color:#8a0002"><center>'''Mode Switcher 1.x'''</center></span>'''
 +
<br />
 +
 
 +
:'''Changelog'''
 
<blockquote>
 
<blockquote>
 +
:'''1.0.9 - Current Release''' - (''Nov. 10th, 2010'')
 +
:* Small change to display trigger
 +
:* Removed experimental code
 +
:* Fixed no match calendar trigger functionality
 
</blockquote>
 
</blockquote>
 +
}}

Revision as of 21:27, 13 April 2011

Modeswitcher 2x.png

Overview

Icon Mode-Switcher.png

Mode Switcher is a webOS application that brings profile support to your device in the form of "modes". These "modes" can nearly control every available setting in webOS and can be triggered (manually or automatically) by a number of different methods or "triggers" that in turn change settings on your device based on the configuration of the modes you created. Mode Switcher is very powerful and feature rich. You can make its use as simple or complex as you would need.

Here is a list of the controllable settings and available triggers.
(Note: Some settings are only available and controllable when using Mode Switcher 2.x and the Advanced System Prefs patches for webOS 2.x)

Controllable Settings
  • The wallpaper
  • The status for instant messaging accounts
  • All three volume levels (Ringtone, System, Media)
  • Ringtones and system sounds and alerts
  • The display (brightness, screen timeout, LED/banner notifications and screen on/off when on touchstone)
  • All radios (Wi-Fi/Bluetooth/GPS/Data/Phone)
  • Open and closing of applications
  • Network type
  • Roaming setting (forced and automatic)
  • E-mail and messaging notifications and settings
  • Security settings
  • Apps that support launch parameters (like Govnah)
Available Triggers
  • Time of Day
  • Charger (touchstone, USB or wall charger. Can be set separately)
  • Touchstone orientation
  • GPS location
  • Battery level
  • Bluetooth (by profile or device name)
  • Application focus
  • Calendar events
  • Headset connection
  • Wifi SSID
  • Silent switch
  • Display state


Versions

There are two versions of Mode Switcher available. What version you use is dependent on what version of webOS is running on your device. Mode Switcher 1.x is available for webOS 1.4.x and Mode Switcher 2.x for webOS 2.x.

Mode Switcher 2 was completely rewritten into a Javascript service instead of being an application that runs in the background. It supports controlling even more system settings than MS 1.x with the help of the Advanced System Prefs patches for webOS 2.x. Mode Switcher 2 is faster, better and all around more awesome than before!

Differences in the version's features, settings and capabilities will be noted throughout the rest of the wiki.


Installation

The following information will help you install Mode Switcher.


Overview

Stable Releases
The stable releases of Mode Switcher can be found in the WebOS-Internals Feed and are recommended for general public use.
(Note: Mode Switcher 2 is not yet in the public feeds.)

Testing Releases
The testing releases of Mode Switcher can be found in the WebOS-Internals Testing Feed.

Due to the testing releases of Mode Switcher being in the WebOS-Internals Testing Feed, please take a few mintues to read over, understand and agree to the WebOS-Internals Testing Feed Rules before continuing. The testing releases of Mode Switcher are recommended only for those that wish to test out the latest and greatest features before they are implemented into the stable releases.

Corresponding/Related Patches
There are a number of patches that extend Mode Switcher's functionality. While they are not required for Mode Switcher to function; they are recommended as they add much more functionality to your device and controlling of the functions with Mode Switcher. These patches can be found in the WebOS-Internals Patch Feed. Please follow the links for installation and other general information.

Mode Switcher 2.x



Mode Switcher 1.x


Method

The following method can be used to install Mode Switcher.


Preware
  1. Open Preware
  2. Start typing “Mode Switcher” (no quotes)
  3. Tap the Mode Switcher from the list
  4. Tap the Install button
  5. Tap the Ok button to restart Luna

Or

  1. Open Preware
  2. Tap Available Packages
  3. Tap Application > System Utilities > Mode Switcher
  4. Tap the Install button
  5. Tap the Ok button to restart Luna


Updating

webOS OTA Updates

Since Mode Switcher is an app, it is OTA (over-the-air) update safe. However, the patches that correspond/extend Mode Switchers functionality like the Advanced System Prefs patches and the Mode Menu patches are not OTA (over-the-air) update safe. When there is an OTA update to a newer version of webOS from your carrier, you must remove these patches before updating. If you do not remove them prior to running the OTA update, you most likely will need to run the Emergency Patch Recovery tool from Preware.


Application and Patch Updates

Updated versions of Mode Switcher and the related patches can be applied via Preware.


Troubleshooting/FAQs

Mode Switcher 2.x


Mode Switcher 1.x

Q: I’m getting this error when I try to install Mode Switcher: “1 of 1 hunk failed -- saving rejects to file etc/palm/luna.conf.rej”
A: The patch “Launch Brightness Unlinked on Luna Boot” conflicts with the "Launch Mode Switcher on Luna Boot" patch and must be removed.

Q: I installed Mode Switcher, but when I tap the launcher icon nothing happens.
A: You must perform a Luna Restart after installing/updating Mode Switcher.

Q: Can I close / get rid of the Mode Switcher dashboard icon?
A: If you are on a Pixi/Pixi+, then no, the dashboard scene needs to be active for Mode Switcher to function. For the Pre/Pre+, install the Launch Mode Switcher on Luna Boot patch to get rid of the dashboard.

Q: Can I manually or use Save/Restore to import my Mode Switcher 1.x modes into Mode Switcher 2.x?
A: Unfortunately, no. The differences between version 1.x and 2.x are to great to make this possible.


Usage

Mode Switcher 2.x

A new usage section is being created for Mode Switcher 2.x.
Sections will be added as they are completed.


Mode Switcher 1.x


Resources

Support Development

Btn donateCC LG.gif

Official Forum

Mode Switcher 2.x


Mode Switcher 1.x

Official Twitter Account
Bug Reporting
Registration on the site is required to submit bug reports.
Feature Requests
Registration on the site is required to submit feature requests.


Status

Mode Switcher 2.x


Changelog
2.0.0 - Current Release - (April 13th, 2011)
  • Initial Testing Feed Release
Mode Switcher 1.x


Changelog
1.0.9 - Current Release - (Nov. 10th, 2010)
  • Small change to display trigger
  • Removed experimental code
  • Fixed no match calendar trigger functionality