pilot-foto

1 Copyright 1996-2007 FSF

pilot-foto

Palm 'Foto' Image Installer/Remover/Fetcher/Converter

## Section

pilot-link: Userland conduits

## synopsis

pilot-foto [`-p`|`--port` <`port`>] [`--version`] [`-?`|`--help`] [`-q`|`--quiet`] [`--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.

- Delete all, or named fotos from handheld.

- Install one, or many jpeg images to handheld.

- List all jpeg files and thumbnails on handheld.

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

- 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

`-F`, `--fetch-all`

- Fetch ALL jpg files from the Palm

`-c`, `--convert`

- convert `[file].jpg.pdb` files to jpg

### Conduit Options

`-p`, `--port` `port`

- 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 connecting.

### Help Options

`-h`, `--help`

- Display the help synopsis for pilot-foto and exit without connecting.

`--usage`

- Display a brief usage message and exit without connecting.

## 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

- Palm has not published their database format for the thumbnails. So, pilot-foto puts a generic penguin thumbnail 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 possible that a foreign palm or different model will not like it.

- 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

This manual page was converted to XML by Neil Williams linux@codehelp.co.uk

## Bugs

- 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.

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

We have an online bug tracker. Using this is the only way to ensure that your bugs are recorded and that we can track them until they are resolved or closed. Reporting bugs via email, while easy, is not very useful in terms of accountability. Please point your browser to http://bugs.pilot-link.org and report your bugs and issues there.

## 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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

## See Also

pilot-link(7)