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)
























Man(1) output converted with man2html