GPHOTO2(1)

NAME
gphoto2 - command-line gphoto2 client

SYNOPSIS
gphoto2 [--debug] [-q | --quiet] [-v | --verbose] [-h | --help]
        [--list-cameras] [--usb-usermap-script NAME]
        [--print-usb-usermap] [--list-ports] [--stdout]
        [--stdout-size] [--auto-detect] [--port PATH]
        [--speed SPEED] [--camera MODEL] [--filename FILENAME]
        [--usbid USBID] [-a | --abilities] [--folder FOLDER]
        [[-R | --recurse] | --norecurse] [-l | --list-folders]
        [-L | --list-files] [-m NAME | --mkdir NAME]
        [-r NAME | --rmdir NAME] [-n | --num-files]
        [-p RANGE | --get-file RANGE] [-P | --get-all-files]
        [-t RANGE | --get-thumbnail RANGE]
        [-T | --get-all-thumbnails]
        [-r RANGE | --get-raw-data RANGE] [--get-all-raw-data]
        [--get-audio-data RANGE] [--get-all-audio-data]
        [-d RANGE | --delete-file RANGE] [-D | --delete-all-files]
        [-u FILENAME | --upload-file FILENAME] [--capture-preview]
        [--capture-image] [--capture-movie] [--capture-sound]
        [--capture-show-info RANGE]
        [--summary] [--manual] [--about] [--shell]

DESCRIPTION

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

--usb-usermap-script NAME
    Use NAME as the hotplug usb script used in the output of --print-usb-usermap. Default is "usbcam".

--print-usb-usermap
    For every camera supported by your version of gphoto2, print the corresponding line for inclusion into the usb.usermap hotplug config file. The script name used in these lines is specified with the --usb-usermap-script option.

--list-ports
    List supported port devices.

--stdout
    Send file to stdout.

--stdout-size
    Print filesize before data.

--auto-detect
    List auto-detected cameras.

--port PATH
    Specify port device.

--speed SPEED
    Specify serial transfer speed.

--camera MODEL
    Specify camera model. 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".

--filename FILENAME
    Specify a filename.

--usbid USBID
    (Expert only) Override USB IDs.

-a, --abilities
    Display camera abilities.

-f, --folder FOLDER
    Specify camera folder (default="/").

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

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

--delete-files RANGE
    Delete files given in range.

--delete-all-files
    Delete all files in folder.

-u, --upload-file FILENAME
    Upload a file to camera.

--capture-preview
    Capture a quick preview.

--capture-image
    Capture an image.

--capture-movie
    Capture a movie.

--capture-sound
    Capture an audio clip.

--show-info RANGE
    Show info.

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

SHELL MODE

The following commands are available:

cd  Change to a directory on the camera.

lcd Change to a directory on the local machine.

exit, quit, q
    Exit the gphoto2 shell.

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.

ls  List the contents of the current directory on the camera.

SEE ALSO

gphoto2(3), gphoto2.txt, gphoto2-cli.txt, http://www.gphoto.org/

EXAMPLES

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.

gphoto2 --usb-usermap-script gphoto2cam --print-usb-usermap >> /etc/hotplug/usb.usermap
    Append a line to the hotplug config file /etc/hotplug/usb.usermap for every supported camera, using /etc/hotplug/usb/gphoto2cam for setting up permissions correctly.

AUTHOR
The gPhoto2 Team.
Man page edited by Tim Waugh <twaugh@redhat.com>.