           pilot-foto        -        Palm        'Foto'        Image
           Installer/Remover/Fetcher/Converter

## SECTION

           pilot-link: Userland Conduits

## SYNOPSIS

           pilot-foto  [-p|--port  <port>]  [--version]  [-q|--quiet]
           [-?|--help]    [--usage]    [-d|--delete]   [--delete-all]
           [-i|--install] [-l|--list]  [-f|--fetch]  [-F|--fetch-all]
           [-c|--convert]

## DESCRIPTION

           This  is a palm conduit to fetch, install, or remove, Foto
           files from a Palm. It can  also  convert  *.jpg.pdb  files
           that  have  already  been  fetched  from  the Palm to jpeg
           files.

           o Delete all, or named fotos from handheld.

           o Install one, or many jpeg images to handheld.

           o List all jpeg files and thumbnails on handheld.

           o Fetch all jpeg files, or certain ones by name.

           o Tries to detect if a file really is a jpeg  and  refuses
             to install it, if it is not.

           pilot-foto  allows  you  to  do multiple operations in one
           sync. For instance, delete test.jpg and install  test.jpg.

## USAGE

           pilot-foto -p <port> [options] file

## OPTIONS

       PILOT-FOTO OPTIONS
           -d, --delete
                  Delete a jpg file on the handheld

           --delete-all
                  Delete ALL jpg files on the handheld

           -i, --install
                  Install a jpg file

           -l, --list
                  List all photos and thumbnails

           -f, --fetch
                  Fetch files from the Palm

           -c, --convert
                  convert [file].jpg.pdb files to jpg

       CONDUIT OPTIONS
           -p, --portport
                  Use  device  file port to communicate with the Palm
                  handheld. If this is not specified, pilot-foto will
                  look  for  the  $PILOTPORT environment variable. If
                  neither are  found  or  supplied,  pilot-foto  will
                  print the usage information.

           -q, --quiet
                  Suppress 'Hit HotSync button' message

           -v, --version
                  Display version of pilot-foto and exit without con-
                  necting.

       HELP OPTIONS
           -h, --help
                  Display the help synopsis for pilot-foto  and  exit
                  without connecting.

           --usage
                  Display a brief usage message and exit without con-
                  necting.

## EXAMPLES

                    Examples:
                    pilot-foto -p /dev/pilot -f
                    pilot-foto -d MyImage.jpg
                    pilot-foto -i MyImage.jpg
                    pilot-foto -i *.jpg
                    pilot-foto -f MyImage
                    pilot-foto -c MyImage.jpg.pdb

## PROBLEMS

           o Palm has not published their  database  format  for  the
             thumbnails. So, pilot-foto puts a generic penguin thumb-
             nail for every image uploaded. Fotos can be accessed  by
             a  named list on the handheld as well as the thumbnails.
             This has been tried on a couple of handhelds. It is pos-
             sible  that  a  foreign palm or different model will not
             like it.

           o To get a thumbnail image you can copy the jpegs  to  the
             memory  card. If you copy them back to the handheld they
             will have a new thumbnail that matches the jpeg.

## AUTHOR

## BUGS

           o If a jpeg is installed with the same name as one already
             on the palm you will have 2 thumbnails pointing  to  the
             same jpeg. The new jpeg will overwrite the old jpeg.

           o If  the  thumbnail fails to install then the jpeg should
             be removed. It is not.

## COPYRIGHT

           This program is free software;  you  can  redistribute  it
           and/or modify it under the terms of the GNU General Public
           License as published  by  the  Free  Software  Foundation;
           either  version  2 of the License, or (at your option) any
           later version.

           This program is distributed in the hope that  it  will  be
           useful, but WITHOUT ANY WARRANTY; without even the implied
           warranty of MERCHANTABILITY or FITNESS  FOR  A  PARTICULAR
           PURPOSE.  See  the  GNU  General  Public  License for more
           details.

           You should have received a copy of the GNU General  Public
           License along with this program; if not, write to the Free
           Software Foundation, Inc., 59  Temple  Place,  Suite  330,
           Boston, MA 02111-1307 USA

## SEE ALSO

           pilot-link(7)