But the basic features include:
PiNGer and ZFaxZ's viewer have a conflict with QuickBits. If you scroll leftward you may get a fatal exception. Email me for a workaround or check for an update to QuickBits - I am working with them to resolve it.
If you need to move files to or from a computer without HotSync or any other Palm software, you can use the Serial feature of ZBoxZ. For Windows, start HyperTerm (usually in the accessories), and create a direct serial connection, "desktop to desktop", i.e. no modem or manual connect. Linux can use rb to receive or sb to send files. Mac has various terminal programs, find one that supports YModem (or see below). Use those file transfer features. Set or verify the baud rate (speed) on both ends to the same thing, use smaller numbers for slower or loaded Desktops, then start YRec on the palm and send YModem on the desktop to move files to the palm, or set up YModem receive on the desktop and do YSend on the palm. Also provided is a raw send or recieve. You need to select a box to send or recieve, and it will be sent raw, or record any characters received into that box. (You can use box or clip-to-box to create a box, and use File->Info to rename it). If a modem is attached, you can send commands to initialize or dial before starting the transfer (no responses are printed - it is intended only for resets, answering, dialing, or entering things like "rb" to start the transfer).
Graffitiing a letter takes you to the next entry starting with that letter (Case sensitive - the shift/shiftlock/punct indicator is on the top line). If no file begins with that letter it scrolls to the top. Normally you want to use this with name sort, but it will do the same thing (find next beginning with the letter) in any sort mode.
If you have internet and/or ppp it is even simpler since you can use Atache to send and Hi/LoBrowz to pull files to/from your desktop. You need to use something like MochaPPP (www.mochasoft.dk) or the built in PPP like NT's RAS to create a connection to the cradle or serial port, or via modem. Linux can use the normal pppd (I recommend 57600 and reduce the MTUs - a /etc/ppp/options setup I use is in the Docs directory)
If you have a Mac without a normal serial port, you can use the Modem if you have a modem attached to the palm. I picked up a surplus one at a computer flea market for $35, or you can get a palm modem. I plugged them together but not into the phone line (the phone line went between the external modem and the iMac), using ATX1D on the iMac and ATA on the Palm established a serial link. It works if you reverse it. (the ATX1D tells it to ignore the dial tone and orignate, ATA says answer).
To grab small bits of text, use a clipboard extender and then copy the text to the clipboard. You can then do Install->PasteF to create a box, then you can send it or do other things. If the file already exists, you will be prompted to overwrite, append, or cancel.
Use the prefs menu to turn display of different archive types on and off, and enable or disable confirmations.
The Box and Unbox utilities under Linux/Unix/CLI is the easiest way to box a file (which you need to hotsync) or use the ZBoxZ Conduit and get or put files into the ToBox and Unboxed directories.
Handspring has a problem with conduits, so a WinBox and WinUnBox utility have been included. They bring up the file selector and you can select programs to box (note it isn't confirmed, you will just see a .pdb created in the same directory so don't try it directly on a CDROM), and the UnBox works to unbox a PDB, but will give a save file selector like the Macintosh.
Instead of installing lots of files separately, you can box the original zip and unzip it on the Palm, then install the files and docs.
Handspring Visors currently use PalmOS 3.1, so some things won't work as well or at all. For example, PiNGer will, but the Visor specific program will do 16 level greyscale. RUnZip won't display Icons as this feature was added in 3.2 (but LaunchBox will make it work). PalmOS version 3.3 (Launcher -> Info -> Version) is the minimum for full functionality, and Palm offers an upgrade. And the HandSpring Windows HotSync won't reconize my conduit install.
For Modeming including faxing - You can abort by tapping anywhere or pressing any key (which will only abort and not be recognized). It may take a few seconds, and it may display some other messages quickly as it exits.
This creates a similar looking screen, but file selection is "sticky" and there are All and None buttons which select/deselect all. So you can select multiple files and then tap an operation button.
For example, if you set beam confirm OFF on a remote palm, you can go into alldb -> Batch and mark a dozen databases on the sending palm and tapping beam will transfer ALL of them. On the receiver, enter File -> Batch and mark all the newly transferred .box files and tap Install. All the files will now be stored on the palm.
Also, if you have the bottom to top stroke to beam, it will immediately beam the selections as if the beam button was pressed (in whichever mode the selector is in including alldb and/or batch)
This is also a good way to set the backup bits on multiple files - select all and tap Backup. But this is also dangerous since you can mark all and tell ZBoxZ to delete them. It allows marking Read/only and no-beam files, which won't be deleted or beamed (without any notice).
You can also use this to transfer multiple boxes in one transaction via YModem.
Faxing is documented below.
Running it standalone presents several options:
Note on dialing: The program supplied ATD, so if you append a T, it will use tone, P will use pulse dialing. Then the number follows. Comma pauses for things like when you dial 9.
ZBoxZ and ZFaxZ
There are several functions withing ZBoxZ for Fax support
PNG is a replacement for GIF and supported by most imaging programs. The PNG Home page is at ftp://ftp.freesoftware.com/pub/png/png.html which has information and pointers to conversion programs, sample source, and everything else about PNG files.
Unlike many other imaging programs, it can display pictures of unlimited size, actually they are limited only be the available free memory, but not by dimension. You can scroll around the entire picture or view it reduced it from 1/2 to 1/8th size. It will also display color pictures on a Monochrome Palm in the maximum greyscale level (or for Handspring or any Dragonball EZ running OS 3.1 there is a special unsupported PRC that does 16 level greyscale). Any transfered file (using ZBoxZ to beam) will be displayed at the maximum possible color or grey depth.
PiNGer supports nearly the entire specification including all filter types, interlacing, Alpha (transparency) and background. Basically everything needed to display an image. Text may be added later.
Note that it takes time to decompress and process the images so there may be significant startup time especially for large depth and alpha images. Tapping on the screen will abort the program.
If you are converting others, you may want to save them as GIF first, or use a ColorMap mode with 8 bit RGB samples if you mainly want to display them on the Palm. You can also reduce them to 16 level grey if they won't be used on a color palm. Desktop tools will do better color and grey conversions than the internal routines. Palette files for the Gimp and pnmquant (or you can use pnmdepth - these are linux routines but ports should exist).
If you must, it will also display GIFs.
This is based on my MIDI sequencer, but requires no conversion and only handles uncompressed or GZIPed files (see www.gzip.org for info). Simply box a .MID file (or mff or smf, or MID.gz) and sync it to the palm.
The main screen has buttons with standard icons for play, pause, fast-forward, and stop. (SMF files aren't designed for backing up, so there is no rewind, but there are search/cue functions, see below).
It is mainly designed to use External Hardware which you can find links at Handheld Music, or one of my pages - Scroll down to the PlayMidi Stuff section for links. It works great with Tsunamidi.
The speaker button will play tracks to the Palm Speaker, but remember that it is monophonic so your results may vary. Also this can't handle tracks over 32k gracefully. It will play the first non-disabled track (/T - trk on/off) so you can select which track to play by disabling the prior ones. Also note that if tempo changes aren't in the track, they won't happen.
The Seek has been improved - tapping a digit will seek to the next boundary, e.g. tapping the 10 second digit will cause it to go from 25 to 30.0 seconds, similarly with the measure (from measure 45, tapping the tens digit three times will fastforward to measure 70).
Now you can remember a cue point with the cue menu, it will reseek there.
You can disable any combination of tracks by selecting them with a dialog. Note this disables ALL events including tempo changes and such, so wierd things can happen if you disable the wrong track.
The File name is displayed in the title bar.
The /P (for Play) now selects a MIDI channel, and will play on the palm speaker when the play button is pressed with the display updating, but isn't prioritized, so polyphonic tracks will sound worse. This is an alternative to the internal palm play routine (speaker button).
Track activity is displayed by the roll-flash number bar near the top.
The Comprc program does the compression. For windows, drag and drop a .prc onto the icon, or double click to get an open box. A pdb will be created in the same directory as the prc (This will fail if the prc is in an unwritable location such as a CD). Install the newly created pdb instead of the prc - you can always undo the compression using ZBoxZ on the palm. (Don't use the ToBox directory or you will have to install it).
Under the standard PalmOS launcher (3.2 or later) they will display with the orignal name, version, and icons. Tapping on them will start RUnZip to decompress them (RUnZip does nothing by itself). Palm OS 3.1 or earlier requires LaunchBox to create stubs.
There is as known bug with PalmOS 3.5 (but not on the VII) which will cause the icons to revert to the RUnZip default. LaunchBox stubs won't have this problem.
You can place compressed things into flash or into removable media subject to their restrictions. E.g. you can compress FlashPro and copy it to flash (but the API won't work). Because it always decompresses with the original name to the internal Palm memory (card 0), you will see the program image in any list of databases. If you reset, the original file will then be restored (but the stub and/or compressed databaase will still be there so you might get duplicate icons).
A note on names: Palm uses two mechanisms to put a label under the icon in launcher. There is the database name itself, and there is a "Application Name" resource which is preferred. Stubs, compressed databases, and the original (if there) will have the same icon and name and could cause confusion. You should remove the original application before or just after installing the compressed version to avoid this.
RUnZip files will display in the ZBoxZ file list unless disabled in the preferences.
This program creates launching stubs for launchable databases. The Stub is a tiny Palm application that contains the icons (grabbed and optionally stripped from the database) and just enough code to start up the application the database belongs to.
For now, there are only two launchable database applications I know of, Clipper (web clipping like on the Palm VII), and RUnZip.
Most databases won't need this. However if you use 3rd party launchers (including things like Phlegm hack) that don't recognize launchable databases, or want to assign a RUnZip or Clipper application to a button.
LaunchBox will display a list of all the launchable databases grouped by which application launches, i.e. RUnZip then Clipper. On 3.2 or above, you can select them individually and tap Make Stubs to create the stub applications, or tap All Runzip to convert all RUnZip databases.
On a 3.1 Visor, you can't select them, and tapping either button will simply convert all since Clipper doesn't work and RUnZip needs the stubs to work at all.
1-way will also remove the launchability from the database. For the newer devices, it will prevent duplicate icons, and it will save space since the icons and other launch information will be stripped from the database. There is no reason to have this data on the Visor. If you strip the data, the database will be deleted when the Stub is deleted.
To Clarify, before running LaunchBox/1Way, the space of the databases is either independent or included in the RUnZip size on the launcher info screen. 1Way changes the creator to match the stub, so deleting the stub will also delete the compressed database. Also you can't unRunZip from ZBoxZ if you select 1Way, so it is better to try a new program WITHOUT 1Way, and when you know it works, use it. Also keep the PRCs around since enhancements to the stub (so it can do more launch types like beam receive or some of the parameter passing) will require rerunning LaunchBox.
If you are using multiple cards (e.g. a flash card or ram card for the Visor or Clie), move the database first. You won't be able to use 1-way function, but the stub needs to know where the database will be when run, so it needs to be placed there first. This is experimental.
The stubs will take the launchable database name except prepended with a caret (^). If you don't specify 1-way you will get duplicate icons, and if they use the AppName resource ythey will have the same name. Don't delete the database by mistake.
The stubs should be compatible with the palm: clipper external call mechanism. The palmcall should also work, except it will use more memory (and could fail from that particularly on older Palms) and doesn't preserve the screen as it might need to.
One disadvantage of using LaunchBox 1Way is that you can't use the Launcher to beam the application. However you can use ZBoxZ, and in batch mode send both the ^Xyz stub and _Xyz compressed image.
This is included with ZBoxZ, but doesn't integrate directly with it. It is designed to fix the problem of hotsyncs taking hours when there are thousands of records. ZipSync compresses the pdb (or prc - it works on both) and merges the records so the hotsync will go faster.
ZipSync runs just like RUnZip. For each X.pYY, an X.z.pYY file is produced. Install this second file using the installer (or pilot-link).
SyncUnZip merely needs to be on the Palm and will operate automatically just after the transfer part of the Hotsync finishes. (WARNING: I don't check for free memory so it may fail and I don't present messages - make sure you have enough memory for the uncompressed archive plus 32K or more available).
If SyncUnZip isn't there, uploading it later and tapping on it will cause it to decompress then.
Note that the database and record creation routines on the palm are slow, not horribly slow, but when there are several thousand records it adds up to several minutes even for SyncUnZip. My routine that does the unpacking is fairly optimized but will take some time.
Also note that over all but the fastest links, the upload and decompress will take LESS time than hotsyncing directly. This is useful especially for network or wireless installs.
ReCAP [Not Released Yet] is a simple viewer - it only displays BMPs generated by CapBMP, and they must be displayable on the Palm hardware (e.g. something captured on a IIIc won't display on a V).
The palmzlib homepage is at http://palmzlib.sourceforge.net, and the ZLib hompage is at ftp://ftp.freesoftware.com/pub/infozip/zlib/ and contain more information about how to use this and how it works.