photo-organiser

command module
v0.0.12 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 16, 2026 License: MIT Imports: 14 Imported by: 0

README

photo-organiser

Go Reference Go Report Card

Organise camera photos into a date-based directories and sync them to a remote server with rsync.

Installation

From Source
git clone https://github.com/DistroByte/photo-organiser.git
cd photo-organiser
go build -o photo-organiser
With Go Install
go install github.com/DistroByte/photo-organiser@latest

Usage

Basic Example
photo-organiser sony --device /dev/sdd1 --host remote.host --user username --remote-path /path/on/remote

By default, the tool will use <mount-point>/DCIM as the source directory, in this case /mnt/camera/DCIM. To specify a different source directory:

photo-organiser sony --device /dev/sdd1 --directory /mnt/camera --source /mnt/camera/DCIM/10750715 --host remote.host --remote-path /remote/photos/path
Flags
      --device string        device to mount (default "/dev/sdd1")
      --directory string     mount point (default "/dev/camera")
  -n, --dry-run              will not move files, copy them to the remote, or cleanup source directories
  -h, --help                 help for photo-organiser
      --host string          remote host for rsync
      --mount-type string    filesystem type for mounting (default "exfat")
      --remote-path string   remote destination path for rsync
      --source string        source directory containing the photos. (default /mount/point/DCIM)
      --user string          remote user for rsync (default "$USER")
  -v, --verbose              enable debug logging
Example Full Command
photo-organiser sony --device /dev/sdd1 --directory /mnt/camera --host dionysus.internal --user distro --remote-path /volume1/homes/distro/Photos/Sony

License

MIT

Documentation

Overview

Photo-organiser is a CLI tool that organises camera photos into a directory structure based on the date they were taken.

Available Commands:

canon       Organise Canon camera photos
completion  Generate the autocompletion script for the specified shell
dji         Organise DJI camera (action/drone) photos
help        Help about any command
sony        Organise Sony camera photos (default)
version     Print version information

Flags:

    --device string        device to mount (default "/dev/sdd1")
    --directory string     mount point (default "/dev/camera")
-n, --dry-run              will not move files, copy them to the remote, or cleanup source directories
-h, --help                 help for photo-organiser
    --host string          remote host for rsync
    --mount-type string    filesystem type for mounting (default "exfat")
    --remote-path string   remote destination path for rsync
-s, --source string        source directory containing the photos. (default /mount/point/DCIM)
    --user string          remote user for rsync (default "james")
-v, --verbose              enable debug logging

Example usage:

photo-organiser sony --host remote.host --user username --remote-path /path/on/remote

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL