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.

• 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)
• High Performance: Partial hashing for large files and configurable concurrency
• Visual Feedback: Real-time progress spinner with current file status

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

brew tap evijayan2/icopy
brew install icopy

1. Go to the Releases Page.
2. Download the archive for your OS:
   • Windows: icopy-windows-amd64.zip
   • Linux: icopy-linux-amd64.tar.gz
3. Extract the archive.
4. (Optional) Move the binary to a folder in your PATH (e.g., /usr/local/bin on Linux).

Clone the repository:

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

Download dependencies:

go mod tidy

To build the project locally, run:

make build

To verify the installation:

make verify

To create release binaries manually:

make release

Binaries will be available in the build/ directory.

Run directly using Go:

go run main.go [options]

Or using the compiled binary:

icopy [options]

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

• 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.
• -fast-hash significantly speeds up scanning large video files by hashing only the beginning, middle, and end.

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

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

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

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

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

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

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

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

• 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

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

Refer to the repository for license information.