kapy

Kapy is a simple utility designed to copy digital camera photos from an SD card to a disk with transformations. This tool streamlines the process of transferring photos from your camera to your computer, while also providing the ability to make any necessary image transformations during the copying process.

• Convert from JPEG to HEIC/AVIF to reduce image size
• Merge GPS information into EXIF from .gpx files on Google Drive
• Adjust image size and compression ratio based on EXIF rate information

Build

Build on macOS

If you use Homebrew (https://brew.sh/), you can easily install the required packages.
After installing Homebrew, you can install the required packages and build the application by running the following command:

shell $ brew install pkg-config imagemagick exiv2 libssh $ CLIENT_ID={YOUR_CLIENT_ID} CLIENT_SECRET={YOUR_SECRET} cargo build

If you are not using Homebrew, please install the required packages below and set the corresponding environment variables accordingly:

• ImageMagick library (https://imagemagick.org/script/download.php)
  • IMAGEMAGICKDIR - installation directory of ImageMagick
  • IMAGEMAGICKLIBDIRS - list of lib directories split by :
  • IMAGEMAGICKINCLUDEDIRS - list of include directories split by :
  • IMAGEMAGICKLIBS - list of the libs to link to
• Exiv2 library (https://exiv2.org/download.html)
  • EXIV2INCLUDEDIRS - list of include directories split by :
  • EXIV2LIBDIRS - list of lib directories split by :
• libssh library (https://www.libssh.org/get-it/)
  • LIBSSHINCLUDEDIRS - list of include directories split by :
  • LIBSSHLIBDIRS - list of lib directories split by :

Build on Windows

Pre-requirements

• ImageMagick library (https://imagemagick.org/script/download.php)
  • Provides pre-built binary installers.
  • When installing, the checkbox for installing C/C++ header files should be selected.
  • You need to set the following Windows environment variable:
  • IMAGEMAGICKDIR={YOURMAGICKINSTALLATION_DIR}
• Exiv2 library (https://exiv2.org/download.html)
  • Provides pre-built binaries as .zip compressed files.
  • You need to set the following Windows environment variables:
  • EXIV2INCLUDEDIRS={YOUREXIV2INCLUDEDIR}
  • EXIV2LIBDIRS={YOUREXIVLIBDIR}
• libssh library (https://www.libssh.org/get-it/)
  • Provided as a package in vcpkg the Microsoft's package manager.
  • vcpkg (https://vcpkg.io/en/getting-started.html) should be installed first.
  • After installation, install the library: vcpkg install libssh
  • You need to set the following Windows environment variables:
  • LIBSSHINCLUDEDIRS={YOURLIBSSHINCLUDEDIR}
  • LIBSSHLIBDIRS={YOURLIBSSHLIBDIR}
• clang library (https://releases.llvm.org/download.html)
  • Provides pre-built binary installers.
  • You need to set the following Windows environment variable:
  • LIBCLANGPATH={YOURLLVMBINDIR}
• NASM executable (https://www.nasm.us/)
  • Provides pre-built binary installer and only executables
  • You need to add the directory where executables were installed to your PATH.

Build

```shell

set CLIENTID={YOURCLIENTID} set CLIENTSECRET={YOURSECRET} set IMAGEMAGICKDIR={YOURMAGICKINSTALLATIONDIR} set EXIV2INCLUDEDIRS={YOUREXIV2INCLUDEDIR} set EXIV2LIBDIRS={YOUREXIVLIBDIR} set LIBSSHINCLUDEDIRS={YOURLIBSSHINCLUDEDIR} set LIBSSHLIBDIRS={YOURLIBSSHLIBDIR} set LIBCLANGPATH={YOURLLVMBINDIR} cargo build ```

Usage

shell $ kapy clone -c ~/.kapy.yaml --from /Volumes/Untitled/DCIM/108HASBL --to ~/images

Disclaimer

To access Google Drive API using your own Google OAuth 2.0 clientid and clientsecret, you will need to set up a project on the Google Developers Console and create OAuth 2.0 credentials. Once you have obtained your credentials, you can set the CLIENTID and CLIENTSECRET as environment variables or include them directly in your code.

shell $ CLIENT_ID={YOUR_CLIENT_ID} CLIENT_SECRET={YOUR_SECRET} kapy login $ kapy clone

If you encounter login issues, you can log in again as follows.

shell $ kapy clean $ CLIENT_ID={YOUR_CLIENT_ID} CLIENT_SECRET={YOUR_SECRET} kapy login

Or, you can assign CLIENTID and CLIENTSECRET values at compile time.

```shell $ CLIENTID={YOURCLIENTID} CLIENTSECRET={YOUR_SECRET} cargo install kapy

OR

$ CLIENTID={YOURCLIENTID} CLIENTSECRET={YOUR_SECRET} cargo build ```

The Google Drive API has a strict application approval process since it can access users' sensitive information. This application was originally created for my personal use, and it is difficult to comply with Google's strict approval process. You should refer to the following document to generate your own Google OAuth 2.0 credentials:

https://developers.google.com/identity/protocols/oauth2/native-app

The following API scopes must be specified:

• https://www.googleapis.com/auth/drive.metadata.readonly: See information about your Google Drive files.
• https://www.googleapis.com/auth/drive.readonly: See and download all your Google Drive files.

Configurations

• An example ```yaml default_path: from: /Volumes/Untitled/DCIM/108HASBL to: ~/images polices:
• rate: [5] commands: resize: 100% # default value; ignore it format: preserve # default value
• rate: [4] commands: quality: 95% format: heic
• rate: [1,2,3] commands: resize: 50% # resize image to 50% quality: 95% format: heic
• rate: [0] commands: resize: 36m # resize image to 36m pixels quality: 92% format: heic ```