gphoto2 - command-line gphoto2 client

libgphoto2(3) is a cross-platform digital camera library, and gphoto2(1) is a command-line client for it.

Where an option takes a range of files, thumbnails, or other data, they are numbered beginning at 1. A range is a comma-separated list of numbers or spans (``first-last''). Ranges are XOR (exclusive or), so that ``1-5,3,7'' is equivalent to ``1,2,4,5,7''.

--debug

Turn on debugging.

-q, --quiet

Quiet output (default=verbose).

-v, --version

Display version and exit.

-h, --help

Display a short usage message.

--list-cameras

List supported camera models.

--list-ports

List supported port devices.

--stdout

Send file to stdout.

--stdout-size

Print filesize before data.

--auto-detect

List auto-detected cameras and the ports to which they are connected.

--port PATH

Specify port device. The --list-ports prints a list of valid, usable ports. In case of multiple USB cameras, the --auto-detect shows you the specific port each camera is connected to.

--speed SPEED

Specify serial transfer speed.

--camera MODEL

Specify camera model. The --list-cameras option prints a list of all explicitly supported cameras.

Most model names contain spaces: remember to enclose the name in quotes so that the shell knows it is one parameter. For example: --camera "Kodak DC240".

Note that if you specify --camera, you must also specify --port. Otherwise the --camera option will be silently ignored.

--filename FILENAME

Specify the filename to use when saving downloaded files. The --filename option accepts %a, %A, %b, %B, %d, %H, %k, %I, %l, %j, %m, %M, %S, %y, %%, (see date(1)) and, in addition, %n for the number, %C for the filename suffix, and %f for the filename without suffix.

--usbid USBIDS

(Expert only) Override USB IDs. USBIDSmust be of the form DetectedVendorID:DetectedProductID=TreatAsVendorID:TreatAsProductID to treat any USB device detected as DetectedVendorID:DetectedProductID asTreatAsVendorID:TreatAsProductID instead. All the VendorIDs and ProductIDs should be hexadecimal numbers beginning in C notation, i.e. beginning with '0x'.

Example: --usbid 0x4a9:0x306b=0x4a9:0x306c

-a, --abilities

Display camera abilities.

-f, --folder FOLDER

Specify camera folder (default="/").

--filename FILENAME

Specify the filename to use when saving downloaded files. The --filename option accepts %a, %A, %b, %B, %d, %H, %k, %I, %l, %j, %m, %M, %S, %y, %%, (see date(1)) and, in addition, %n for the number, %C for the filename suffix, and %f for the filename without suffix.

-R, --recurse

Recursion (default for download).

--no-recurse

No recursion (default for deletion).

-l, --list-folders

List folders in folder.

-L, --list-files

List files in folder.

-m, --mkdir NAME

Create a directory.

-r, --rmdir NAME

Remove a directory.

-n, --num-files

Display number of files.

-p, --get-file RANGE

Get files given in range.

-P, --get-all-files

Get all files from folder.

-t, --get-thumbnail RANGE

Get thumbnails given in range.

-T, --get-all-thumbnails

Get all thumbnails from folder.

--get-raw-data RANGE

Get raw data given in range.

--get-all-raw-data

Get all raw data from folder.

--get-audio-data RANGE

Get audio data given in range.

--get-all-audio-data

Get all audio data from folder.

--force-overwrite

Overwrite files without asking.

--new

Only get not already downloaded files. This option depends on camera support of flagging already downloaded images and is not available for all drivers.

-d, --delete-files RANGE

Delete files given in range.

-D, --delete-all-files

Delete all files in folder.

-u, --upload-file FILENAME

Upload a file to camera.

--capture-preview

Capture a quick preview.

-F COUNT, --frames COUNT

Number of frames to capture in one run. Default is infinite number of frames.

-I SECONDS, --interval SECONDS

Time between capture of multiple frames.

--capture-image

Capture an image.

--capture-movie

Capture a movie.

--capture-sound

Capture an audio clip.

--show-info RANGE

Show info.

--list-config

List all configuration entries.

--get-config CONFIGENTRY

Get the specified configuration entry.

--set-config CONFIGENTRY=CONFIGVALUE

Get the specified configuration entry.

--summary

Summary of camera status.

--manual

Camera driver manual.

--about

About the camera driver.

--shell

Start the gphoto2 shell, an interactive environment. See SHELL MODE for a detailed description.

The following commands are available:

cd

Change to a directory on the camera.

ls

List the contents of the current directory on the camera.

lcd

Change to a directory on the local machine.

get

Download the file to the current directory.

get-thumbnail

Download the thumbnail to the current directory.

get-raw

Download raw data to the current directory.

show-info

Show information.

delete

Delete a file or directory.

show-exif

Show EXIF information (only if compiled with EXIF support).

help, ?

Displays command usage.

exit, quit, q

Exit the gphoto2 shell.

libgphoto2(3), The gPhoto2 Manual, http://www.gphoto.org/: http://www.gphoto.org/

gphoto2 --list-ports

Shows what kinds of ports (USB and serial) you have.

gphoto2 --auto-detect

Shows what camera(s) you have connected.

gphoto2 --list-files

List files on camera.

gphoto2 --get-file 7-13

Get files number 7 through 13 from the list output by gphoto2 --list-files.

The gPhoto2 Team.

Man page edited by Tim Waugh[ twaugh at redhat dot com ].