Application:ModeSwitcher

Overview
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.

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.1. 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.

Testing Releases

The testing releases of Mode Switcher can be found in the WebOS-Internals Alpha or Beta feeds WebOS-Internals Testing Feed.

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. It is recommended that you install all of the patches in the patch set and not just those mentioned here. The patches mentioned here are those that matter for Mode Switcher usage.

Mode Switcher 2.x In Particular: In Particular:
 * Advanced System Menus Patch Set
 * Advanced System Menus - Framework (Required by all the system menus patches).
 * Advanced System Menus - Mode Menu (For easy manual control of modes through a system menu).
 * Advanced System Prefs Patch Set
 * Advanced System Prefs - Framework (For using the charger/battery triggers and contacts settings).
 * Advanced System Prefs - Email (For controlling emaiö settings).
 * Advanced System Prefs - Messaging (For controlling phone settings).
 * Advanced System Prefs - Phone (For controlling phone settings).
 * Advanced System Prefs - System (For using extra screen settings).
 * Advanced System Prefs - Calendar Prefs OR Uber Calendar patch (For controlling calendar settings).

Mode Switcher 1.x
 * Launch Mode Switcher on Luna Boot (Pre/Pre+ Only)
 * System Menu Mode Menu

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

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.

Configuration
 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 
 * Official Mode Switcher 1.x Manual

Tips & Usage Hints
 Mode Switcher 2.x  Blocking Modes

Block options is gone in MS 2.x since it can be now done in a better way. If you want to make sure that mode A can not activate when mode B is active then add mode change trigger into mode A with setting: Mode B, Not Active. This way mode A can not trigger when mode B is active.

Troubleshooting/FAQs
 Mode Switcher 1.x & 2.x  '''Q: There are times when the radios (Phone/Data (3G)/Bluetooth/Wi-Fi) don't change state (on/off) when opening, closing or switching modes. What is wrong?'''

A: There is a bug in webOS (version independent) where depending on the device/installation you may have varying success with the radios changing state. The frequency in which what radio settings get "stuck" or which radio settings don't get applied varies. A temporary solution is to do a full restart of the device which usually clears the "stuck" radio settings.

'''Note: This issue affects devices running the stock and modified kernels. It appears to affect any device running any current webOS versions (1.4.x/2.x)'''

 Mode Switcher 2.x  Q: I can't seem to find the settings for controlling the calendar, email and/or messaging nor the charger and/or battery triggers?

A: One of two things are not setup correctly.
 * 1) As mentioned in the Installation > Overview > Corresponding/Related Patches section, certain patches are needed to extend Mode Switcher functionality. Please see the links to the related wiki pages for help with installing those patches.
 * 2) If you have those patches installed, make sure you have the Advanced Features toggle enabled. (It can be found by going to the app menu and selecting Extensions.)

'''Q: When opening MS after installation, I get the Unknown Service Error notification. How do I fix this?'''

A: That message means that you most likely have a bad or incorrect installation of MS. First try re-installing and rebooting your device (twice to be sure). If you still get the same error then you need to complete the installation manually (this is a webOS bug/error in your webOS installation that can cause the installation of service to always fail). You can complete the installation by entering the following three commands in a terminal (either over ssh/novaterm connection or in terminal application in the phone).

cp -f /media/cryptofs/apps/usr/palm/services/org.webosinternals.modeswitcher.srv/org.webosinternals.modeswitcher.srv.json /var/palm/ls2/roles/pub/

cp -f /media/cryptofs/apps/usr/palm/services/org.webosinternals.modeswitcher.srv/org.webosinternals.modeswitcher.srv.service /var/palm/ls2/services/pub/

ls-control scan-services

'''Q: When changing modes, I get the notification, "Error: Mode change was aborted". What does that mean?'''

A: That message means that there is a loop within the MS app configurations and the mode changing was aborted.

Q: Where did the trigger blocking go?

A: The trigger blocking was removed in MS 2.0.9 in favor of using the Mode Change Trigger. You can achieve the same results and more by using the Mode Change Triggers.

 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.

Sending Problem Report
When you are sure that the problem you are experiencing is not a configuration error and you have preferably first asked about the problem in the thread then you can send a problem report. To do so you need to have lumberjack installed. The preferred method of sending the problem report is first to reboot your phone then make the "problem" happen and right after it has happened open the Mode Switcher app and send the problem report via App Menu - Help - App Menu - Send Problem Report.

Official Developer Project Page

 * Current and Legacy Projects

Official Forum
 Mode Switcher 2.x 
 * Official PreCentral Forum Thread

 Mode Switcher 1.x 
 * Official PreCentral Forum Thread

Modes Sharing

 * Mode Switcher Google Groups Group
 * Here you can delete your shared modes or view/comment modes posted by others.

Official Twitter Account

 * Follow Mode Switcher on Twitter: @modeswitcher

Bug Reporting

 * Official Bug Reporting Site
 * Registration on the site is required to submit bug reports.

Feature Requests

 * Official Feature Requests Site
 * Registration on the site is required to submit feature requests.