icopy

iCopy

A command-line utility written in Go for scanning, copying, and organizing image and video files based on metadata (creation date), with optional checksum generation and source cleanup.

Features

• Scan directories and generate MD5 checksums
• Read image or video creation timestamp metadata
• Organize copied files using configurable directory formats
• Recursive directory traversal
• Force copy and overwrite handling
• Optional removal of source files after copying
• Console logging and file logging (custom.log)

Supported Formats

Video Formats

Image Formats

Prerequisites

• Go installed (compatible with this repository)
• macOS, Linux, or Windows
• Terminal or shell access

Installation

Clone the repository:

git clone https://github.com/evijayan2/icopy.git
cd icopy

Download dependencies:

go mod tidy

Build

To build the project locally, run:

make build

To verify the installation:

make verify

Release

To create release binaries manually:

make release

Binaries will be available in the build/ directory.

Usage

Run directly using Go:

go run main.go [options]

Or using the compiled binary:

./icopy [options]

Command-Line Flags

The following flags are defined exactly as implemented in main.go, including defaults and behavior.

Flag Behavior Notes

• Exactly one of -image or -video should be enabled.
• If -in is not provided, the program exits with an error.
• When -scan=true, files are scanned and validated but not copied.
• -force overrides duplicate and conflict checks.

Directory Format Options

• DATE – Organize files as YYYY-MM-DD/
• YEAR-MONTH – Organize files as YYYY-MM/
• NOF – No folder organization (default)

Examples

Scan and Generate MD5 Checksums

./icopy \
  -scan=true \
  -in=/path/to/media \
  -out=/path/to/output

Copy Images Organized by Year and Month

./icopy \
  -image=true \
  -in=/path/to/photos \
  -out=/backup/photos \
  -dirformat=YEAR-MONTH \
  -recursive=true

Copy Videos Organized by Date

./icopy \
  -video=true \
  -in=/path/to/videos \
  -out=/backup/videos \
  -dirformat=DATE \
  -recursive=true

Copy and Remove Source Files

./icopy \
  -image=true \
  -in=/path/to/media \
  -out=/organized \
  -recursive=true \
  -removesource=true

Warning: Source files are permanently deleted after a successful copy.

Force Copy with Overwrite

./icopy \
  -image=true \
  -in=/src \
  -out=/dest \
  -force=true \
  -overwrite=yes

Logging

• Logs are written to the console
• A detailed log file is created as custom.log
• Errors, skipped files, and copied files are summarized

Best Practices

• Run with -scan=true before copying large datasets
• Avoid -removesource until results are verified
• Use YEAR-MONTH format for large photo libraries
• Redirect output to a file for auditing

./icopy ...options... > icopy.log 2>&1

Typical Use Cases

• Organizing phone or camera photos
• Backing up large video collections
• Cleaning and structuring legacy media archives

License

Refer to the repository for license information.