# CJListLauncher

## A free utility for Shadow Plan users

- What is CJListLauncher?
- Do I need it?
- How do I install CJLL?
- Install to RAM? Flash? Expansion Media? Springboards?
- The three modes of operation:
  1. List launching
  2. Making shortcut applications
  3. Making a 'table of contents' list
- How to: List launching
- How to: Making and using shortcuts
- How to: Make and use a table of contents

### What is CJListLauncher?

CJListLauncher ("CJLL" hereafter) is a free utility that will likely be a time-saver for those who tie ShadowPlan to a button or who use launcher-style Hacks, "DA" launchers, or other nifty tricks to launch applications... or who may want to see their Shadow Plan file listing outside of Shadow Plan.

CJLL will let you launch Shadow Plan, telling it to load specific lists of your choosing. Normally Shadow Plan will launch and show you the list you were in when you closed the application last (or the file selection screen if no list was open), but CJLL lets you tell Shadow Plan what to load instead. For example, you might set up a category in your launcher (like the Palm's built in application launcher, or a third party fancy one) for Shadow Plan files. You could then use CJLL to create shortcut applications which are just tiny programs that will load a specific Shadow Plan list. So instead of launching Shadow itself, you just tap on one of your shortcuts and Shadow Plan opens to your file.. this can let you manage your files from outside of Shadow Plan itself.

You can also set CJLL to a real button on your device, so when you press the button CJLL will let you select a file to open in Shadow Plan.

Read on to find out the other modes of operation that CJLL can run in and how it can save you precious time!

### Do I need it?

Only if you want it. CJLL is a useful utility for Shadow Plan, but you can entirely live without it. If you are short on storage memory or just don't think you'll need it, delete it. You can always install it again later .. no trouble at all!

### How do I install CJLL?

CJLL will be installed during a normal Shadow Plan installation. You may have immediately deleted it to save memory and decided to install it now. Or perhaps you did not install using the setup utility, so need to install it manually.

Open up the Shadow Plan (or CJListLauncher) distribution .zip file by double clicking on it (in most operating systems). Then double click on the CJListLauncher.prc application you find within it. Thats it! Your Palm Desktop should detect the double click and put CJLL into your hotsync queue and after a fresh Hotsync you'll find CJListLauncher on your handheld.

All you need is the CJListLauncher.prc application (though of course Shadow Plan is useful too!)

CJListLauncher is less than 20k .. very small!

### Install to RAM? Flash? Expansion Media? Springboards?

Expansion media refers to Sony Memory Stick, Secure Digital (SD) cards, MMC cards, Compact Flash (CF) Cards, and other plugin media.

If you only intend on using CJLL to create shortcuts, you can put it anywhere you like.

Handspring modules count as normal Palm RAM for purposes of launching CJLL and Shadow Plan, so theres nothing to worry about for the Handspring Flash Module or similar expansion.

If you intend on tieing CJLL to a button on your device you need to take these other points into consideration...

Shadow Plan can be on expansion media for normal operation; however, when using CJLL to launch it, Shadow Plan will need to be in normal Palm RAM. (Write to us at support@codejedi.com if you think this is a bad requirement and perhaps we can work on it)

CJLL must be in normal Palm RAM as well if you intend on tieing it to a button on your device, as Palm OS cannot launch an application from a button press unless it is in RAM.

### The three modes of operation:

#### List launching

CJLL can be assigned to a button on your device; when launched from a button CJLL will let you launch a specified list (out of 3 you configure in) or Shadow Plan itself. If you change lists a lot, this is a fast way to load Shadow and make sure its always going to a list you've selected.

See below for details.

#### Making shortcut applications

A shortcut is a tiny little application who knows about one Shadow Plan list; when launched a shortcut will fire up Shadow and load that list. CJLL can create these little shortcut applications for you.

Theres a variety of reasons you may wish to create shortcuts; some examples:

- You could assign a shortcut to a button on your device; this would let you force Shadow to a specific list based on button presses.
- You could create a category in your launcher and put a shortcut to each of your most important lists in it; then you could simply change to that category and pick a list and bingo, there you are.
- If you're using some sort of launcher-like Hack like QLaunch or McPhling or others, you could configure them to launch a shortcut after holding a button down a certain amount of time, or from a menu, or however the Hack works. This could let you have a button assigned to several lists.. a pretty handy little trick.
- (your imagination here)

See below for details.

#### Making a 'table of contents' list

Shadow Plan lists have the ability of linking a record to another list; in effect this lets you tap on the link arrow (the far right side of each item in a normal list view, for example) and then jump over to the referenced file. This is generally used to let you create a group of files that refer to each other. CJLL can create a table of contents file that is a list of all your Shadow Plan lists, where each one has a link to its file. You could then use this list instead of Shadow's file selection screen to get to your various lists, and since it is just another Shadow list, you could apply tags and filters, or sorts, or collapse and hide items, whatever you might like to do.

See below for details.

### How to: List launching

Setting up CJLL for launching lists from a button press is a few easy steps:

1. Assign CJListLauncher to a hard button on your device. Run the "Pref" application from your handheld's launcher and choose the Buttons group of options. From there you can pick a button, tap on its arrow, and select CJListLauncher from the listing. After doing this, any time you press the button, it'll fire up CJLL.
2. Run CJListLauncher from the Launcher (not by pressing the button you've just assigned, since CJLL will run Shadow Plan when launched from a button!)
3. CJLL's main screen (when launched from the launcher) lets you pick which three lists you wish to have launchable; just tap on the picker arrow and select a Shadow Plan list from the popup options. You can pick 1-3 lists.
4. Once you've specified the lists to launch, you're all set!
5. You can change which lists are configured at any time; just return to CJLL (via the launcher!) and choose different lists if you would like it.

When you press the button you've assigned to CJLL, Palm OS will tell the current application to finish up and when thats done, CJLL will be launched. CJLL will detect that it was launched from a button and instead of showing you its configuration screen, will attempt to launch the files its been told to launch.

If you just press and release the button quickly, then CJLL will launch its "default list" -- the first list in the configure screen. If you hold down the button though, then after one second CJLL will decide to launch its second list. Keep holding down another second and CJLL will jump to the third list... and finally after one more second, it'll just decide to launch Shadow Plan itself (and Shadow will go to the last setup it had when you closed it).

Note: On older devices (OS4.0 and earlier) CJLL may need you to hold the button down until CJLL itself is fired up by Palm OS, or it will go to its configuration screen instead of launching Shadow. Most Palm OS applications will exit very quickly, so you wouldn't notice this much. But a few applications may take a second to exit, and so you may need to hold CJLL's button down a moment for it to realize the button was pressed. Newer devices will inform CJLL that it is being launched from a button, so there is no confusion. Or you can just press the button quickly and let CJLL come up, and press it again to fire up the default list or hold it down to cycle through other lists.

### How to: Making and using shortcuts

Creating a shortcut is easy; just follow these steps:

1. Run CJListLauncher from the Launcher (not from a button if you've assigned it to one, since that will run Shadow Plan!)
2. Assign the file you wish to create a shortcut of to one of the three CJLL list launch slots; if you're using all 3 slots now (as list launch from a button press say), then just temporarily change the list choice to the one you want a shortcut of, and change it back to the desired list after you're done (below).
3. Press the Make button to the right of the list slot you've set.
4. Thats it! CJLL will inform you that a shortcut has been created in your Launcher.
5. If you changed a list choice that you wanted, just return it back to what it was.. the shortcut is complete and wouldn't mind :)
6. Do what you like with the shortcut; file it into the right Launcher category, or set it up in a Hack, whatever you'd like.

Note: Palm OS will let you create as many shortcuts as you like, though many launchers and Hacks will be confused if you have more than 10 shortcuts created at a time, and may launch the wrong one.

### How to: Make and use a table of contents

Making a table of contents file with CJLL is very easy to do; just invoke CJListLauncher from your Launcher (not from a button or CJLL will launch Shadow Plan!) and pick "Make TOC" from the bottom of the screen. You can create a flat "one level" alphabetically sorted list, or you can create a "two level" list that has each file under its Shadow Plan Category (handy to keep files together like you would see them in Shadow's File Selection Screen).

When "Make TOC" finishes, you will have a file called "_TOC_" created. If you've never categorized one before by that name, it will be created in "Unfiled" Shadow Category. If you then categorized it to a new category and later hit "Make TOC" again, the new _TOC_ file will go into the category of the existing _TOC_ file, so you won't get lost.

NOTE: When you hit "Make TOC" a new list is created. If you change the _TOC_ file and then hit Make TOC again, you will erase the old _TOC_ file and get a brand new one in its place, losing most of your changes. We have made CJLL smart enough to pick up your existing List Preferences from that _TOC_ file before it is erased though.... so if you have turned on colour themes, a titlebar, or various other options, then they will be remembered in the new _TOC_ file. The things you lose are if you re-sort the items order, or if you add tags or notes or extra items into the old _TOC_ list.

### Enjoy!