Application:ModeSwitcher Sandbox

Devs,Usergroup:Members

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.

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

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.

(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 In Particular:
 * Advanced System Menu - Mode Menu
 * Advanced System Prefs Patches
 * Advanced Systems Prefs - Framework (For using the charger/battery triggers).
 * Advanced Systems Prefs - Email and/or Messaging Prefs patches (For controlling email/messaging settings).
 * Advanced Systems 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.

Usage
 Mode Switcher 2.x  topics (no particular order at this point:


 * 1) Introduction
 * 2) activating


 * 1) Modes
 * 2) Exporting/Importing
 * 3) Mode Type (norm/mod)
 * 4) automation


 * 1) Settings
 * 2) setting types (need adv patches for some of them)
 * 3) notify
 * 4) add/remove settings


 * 1) Actions
 * 2) add apps
 * 3) add MS
 * 4) advanced MS control
 * 5) add service (srv)


 * 1) Triggers
 * 2) behavior
 * 3) groups
 * 4) trigger types (need adv patches for some of them)
 * 5) add/remove triggers


 * 1) Extensions
 * 2) advanced features
 * 3) setting/action/trigger extensions


 * 1) Help
 * 2) via app menu
 * 3) help bubbles for explanation of settings.


 * 1) Status
 * 2) main scene
 * 3) mode scene


 * 1) extras
 * 2) creating launcher shortcuts

Initial Launch
Upon the initial launch, Mode Switcher will start by automatically collecting the current settings of your device and then applies them to the "Default Mode" (wiki note: link to section describing DM). A dashboard notification message will appear when the collection of the current settings is complete.

Main View
Activated

This setting determines whether or not Mode Switcher is activated (i.e. running).

Popup Dialog

This setting determines the amount of time the mode popup dialog is displayed before the mode is applied. This setting only applies to modes that use the "By Selection" or "After Timer" Automation setting within each mode.

Custom Modes

This is a list of all of your custom modes that have been created. Tapping a mode in the list will open that mode's configuration. Option + Tap a mode to toggle the mode on/off. (wiki note: add link to section describing option+tap, etc...)

By tapping and holding a mode, you can arrange the order in the custom modes list. The order of the modes listed affects the order the modes are displayed for the Advanced System Menu - Mode Menu (add link) and the mode selection popup.

Add Custom Mode

Tap this button to being creating a mode.

Edit Default Mode

Tap this button to edit the Default Mode.

Modes
blah blah blah..

 Mode Switcher 1.x 
 * 1) creating
 * 2) deleting
 * 3) norm or mod
 * 4) automation

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

 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.

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

 Mode Switcher 1.x 
 * Official PreCentral Forum Thread

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.