How Do I

TABLE OF CONTENTS

Also available at: www.jbhengineering.com/keydirector/howdoi.html/

(Click a question to reveal the answer - JavaScript must be enabled)

Start KeyDirector [58]

1. Find KeyDirector in the Applications tab.
2. Select the KeyDirector program icon. KeyDirector displays the main screen.
NOTE: On first use, KeyDirector performs the following actions in sequence:

• Displays the End User Licensing Agreement (EULA).
• Builds the Application list.
• Checks for existing backup data. If found, KeyDirector prompts you to restore the last backup.
• Displays the Welcome page

Subsequent startups bypass all of the above unless the EULA was not accepted or the Application list needs to be re-built.

 

View the builtin commands [59]

Builtins are preconfigured commands that help you do useful things with KeyDirector and your Android device. To view all of the builtin commands:

1. Navigate to the KeyDirector main screen.
2. Press the MENU button.
3. Touch VIEW Builtins.

Use a builtin command [60]

Builtins are preconfigured commands that help you do useful things with KeyDirector and your Android device. To use a builtin command:

1. List all the builtin commands:

a. Navigate to the KeyDirector main screen.
b. Press the MENU button > VIEW Builtins.

2. Touch a command (for example "app") to run the builtin.

For more information about builtin commands, see Launch any builtin command.

Create a launcher [61]

Launchers are short commands that you create yourself. Launchers can start applications, call phone numbers, open Web URLs, send text messages, and perform many other tasks.

1. Navigate to the KeyDirector main screen.
2. MENU > ADD Launcher.
3. In the Name field, enter a launcher name.
4. Touch a button to define the launcher data and type:

• Application
• Phone or Email
• Text Message
• URL
• Builtin Command

5. Fill in the requested information.
6. Select one of the three On Launch options, or use the default. These options control shutdown after a launch event. For more information, see How do I configure the shutdown mode?
7. Touch Submit to add the new launcher.

To cancel at any time and return to the main screen, press the BACK button.

Use the Transcript [62]

The Transcript is a log of recent KeyDirector operations. Use the Transcript to quickly find and repeat a recent operation:

1. Navigate to the KeyDirector main screen.
2. Touch an item in the Transcript to repeat the operation.

Exit KeyDirector [63]

For best performance, leave KeyDirector running in the background. Press the HOME button once or the BACK button (as many times as needed) to leave KeyDirector running in the background.

To exit and remove KeyDirector from memory, use the "exit" builtin command. For example, enter "exit" in the text input field.

NOTE: Using the "exit" command forces KeyDirector to rebuild the application list upon restart. This can take a few seconds.

Navigate to the KeyDirector main screen [150]

The KeyDirector main screen is the only screen where you can enter commands in a text input field. To navigate to the main screen, use one of these methods:

• Press the BACK button until you see "KeyDirector" in the title bar (upper left) and a "Voice" button and text input field (Cmd:) at the bottom lower left of the screen.
• Press the HOME button. Then press the KeyDirector shortcut on the Home screen, or restart KeyDirector from the Applications tab.

NOTE: Pressing HOME and restarting KeyDirector can often be faster than pressing the BACK button multiple times to return to the main screen.

View KeyDirector settings [163]

Use one of these methods:

• From the main screen, press MENU > VIEW Settings.
• In the text input field, type "kdset," then select Done or press Return.
• Select a Transcript item containing the "kdset" builtin.

For more information about the settings, see What are the KeyDirector settings?

Navigate to the Home Screen [64]

Press the HOME button (small house symbol) on the bottom of your Android device.

Use the Applications tab [65]

1. Press the HOME button.
2. Touch the Applications tab (bottom edge of screen). A grid of application icons appears. The icons are sorted in alphabetical order from top to bottom.
3. Touch an icon to start an application.

Scroll a grid or list up or down [66]

Use a finger to lightly flick or swipe the screen up or down. The screen scrolls up or down quickly. To stop the scrolling, lightly touch the scrolling list. You can also lightly drag your finger on the list up or down to control scrolling. When dragging, you can pause and hold your finger in place to stop the list from scrolling. If the list fails to move up or down or stops after flicking, you have reached the end of the list.

Select a program icon or list item [67]

Using your finger (do not use a stylus or sharp object), firmly touch or tap the center of an icon or list item to select it. The item flashes briefly. If audible feedback is enabled, you hear a short scratch or click noise.

Display a context menu for a list item [68]

List items often (but not always) contain context menus that show additional actions that can be performed on an item. To display the context menu for a list item, long-press the list item until it is highlighted and a menu appears. Release your finger, then select the desired context menu item. If necessary, use the BACK button to dismiss the context menu.

Move focus to a text input field and display the onscreen keyboard for character data entry [69]

Android (v1.5 and later) provides an onscreen keyboard when a program uses a text input field for character data entry. The text input field usually has a white background. You can use the TRACKBALL or Directional Key to move focus to a text input field. The TRACKBALL is the button-like control at the bottom of most Android devices. The Directional Key (an alternative to the TRACKBALL) is at the bottom or on the slide-out keyboard. Use your fingers or thumb to move the TRACKBALL up, down, left, or right in the direction you want to move focus. If you have a Directional Key, press the left, right, top, or bottom edges to move the cursor.

When the text input field has focus and is highlighted, a vertical blinking-line cursor appears. You can also move focus to the text input field by touching it with your finger. Touching the KeyDirector text input field also displays the onscreen keyboard, enabling character data entry.

Move a cursor in a text input field using the TRACKBALL or Directional Key [70]

Make sure the text input field for the cursor has focus. Roll the TRACKBALL left or right to position the cursor within the existing character data. If your device has a Directional Key instead of a TRACKBALL, press the left or right edge of the Directional key to move the cursor left or right.

Move a cursor in a text input field using your finger [71]

Make sure the text input field for the cursor has focus. Tap the approximate location within the text input field. The cursor is repositioned.

Enter or edit character data in a text input field [72]

1. To display the onscreen keyboard, touch or navigate to the text input field.
2. Select the keyboard letters, numbers, or symbols as required:

• Use the DEL key to backspace and/or delete characters.
• Use the Shift key (Up Arrow) to capitalize letters.
• Use the ?123 key to select numbers and symbols.
• Use the ALT key to select even more symbols.
• Use the Done key on the onscreen keyboard when you are finished entering data. You can also use Done to move to the next line for multiline text input.
• Use the Return key (the key with an arrow down and to the left) on the hardware keyboard when you are finished entering data. It is sometimes called Enter or CR and performs the same function as the Done key on the onscreen keyboard.
• Select the BACK button to close the onscreen keyboard, if necessary.

Cancel or back out of any program, or close the onscreen keyboard (on devices without a hardware keyboard) [73]

Press the BACK button. The BACK button is a dedicated button at the bottom of the device and has a left-pointing arrow symbol.

Change the screen display from portrait to landscape mode and back [74]

For portrait mode, hold the device in front of you so that the screen is vertical (the HOME button is at the bottom of the device).

To change to landscape mode, rotate the device 90 degrees counter-clockwise so that the HOME button is on your right as you view the device. The display blurs and then reorients to landscape mode. To return to portrait mode, rotate the device 90 degrees clockwise so that the HOME button is again at the bottom of the device. The display blurs and then reorients to portrait mode.

Read KeyDirector notifications or other long messages that don't fit entirely in the width of the screen [75]

Use the trackball to move the cursor or highlight to the desired item. Android automatically scrolls long messages from left to right so you can read the entire message.

Find KeyDirector after downloading and installing it on my device [76]

1. Press the HOME button.
2. Touch the Applications tab.
3. Scroll to find KeyDirector in the sorted grid, or press the "K" key (if you have a hardware keyboard) to show applications starting with "K."

Launch KeyDirector from the Home screen [77]

1. Find KeyDirector in the Applications tab.
2. Touch the KeyDirector program icon. KeyDirector starts and displays the main screen. For a description of KeyDirector startup activities, see Start KeyDirector.

Recognize the KeyDirector main screen [78]

Exit KeyDirector to return to the Home screen, but leave KeyDirector running in the background [79]

(NOTE: Android can kill background programs to reclaim memory.)
Use one of these methods:

• From the KeyDirector main screen, press the BACK button.
• Press the HOME button.

Exiting using one of these methods leaves KeyDirector running in the background. You can restart KeyDirector from the Applications tab or a shortcut (if you created one) on the Home screen.

Exit KeyDirector to return to the Home screen, and stop KeyDirector from running in the background [80]

Use one of these methods:

• Enter "exit" in the text input field.
• Touch an instance of "exit" in the Transcript.
• Enter "builtin" in the text input field, and select the "exit" item in the builtin list.

Create a shortcut to KeyDirector (or other applications) on the Home screen [81]

1. Find KeyDirector in the Applications tab.
2. Press and hold the KeyDirector icon. The icon expands, and the phone shakes once. Android displays the Home screen underneath the KeyDirector icon.
3. Drag your finger to an open area on the Home screen.
4. Release your finger from the icon, and a shortcut for KeyDirector snaps into an open area of the Home screen.

Move or delete any application shortcut from the Home screen [82]

1. At the Home screen, find the shortcut that you want to move or delete.
2. Press and hold the application icon until it expands and the phone shakes once.
3. Drag the icon toward the Applications tab (transforms to a red wastebasket), and release your finger as you drag the icon over and into the wastebasket. If you only want to move the icon or cancel deletion, release your finger over open space.

Uninstall KeyDirector [83]

Use one of these methods:

• From the Applications tab, press HOME > Settings > Applications > Manage Applications > select KeyDirector in the application list > Uninstall. To cancel the Uninstall process or return to KeyDirector, press the BACK button (multiple times, if necessary). You can also press HOME and press a KeyDirector shortcut (if you have one) to quickly re-launch.


• From within KeyDirector:
  1. Navigate to the KeyDirector main screen.
2. Enter "app" in the text input field to go to the Applications list.
3. Scroll or press the keyboard "k" key, or use the search button to find KeyDirector in the applications list.
4. Long-press the KeyDirector list item. A menu asks if you want to uninstall the application. Select "Uninstall App?"

NOTE: Before uninstalling, KeyDirector automatically backs up user data using the "bak" builtin.

To reinstall KeyDirector after uninstalling, you must launch the Android "Market" application, search for KeyDirector in the list, and click through to install.

Restore backup data after installing or reinstalling KeyDirector [162]

KeyDirector automatically prompts you to do this. During the KeyDirector startup sequence after a new install, KeyDirector checks to see if any backup data exists. If backup data is present and contains launchers, KeyDirector asks if you want to restore the last backup. If you answer OK, KeyDirector finds the most recent backup and uses the "restor" builtin function to restore it. This can take a few seconds. Otherwise, KeyDirector continues with the rest of the first-time startup process.

 

Enter Commands in KeyDirector [85]

KeyDirector accepts input in five ways. You can:

• Enter command names or characters in the text input field, then touch Done or press Return.
• Select a list item from the Transcript or one of the builtin lists.
• Press the MENU button and select a menu item
• Long-press a list item to reveal a context menu, and select a menu item.
• Press the "Voice" button (lower left corner of the main screen), wait until you see the "Speak Now" prompt, then speak a single word command.
  

NOTE: Voice recognition requires an Internet connection.

Enter or edit data in the text input field [86]

1. Display the onscreen keyboard, if necessary, by touching the text input field.
2. Position the cursor in the text input field.
3. Enter character commands in the text input field.
4. Submit the command by touching Done (onscreen keyboard), or pressing Return (hardware keyboard).

Submit KeyDirector commands in the main screen text input field [87]

On the onscreen keyboard, select the Done key. On a hardware keyboard, press the Return (down and left arrow) key.

Use voice recognition to launch a launcher, a builtin command, or application [88]

The KeyDirector main screen (command line at bottom of screen) has a button labeled "Voice" in the lower left corner. When you touch the "Voice" button, KeyDirector prompts you to wait for setup, then speak a single word. The spoken word is translated to text and entered as a command (as if you typed it in the command line). Common word recognition is supported (not abbreviations or URLs).

NOTE: Voice recognition requires an Internet connection.

List all builtin commands [89]

Use one of these methods:

• From the main screen, press MENU > VIEW Builtins.
• In the text input field, type "builtin," then touch Done or press Return.
• In the Transcript, select an instance of "builtin."
• In the Transcript, select a launcher that launches "builtin."

Find a builtin quickly in the builtin list [90]

Use one of these methods:

• If you have a hardware keyboard, you can scroll the builtin list quickly by entering a single alphabetic character. The list scrolls to the first builtin that starts with that character. This is similar to the alphabetic scrolling for application names in the "app" builtin list.
• From the KeyDirector main screen, you can also browse builtin commands by entering the first two characters of a command name in the text input field. The Auto-complete list reveals builtin (as well as application and launcher command) options for selection.
• Navigate to the builtin screen (use the "builtin" builtin). Press the dedicated Search key (as on the Google Ion phone) or the Search key on the T-Mobile G1 hardware keyboard (magnifying glass symbol). A dialog allows you to enter a few characters to search for a matching builtin name. Press OK to start the search.

Launch any builtin command (for example, "app") [91]

Use one of these methods:

• In the text input field, type "app," then select Done or press Return.
• List all builtin commands, then select "app" from the builtin list.   
• Select a Transcript item containing the "app" builtin.
• Select a Transcript item launcher for the "app" builtin.

 

Display the current time of day and date [92]

Launch the "time" or "date" builtin command. In the text input field, type "time" then select Done or press Return.

NOTE: The "time" and "date" builtins do nothing more than create or update a Transcript item that shows both the current time and date. They are provided as a convenience because some Home screen implementations give one or the other but not both.

Toggle Auto-complete for data entry [93]

1. Navigate to the KeyDirector main screen.
2. Use one of these methods to control the Auto-complete function:

• MENU > VIEW Settings > Enable (or Disable) Auto-complete.
• In the text input field, type "togac," then select Done or press Return. Or use other methods to launch the "togac" builtin.
  

Add a Contact [94]

Edit a Contact [95]

Get memory and SD card storage information for your device [96]

Use one of these methods to launch the "mstat" builtin command:

• From the main screen, press MENU > VIEW Builtins > Select "mstat" from the list.
• In the text input field, type "mstat," then touch Done or press Return.
• In the Transcript, select an instance of "mstat."
• In the Transcript, select a launcher that launches "mstat."

List the launchers [97]

1. Navigate to the KeyDirector main screen.
2. List the launchers using one of these methods:

• MENU > VIEW Launchers.
• Launch the "grid" builtin command. For example, in the text input field, type "grid" then select Done or press Return.
• Launch the "keyl" builtin command. For example, in the text input field, type "keyl" then select Done or press Return.

If you have numerous launchers, see Find a launcher quickly when the list is long.

Find a launcher quickly when the list is long [98]

1. Navigate to the launcher screen.
2. Press the dedicated Search key (as on the Google Ion phone) or the Search Key on the T-Mobile G1 hardware keyboard (magnifying glass symbol). A dialog prompts you to enter a few characters to search for a matching launcher name.
3. Press OK to start the search.

Navigate to the ADD Launcher screen [99]

1. Navigate to the KeyDirector main screen.

2. Open the ADD Launcher screen using one of these methods:

• MENU > ADD Launcher.
• Launch the "add" builtin command. For example, in the text input field, type "add," then select Done or press Return. For other ways to launch a builtin command, see Launch any builtin command.
• Launch the "grid" builtin command > MENU > ADD Launcher.
• Launch the "keyl" builtin command > MENU > ADD Launcher.

Add or edit a launcher in the ADD/EDIT Launcher screen [100]

1. Navigate to the ADD Launcher screen by doing the following:

a. Navigate to the KeyDirector main screen.
b. Use one of these methods to open the ADD Launcher dialog box:

• MENU > ADD Launcher.
• Launch the "add" builtin command. For example, type "add" in the text input field, and select Done or press Enter. For other ways to launch a builtin command, see Launch any builtin command.

2. Enter a launcher name in the text input field at the top of the screen (only in Add mode).

NOTE: Do not use a colon (:) or vertical bar (|) character in the launcher name. The KeyDirector backup file format (.json) does not support these characters. For a full list of launcher name restrictions, see this FAQ.

3. Touch a button to define the launcher data and type:

• Application
• Contact Phone or Email or Name
  
• Text Message
• URL
• Builtin Command

4. Select the launcher data and type. For example, if you touched the Application button, choose an application.
5. Select an On Launch option (Continue, Close, or Exit). These options control how KeyDirector operates after starting the launcher. For more information, see How do I configure the shutdown mode?
6. Touch the SUBMIT button to add the new launcher or confirm your launcher edits.

Before final SUBMIT, you can toggle buttons highlighted with selected data to deselect and eliminate the data. You can then choose a different launcher type button. To cancel and return to the main screen, press the BACK button at any time.

Rename, delete, or edit a launcher [101]

1. List the launchers:

a. Navigate to the KeyDirector main screen.
b. Launch the "grid" builtin command. For example, in the text input field, type "grid," then select Done or press Return. For other ways to launch builtin commands, see Launch any builtin command.

2. Scroll the page to find the desired launcher in the list. You can touch an alphabetic key on the hardware keyboard to quickly scroll to launchers starting with that character.

3. Long-press the desired launcher item until the context menu (RENAME, EDIT, DELETE) appears.

4. Touch RENAME, EDIT, or DELETE.

5. Finish the RENAME, EDIT, or DELETE operation, as prompted.

RENAME requires you to enter a new name in the text input field, then select the OK button. EDIT displays the Add/Edit screen where you can redefine the launcher type. To cancel any of these operations, use the BACK button one or more times.

Select or launch a launcher [102]

1. Navigate to the KeyDirector main screen.

2. Use one of these methods to select a launcher:

• Type the launcher name in the text input field, then touch Done or press Return.
• List the launchers, then touch the desired launcher in the list to launch it.
• Identify a launcher submission in the Transcript > Touch the Transcript item to re-launch it.

Clear or delete all launchers [103]

1. Navigate to the KeyDirector main screen.
2. Launch the "clkl" builtin command. For example, in the text input field, type "clkl," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

NOTE: KeyDirector performs a backup before deleting all the launchers.

Clear the Transcript [104]

1. Navigate to the KeyDirector main screen.
2. Launch the "cltr" builtin command. For example, in the text input field, type "cltr," then select Done or press Return. For other ways to execute a builtin command, see "Launch any builtin command."

NOTE: KeyDirector performs a backup before deleting the current Transcript info.

Delete a single item in the Transcript [105]

Press and hold the Transcript item. A menu appears. Click the menu item "Delete Transcript Item?" To cancel the deletion, use the BACK button.

Sort the Transcript based on frequency in ascending order [106]

Use one of these methods:

• From the KeyDirector main screen, select MENU > VIEW Settings > Transcript Sorting Style > Touch "Frequency-Ascending"
• Launch the "srtfa" builtin command. For example, in the text input field, type "srtfa," then select Done or press Return.

Sort the Transcript based on frequency in descending order [107]

Use one of these methods:

• From the KeyDirector main screen select MENU > VIEW Settings > Transcript Sorting Style > Select "Frequency-Descending"
• Launch the "srtfd" builtin command. For example, in the text input field, type "srtfd," then select Done or press Return.

Sort the Transcript based on history (time of submission) in ascending order [108]

Use one of these methods:

• From the KeyDirector main screen, select MENU > VIEW Settings > Transcript Sorting Style > Select "History-Ascending"
• Launch the "srtha" builtin command. For example, in the text input field, type "srtha," then select Done or press Return.

Sort the Transcript based on history (time of submission) in descending order [109]

Use one of these methods:

• From the KeyDirector main screen, select MENU > VIEW Settings > Transcript Sorting Style> Select "History-Descending"
• Launch the "srthd" builtin command. For example, in the text input field, type "srthd," then select Done or press Return.

View a list of all my applications [110]

Launch an application using KeyDirector [111]

1. Navigate to the KeyDirector main screen.
2. Use one of these methods to launch the application:

• Use the "app" builtin to select from a list. MENU > VIEW Apps. Or, type "app" in the text input field, then select Done or press Return.
  
• Type the full (case-sensitive) name of the application in the text input field. For more information, see Recognize duplicate application names.
  
• Type the first few characters of the application name and select from the Auto-complete popup list. For more information, see Recognize duplicate application names.
• Select a Transcript item from a previous application name launch.
• Type the name of an application launcher in the text input field.
• Select a Transcript item from a previous application launcher launch.

Recognize duplicate application names, and launch them from the command line [112]

In the Android Marketplace, you can download many applications that have the same name. KeyDirector uses a suffix with a number to distinguish duplicate application names from different sources. For example, the application name "Calculator(2)" describes the second instance of an application named "Calculator." Yet another calculator application from a different author would appear as "Calculator(3)," and so on. When entering application names in the command line, you must enter the case-sensitive KeyDirector name with the suffix to launch the desired application.

Quickly find an item in a long list of applications, builtins, launchers, or contact names [113]

Use one of these methods:

• If your device has a hardware keyboard, press any alphabetic key to position the list to the first item starting with that key.
• You can also use the MENU > Search item or the dedicated Search key (magnifying glass) on your hardware or onscreen keyboard. KeyDirector launches a dialog box where you can type a few characters or the whole name of an application, builtin, launcher or contact (lower or upper case). KeyDirector moves the list to the first match it finds.
• From the KeyDirector main screen, you can also browse application, launcher, and builtin commands by entering the first two characters of a command name. The Auto-complete list reveals options for selection.

Refresh the KeyDirector application list if it seems out of date after installing or uninstalling applications [114]

Use the "refapp" builtin command. Or, use the "exit" builtin command, then restart KeyDirector. For more information about builtin commands, see Launch any builtin command.

NOTE: Using the BACK button at the KeyDirector main screen leaves KeyDirector running in memory (background). Restarting KeyDirector when it is running in the background does not refresh the application list.

Enable or disable icons in the "app" builtin screen [115]

Use one of these methods:

• From the KeyDirector main screen, select MENU > VIEW Settings > Display "app" icons.
• Navigate to the "app" builtin screen using MENU > VIEW Apps, or type "app" in the text input field followed by Done or press Return. Select MENU > Enable (or Disable) icons.

When icons are enabled, they are displayed in the "app" builtin screen. NOTE: KeyDirector needs to rebuild the application list to populate the icons.

Uninstall an application using KeyDirector [116]

1. From the KeyDirector main screen, select MENU > VIEW Apps, or type "app" in the text input field, then select Done or press Return. The application list is displayed.
2. Long-press an application name. A prompt asks if you want to uninstall it. Select the menu item to uninstall the application. To cancel the operation, select the BACK button.

Start the Browser application from the KeyDirector main screen [117]

Launch either the "brow" or "url" builtin command. For example, in the text input field, type "brow" or "url," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

Launch the Browser to a specific page from the KeyDirector main screen [118]

From the KeyDirector mains screen, enter a URL using one of these methods:

NOTE: If you type a web URL in the main screen text input field, KeyDirector recognizes this as a command to launch the browser. It also tries to guess the full name of the URL if you do not enter the full name.

• Type the full name of a URL (for example, www.hp.com) in the text input field, then select Done or press Return.
• Type the partial name of a URL (for example, "www.<sitename>") in the text input field, then touch Done or press Return.
• Type "brow" followed by the full or partial name of a URL in the text input field, then select Done or press Return.
• Select a Transcript instance of a previous "brow" builtin command or web URL.
• Select a Transcript item launcher that starts the "brow" builtin command or a web URL.

Use the "url" builtin command to quickly select a URL and launch a browser [119]

NOTE: The "url" builtin has extended capabilities for completing partial URL data entry, or selecting bookmarks or history (visited) URLs and then launching a browser. From the KeyDirector main screen, enter the URL using one of these methods:

• Type "url" in the text input field, then touch Done or press Return. NOTE: Like all other builtin commands, "url" can also be launched from the builtin screen, from a Transcript "url" re-launch, or from a "url" builtin launcher.
• Type the complete URL in the text input field, then touch Done or press Return.
• Type a single word in the text input field, then touch Done or press Return. KeyDirector tries to guess the complete URL (for example, "hp" > www.hp.com).
• Select the button "Bookmark and History URLs" to display a list of Bookmarks and other visited URLs. Select one of the URLs from the list.
  

KeyDirector launches a Browser window to the selected URL.

View the Browser history without opening the Browser [120]

Launch the "hist" (or "book") builtin command. For example, in the text input field, type "hist," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

NOTE: the "book" and "hist" builtin output has been consolidated in the 1.1 release.  Both "book" and "hist" will display a list of bookmarks and other visited (history) URLs. Bookmarks are never removed from the display list. So, if the "clbh" command has been used recently, only bookmarks will remain in the "hist" and "book" display list.

Select a Browser history URL for re-browsing [121]

1. View the Browser history by launching the "hist" builtin command. For example, in the text input field, type "hist," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
2. Touch a desired history URL.

 

NOTE: the "book" and "hist" builtin output has been consolidated in the 1.1 release.  Both "book" and "hist" will display a list of bookmarks and other visited (history) URLs. Bookmarks are never removed from the display list. So, if the "clbh" command has been used recently, only bookmarks will remain in the "hist" and "book" display list.

Clear the Browser history within KeyDirector [122]

Launch the "clbh" builtin command. For example, in the text input field, type "clbh," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

NOTE: the "book" and "hist" builtin output has been consolidated in the 1.1 release.  Both "book" and "hist" will display a list of bookmarks and other visited (history) URLs. Bookmarks are never removed from the display list. So, if the "clbh" command has been used recently, only bookmarks will remain in the "hist" and "book" display list.

View Browser bookmarks without opening up the Browser [123]

Launch the "book" builtin command. In the text input field, type "book," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

NOTE: the "book" and "hist" builtin output has been consolidated in the 1.1 release.  Both "book" and "hist" will display a list of bookmarks and other visited (history) URLs. Bookmarks are never removed from the display list. So, if the "clbh" command has been used recently, only bookmarks will remain in the "hist" and "book" display list.

Select a Browser bookmark URL for re-browsing [124]

1. To view the Browser bookmarks, launch the "book" builtin command. For example, in the text input field, type "book," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
2. Select a desired Bookmark URL.

NOTE: the "book" and "hist" builtin output has been consolidated in the 1.1 release.  Both "book" and "hist" will display a list of bookmarks and other visited (history) URLs. Bookmarks are never removed from the display list. So, if the "clbh" command has been used recently, only bookmarks will remain in the "hist" and "book" display list.

Launch a Google Search directly from KeyDirector [125]

Use one of these methods:

• With the KeyDirector main screen displayed, press the dedicated Search key (magnifying glass).
• With the KeyDirector main screen displayed, press the dedicated Search key (magnifying glass) on the hardware or onscreen keyboard.
• Launch the "srch" builtin. For example, in the text input field, type "srch," then select Done or press Return.
• Type "srch [search_phrase]" in the text input field, then touch Done or press Return. KeyDirector opens a Browser page to the Google Search™ results or to the Google home page if no search phrase is given.

NOTE: Like all builtin commands, "srch" can be launched from the builtin screen, from a Transcript "srch" re-launch, or from a "srch" builtin launcher. See Launch any builtin command.

Back up Transcript data and launchers to a text file on the SD card (/sdcard/keydirector_bak) [126]

Launch the "bak" builtin command. For example, in the text input field, type "bak," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

WARNING: The "exit," "cltr," and "clkl" builtins also create backups, but those commands have the side effects of closing KeyDirector, or removing Transcript and launcher data, potentially requiring a restore.

View the list of backup files residing on the SD card (/sdcard/keydirector_bak) [127]

Launch the "restor" builtin command. For example, in the text input field, type "restor," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

View the contents of a backup file residing on the SD card (/sdcard/keydirector_bak) [128]

1. View the list of backup files by launching the "restor" builtin command. For example, in the text input field, type "restor," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
2. Select the desired file based on the time/date stamp or "export"ed name. The file contents are displayed. To return to the list of backup files, press the BACK button.

Restore or select a backup file for restoring on the SD card (/sdcard/keydirector_bak) [129]

1. View the list of backup files by launching the "restor" builtin command. For example, in the text input field, type "restor" then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
2. Long-press the selected backup file until the item is highlighted and the context menu appears.
3. Start the "restor" operation by touching "Select This File." A dialog box prompts you to select from these options:

• REPLACE current data with backup - This option purges all existing launchers, Transcript items, and settings before restoring the backup file information.

• MERGE backup with current data - This option restores the backup information without purging unique and existing launchers, Transcript items, and settings.

NOTE: If you select the MERGE option and the selected backup file contains a launcher having the same name as an existing launcher, KeyDirector purges the existing launcher and replaces it with the launcher in the backup file.

4. Choose an option to begin the restore.

Quickly restore the most recent backup after upgrading KeyDirector [130]

KeyDirector detects the first time it is started after an upgrade and first displays the EULA and Build App List screens. Then, if backup data is available, KeyDirector asks if you want to restore the last backup. Answer "OK" to restore the last backup or "Cancel" to proceed directly to the Welcome screen followed by the main screen. The "restor" builtin command can always be used at a later time to restore backup data.

Verify that a "restor" completed successfully [131]

KeyDirector gives a short message stating first the number of restored launchers and then the number of restored Transcript items. If there was an error during a "restor," the device shakes, and a Warning icon (!) appears in the Notification bar with details of the last error found. A number on a red circle near the notification icon indicates the number of errors found (if greater than 1).

Export or send backup data to a selected email account [132]

1. Launch the "export" builtin command. For example, in the text input field, type "export" then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
2. Type the desired email address in the text input field at the top of the screen. Or touch the "Select Email From Contacts" button, and choose an email address.
3. Touch the Submit button to launch the Email application and build a message containing the exported data.
4. Touch the Send button to send the message from the Email application to the desired address.

Transfer backup data contained in an email message on a PC or other device to the SD card [133]

1. Use editing tools on a PC or other device to copy and paste the email backup data (contained in the message body) into a text file with a name of your choosing.
2. Use Android FTP or another sync program to transfer the text backup file to the /sdcard/keydirector_bak directory on the SD card.
3. Use "restor" to restore the desired backup file. For example, in the text input field, type "restor" then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.

Remove excessive backup files on the SD card [134]

KeyDirector automatically saves the 10 most recent (.json) backup files. Backup files produced by "bak" are stored in time/date-stamped files in the /sdcard/keydirector_bak folder on the SD card. These files can be managed or removed like any other files on the SD card. Backup files imported into /sdcard/keydirector_bak are never removed by KeyDirector and can be managed using file-management utilities.

NOTE: older backup files (text files that do not have a .json extension) are never removed by KeyDirector so that users cannot lose data when transitioning to the latest .json backup file format.

View the contents of a backup file residing on the SD card (/sdcard/keydirector_bak) [135]

1. View the list of backup files by launching the "restor" builtin command. For example, in the text input field, type "restor," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
2. Select the desired file based on the time/date stamp or "export"ed name. The file contents are displayed. To return to the list of backup files, press the BACK button.

Display the Help page [136]

(Any Screen) MENU button > HELP.

Display the Welcome message [137]

Use one of these methods:

• Launch the "welcom" builtin command. For example, in the text input field, type "welcom," then select Done or press Return. For other ways to execute a builtin command, see Launch any builtin command.
• Navigate to the Help screen (MENU button > HELP on any screen) > touch the link for "Welcome Screen."

To go back, select the OK button on the display, or press the BACK button on the device.

Display the About message [138]

1. Navigate to the Help screen (MENU button > HELP in any screen).
2. Select the "About" link.

To go back to the Help page, touch the OK button on the display.
To exit the Help screen, touch the QUIT button, or select the BACK button on the device.

Display the End User License Agreement [139]

1. Navigate to the Help screen (MENU button > HELP in any screen).
2. Select the "End User License Agreement" link.

To go back to the Help page, touch the BACK button on the display.
To exit the Help screen, touch the QUIT button, or select the BACK button on the device.

Display the FAQ [140]

1. Navigate to the Help screen (from any screen, press the MENU button > HELP).
2. Select the "FAQ" hyperlink.

To go back to the Help page, touch the BACK button on the display.
To exit the Help screen, touch the QUIT button, or select the BACK button on the device.

Alternately, you can use the "faq" builtin by entering "faq" in the text input field or using one of the methods in Launch any builtin command.

Send a comment, question, or bug report to the developer [141]

1. Display the Help page (MENU button > HELP on any screen).
2. Click "Send a Comment/Question/Bug to Developer."
3. Enter any information you like in the email application, and press SEND.

Use Help on the device [142]

Select...	To
Any question	Display/Hide its answer
BACK button	Go back to the previous link
"Top" link	Go to the start of the question list
FORWARD button	Revisit a previous link
QUIT button	Exit the Help screen
BACK button on Android device	Exit the Help screen

Make the help easier to read [151]

All online help, FAQ, and How do I answers can be zoomed in or out to make the text larger or smaller. To find the zoom control, navigate to a help topic and touch the screen, or swipe up or down. To zoom in, tap the + (plus) button. To zoom out, tap the - (minus) button. To return to the default text size, tap the 1x button.

Display the How Do I [152]

1. Navigate to the Help screen (MENU button > HELP from any screen).
2. Select the "How Do I" hyperlink.

To go back to the Help page, touch the BACK button on the display.
To exit the Help screen, touch the QUIT button, or select the BACK button on the device.

Alternately, you can use the "howdoi" builtin. To run the builtin, use one of these methods:

• Enter "howdoi" in the text input field.
• Touch an instance of "howdoi" in the Transcript.
• Enter "builtin" in the text input field, and select the "howdoi" item in the builtin list.

Search the FAQ and How Do I [154]

In the KeyDirector main screen, pressing the Search key on your mobile device starts a Google™ search. However, when you are using KeyDirector Help, FAQ, or How Do I builtins, you can use the Search key to search those topics:

1. Navigate to the Help table of contents, the FAQ, or the How Do I. For example, from any screen, select Menu > Help, and touch "FAQ" or "How Do I," or use the "help," "faq," or "howdoi" builtins.
   
2. Use one of these methods to initiate a search:

• Press the dedicated search button (magnifying glass).
• Select Menu > Search.
• If your device has a hardware keyboard, start typing a search query. A query box appears automatically (this feature does not work in Help).

Note these search considerations:

• The first search attempt displays an initialization screen while KeyDirector builds the search index database on the mobile device. This process can take 20 to 30 seconds, but only needs to be done once. The initial search will start when initialization is done.
  
• Search queries are limited to a single word. Additional words are ignored.
• The JBH Engineering web site provides the same FAQ and How Do I content and can also be searched:
  
  http://jbhengineering.com/phpmyfaq/

Expand or collapse the How Do I [155]

The How Do I provides an expandable list of categories with topics that tell you how to use KeyDirector. To display the How Do I, see Display the How Do I.

To expand or collapse a category in the How Do I, hold the cursor over the category, and select it.
To expand all or collapse all categories in the How Do I, select Menu > Collapse All or Expand All.

Use the Back, Forward, and Quit buttons [156]

Back, Forward, and Quit buttons are provided in KeyDirector online help screens that contain hypertext links. These buttons help you navigate to and from help topics as if using a browser. The Back and Forward buttons work the same as the Back and Forward buttons on a browser. The Quit button exits the current activity and returns to the activity that started it. In this sense, it functions the same as the dedicated Back key on your mobile device.

If a topic contains no hyperlinks, no buttons are displayed on the page. To return to the previous screen, press the dedicated Back key.

Find the version of KeyDirector that is installed on my mobile device [160]

Display the About or Welcome screen. The KeyDirector version (for example, KeyDirector 1.1) appears at the top of the screen. For more information, see Display the Welcome message.

Check for upgrades to KeyDirector [161]

KeyDirector silently checks for upgrades at startup or whenever the "Check for Upgrades" setting is toggled to ON and an Internet connection is present. KeyDirector compares its internal version with the latest version on the http://jbhengineering.com/keydirector/ Web site. If a newer version is available, KeyDirector generates a notification. If you select the notification, KeyDirector provides Yes or No prompts for upgrading. If you answer Yes, KeyDirector searches the Android Market for the upgrade so you can install the latest version. You can also cancel the upgrade.

The "Check for Upgrades" setting is ON by default. To check for upgrades or turn off the setting:

1. Navigate to the KeyDirector main screen.
2. MENU > View Settings.
3. Touch the "Check for Upgrades" setting to select or deselect it, as needed.

NOTE: The upgrade check is silent (performed in the background). You are alerted only if a newer version exists.

Dial a telephone number from KeyDirector [168]

1. Navigate to the KeyDirector main screen.

2. In the text input field, type a phone number. Spaces and dashes are optional. KeyDirector launches the Phone Dialer and looks up the Contact name (if one exists) in the Contacts list.

Note these considerations:

• KeyDirector passes the specified number to the Android Phone Dialer. Any raw number that works with the Phone Dialer should work in KeyDirector as long as it contains only numbers, spaces, and dashes.
• International calls must contain all the numbers required to dial the call manually. NOTE: This feature has not been tested for international call support.
• If the specified number is found in the Contacts list, KeyDirector shows the name and type of number (in addition to the number itself) in the Transcript entry. If the specified number does not have a corresponding Contacts item, only the phone number is displayed in the Transcript.
• The Transcript entry for the phone number can be selected (like any other KeyDirector Transcript item) to re-launch the item (re-dial the telephone number).
• Shutdown termination characters ((.) for close and (!) for exit) also work with telephone number input.
• KeyDirector does not support creating launchers for a telephone number entered in the text input field, but the KeyDirector "add" builtin has always supported launcher creation for telephone numbers that exist in the Contacts list.

Control the ringer mode of my phone from KeyDirector [169]

Use one of these methods:

• In the text input field, type "togrm," then select Done or press Return.
• Select a Transcript item containing the "togrm" builtin command.

The "togrm" builtin command displays a dialog box that allows you to choose the ringer mode

• Normal -- Vibrate Per Setting (Android Settings > Sound & display > Phone vibrate)
• Silent -- No Vibrate
• Silent -- Vibrate

For more information about the "togrm" builtin command, see Can I control the ringer mode on my phone by using KeyDirector?