GPhoto: Difference between revisions

From ArchWiki
(Fix section level.)
(update status of external links)
Tags: wiki-scripts Manual revert
 
(22 intermediate revisions by 13 users not shown)
Line 1: Line 1:
[[Category:Imaging]]
{{Lowercase title}}
[[es:Digital Cameras]]
[[Category:Digital imaging]]
[[it:Digital Cameras]]
[[Category:Lists of software]]
[[ja:デジタルカメラ]]
[[Category:Input devices]]
[[ru:Digital Cameras]]
[[es:GPhoto]]
[[zh-hans:Libgphoto2]]
[[ja:GPhoto]]
[http://www.gphoto.org/proj/libgphoto2/ Libgphoto2] is the core library designed to allow access to digital cameras by external (front end) programs, such as Digikam and gphoto2. The current 'officially' supported cameras are [http://www.gphoto.org/proj/libgphoto2/support.php here] (though more may work).
[[ru:GPhoto]]
[[zh-hans:GPhoto]]
[http://www.gphoto.org/proj/libgphoto2/ Libgphoto2] is the core library designed to allow access to digital cameras by external (front-end) programs, such as digiKam and gPhoto2. List of officially supported cameras is available on the [http://www.gphoto.org/proj/libgphoto2/support.php official website] (though more may work).


This article documents the configuration of {{ic|libgphoto2}} to access digital cameras. Some digital cameras will mount as normal [[USB storage devices]] and may not require the use of libgphoto2.
This article documents the configuration of {{ic|libgphoto2}} to access digital cameras. Some digital cameras will mount as normal [[USB storage devices]] and may not require the use of libgphoto2.
Line 15: Line 17:
=== Frontend applications ===
=== Frontend applications ===


* {{App|[[Wikipedia:darktable|darktable]]|Utility to organize and develop raw images.|http://darktable.org/|{{Pkg|darktable}}}}
* {{App|[[Wikipedia:Darktable|Darktable]]|Utility to organize and develop raw images.|https://darktable.org/|{{Pkg|darktable}}}}
* {{App|[[Digikam|digiKam]]|Digital photo management application for [[KDE]].|https://www.digikam.org/|{{Pkg|digikam}}}}
* {{App|[[Digikam|digiKam]]|Digital photo management application for [[KDE]].|https://www.digikam.org/|{{Pkg|digikam}}}}
* {{App|Entangle|Provides a graphical interface for “tethered shooting”, aka taking photographs with a digital camera completely controlled from the computer.|https://entangle-photo.org/|{{AUR|entangle}}}}
* {{App|Entangle|Provides a graphical interface for “tethered shooting”, aka taking photographs with a digital camera completely controlled from the computer.|https://entangle-photo.org/|{{AUR|entangle}}}}
* {{App|gphotofs|[[Fuse]] module to mount camera as a filesystem.|http://www.gphoto.org/proj/gphotofs/|{{AUR|gphotofs}}}}
* {{App|gphotofs|[[Fuse]] module to mount camera as a filesystem.|http://www.gphoto.org/proj/gphotofs/|{{AUR|gphotofs}}}}
* {{App|[[Wikipedia:GThumb|gThumb]]|Image browser and viewer for [[GNOME]].|http://wiki.gnome.org/gthumb|{{Pkg|gthumb}}}}
* {{App|[[Wikipedia:GThumb|gThumb]]|Image browser and viewer for [[GNOME]].|https://wiki.gnome.org/action/show/Apps/Gthumb|{{Pkg|gthumb}}}}
* {{App|GTKam|Graphical [[GTK+]] 2 front-end to gphoto2.|http://www.gphoto.org/proj/gtkam/|{{AUR|gtkam}}}}
* {{App|GTKam|Graphical [[GTK]] 2 front-end to gPhoto2.|http://www.gphoto.org/proj/gtkam/|{{AUR|gtkam}}}}
* {{App|gvfs-gphoto2|gphoto2 backend for GVfs to mount camera as a filesystem from a file manager that supports GVfs such as [[GNOME Files]], [[Nemo]], [[PCManFM]] and [[Thunar]].|https://wiki.gnome.org/Projects/gvfs|{{Pkg|gvfs-gphoto2}}}}
* {{App|gvfs-gphoto2|GPhoto2 backend for GVfs to mount camera as a filesystem from a file manager that supports GVfs such as [[GNOME Files]], [[Nemo]], [[PCManFM]] and [[Thunar]].|https://wiki.gnome.org/Projects/gvfs|{{Pkg|gvfs-gphoto2}}}}
* {{App|Kamera|[[KDE]] integration for gphoto2 cameras.|https://github.com/KDE/kamera|{{Pkg|kamera}}}}
* {{App|Kamera|[[KDE]] integration for gPhoto2 cameras.|https://github.com/KDE/kamera|{{Pkg|kamera}}}}
* {{App|Pantheon Photos|Image viewer for Pantheon.|https://launchpad.net/pantheon-photos|{{Pkg|pantheon-photos}}}}
* {{App|Pantheon Photos|Image viewer for Pantheon.|https://launchpad.net/pantheon-photos|{{Pkg|pantheon-photos}}}}
* {{App|[[Wikipedia:Rawstudio|Rawstudio]]|An open source raw-image converter written in GTK+. Supports tethered shooting with gphoto2.|https://rawstudio.org/|{{AUR|rawstudio}}}}
* {{App|Rapid Photo Downloader|Download photos and videos from cameras, memory cards and portable storage devices.|https://www.damonlynch.net/rapid/|{{Pkg|rapid-photo-downloader}}}}
* {{App|[[Wikipedia:Shotwell (software)|Shotwell]]|Digital photo organizer designed for [[GNOME]].|http://wiki.gnome.org/Apps/Shotwell|{{Pkg|shotwell}}}}
* {{App|[[Wikipedia:Rawstudio|Rawstudio]]|An open source raw-image converter written in GTK. Supports tethered shooting with gPhoto2.|https://rawstudio.org/|{{AUR|rawstudio}}}}
* {{App|[[Wikipedia:Shotwell (software)|Shotwell]]|Digital photo organizer designed for [[GNOME]].|https://wiki.gnome.org/Apps/Shotwell|{{Pkg|shotwell}}}}


== GPhoto2 usage ==
== GPhoto2 usage ==
Line 36: Line 39:
* {{ic|gphoto2 --list-ports}}
* {{ic|gphoto2 --list-ports}}
* {{ic|gphoto2 --auto-detect}}
* {{ic|gphoto2 --auto-detect}}
* {{ic|gphoto2 --abilities}}
* {{ic|gphoto2 --summary}}
* {{ic|gphoto2 --summary}}
* {{ic|gphoto2 --list-files}}
* {{ic|gphoto2 --list-files}}
* {{ic|gphoto2 --get-all-files}}
* {{ic|gphoto2 --get-all-files}}
* {{ic|gphoto2 --capture-image-and-download}}
* {{ic|1=gphoto2 --set-config datetime=now}} - sets the camera to the current time
* {{ic|1=gphoto2 --set-config datetime=now}} - sets the camera to the current time


Line 44: Line 49:
* {{ic|gphoto2 --shell}}
* {{ic|gphoto2 --shell}}


=== Example usage with gvfs  ===
{{Tip|With {{ic|gphoto2 --capture-movie}} it is possible to use supported cameras as a webcam. See [[v4l2loopback#Using a photo camera as webcam with gPhoto]] for details.}}
 
=== Example usage with GVfs ===
 
Auto detect the connected camera and list the required port:
Auto detect the connected camera and list the required port:


$ gphoto2 --auto-detect
{{hc|$ gphoto2 --auto-detect|
Model                          Port                                          
Model                          Port
----------------------------------------------------------
<nowiki>----------------------------------------------------------</nowiki>
Canon Digital IXUS 980 IS      usb:006,011  
Canon Digital IXUS 980 IS      usb:006,011
Now open your favorite file manager and enter the address with the found port detail "gphoto2://[usb:006,011]" - the camera will be mounted with gvfs and can be managed with the file manager.
}}


== Permission issues ==
Now open your favorite [[file manager]] and enter the address with the found port detail {{ic|gphoto2://[usb:006,011]}}. [[File manager functionality#Mounting]] will use {{pkg|gvfs}} to get the camera mounted and manageable with the file manager.
 
== Troubleshooting ==
 
=== Permission issues ===


Users with a local session have permissions granted for cameras using [[Wikipedia:Access control list|ACLs]]. See [[General troubleshooting#Session permissions]] if it does not work.
Users with a local session have permissions granted for cameras using [[Wikipedia:Access control list|ACLs]]. See [[General troubleshooting#Session permissions]] if it does not work.


== See also ==
=== Claimed device ===
 
Your system might automatically mount the camera as a file system and then some gphoto2 commands output the error message "cannot claim device". In this case unmount the camera using your file browser or run:


* [http://www.gphoto.org/proj/libgphoto2/support.php A list of cameras supported by gPhoto]
$ gio mount -s gphoto2
* [http://www.teaser.fr/~hfiguiere/linux/digicam.html another more detailed list]

Latest revision as of 19:12, 29 October 2023

Libgphoto2 is the core library designed to allow access to digital cameras by external (front-end) programs, such as digiKam and gPhoto2. List of officially supported cameras is available on the official website (though more may work).

This article documents the configuration of libgphoto2 to access digital cameras. Some digital cameras will mount as normal USB storage devices and may not require the use of libgphoto2.

Installation

Install the libgphoto2 package, and optionally gphoto2 to have a command line interface.

Frontend applications

  • Darktable — Utility to organize and develop raw images.
https://darktable.org/ || darktable
  • digiKam — Digital photo management application for KDE.
https://www.digikam.org/ || digikam
  • Entangle — Provides a graphical interface for “tethered shooting”, aka taking photographs with a digital camera completely controlled from the computer.
https://entangle-photo.org/ || entangleAUR
  • gphotofsFuse module to mount camera as a filesystem.
http://www.gphoto.org/proj/gphotofs/ || gphotofsAUR
https://wiki.gnome.org/action/show/Apps/Gthumb || gthumb
  • GTKam — Graphical GTK 2 front-end to gPhoto2.
http://www.gphoto.org/proj/gtkam/ || gtkamAUR
  • gvfs-gphoto2 — GPhoto2 backend for GVfs to mount camera as a filesystem from a file manager that supports GVfs such as GNOME Files, Nemo, PCManFM and Thunar.
https://wiki.gnome.org/Projects/gvfs || gvfs-gphoto2
  • KameraKDE integration for gPhoto2 cameras.
https://github.com/KDE/kamera || kamera
  • Pantheon Photos — Image viewer for Pantheon.
https://launchpad.net/pantheon-photos || pantheon-photos
  • Rapid Photo Downloader — Download photos and videos from cameras, memory cards and portable storage devices.
https://www.damonlynch.net/rapid/ || rapid-photo-downloader
  • Rawstudio — An open source raw-image converter written in GTK. Supports tethered shooting with gPhoto2.
https://rawstudio.org/ || rawstudioAUR
https://wiki.gnome.org/Apps/Shotwell || shotwell

GPhoto2 usage

GPhoto2 is a command line client for libgphoto2. GPhoto2 allows access to the libgphoto2 library from a terminal or from a script shell to perform any camera operation that can be done. This is the main user interface.

GPhoto2 also provides convenient debugging features for camera driver developers.

Quick Commands

  • gphoto2 --list-ports
  • gphoto2 --auto-detect
  • gphoto2 --abilities
  • gphoto2 --summary
  • gphoto2 --list-files
  • gphoto2 --get-all-files
  • gphoto2 --capture-image-and-download
  • gphoto2 --set-config datetime=now - sets the camera to the current time

For advanced file manipulation, use

  • gphoto2 --shell
Tip: With gphoto2 --capture-movie it is possible to use supported cameras as a webcam. See v4l2loopback#Using a photo camera as webcam with gPhoto for details.

Example usage with GVfs

Auto detect the connected camera and list the required port:

$ gphoto2 --auto-detect
Model                          Port
----------------------------------------------------------
Canon Digital IXUS 980 IS      usb:006,011

Now open your favorite file manager and enter the address with the found port detail gphoto2://[usb:006,011]. File manager functionality#Mounting will use gvfs to get the camera mounted and manageable with the file manager.

Troubleshooting

Permission issues

Users with a local session have permissions granted for cameras using ACLs. See General troubleshooting#Session permissions if it does not work.

Claimed device

Your system might automatically mount the camera as a file system and then some gphoto2 commands output the error message "cannot claim device". In this case unmount the camera using your file browser or run:

$ gio mount -s gphoto2