Metadata-Version: 2.3
Name: sdcopy
Version: 0.3.0
Summary: Tool for saving files off SD cards
License: MIT
Author: Dmitry Gerasimenko
Author-email: kiddima@gmail.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Utilities
Project-URL: Repository, https://github.com/kidig/sdcopy
Description-Content-Type: text/markdown

# sdcopy

`sdcopy` is a command-line tool designed to copying files from your camera or any SD cards
into structured folders based on the last modified time.

The tool offers flexibility command-line options,
allowing you to customize the destination folder structure and handle different type of files effectively.

## Features

- **Timestamp-based Organization**: Files are copied to the destination directory with folders
  structured according to their modification timestamps.
- **Concurrent Execution**: Utilized multithreading for faster file copying.
- **Dry-run Mode**: Preview the file organization without actually making changes.

## Installation

- Ensure you have Python 3.11.x installed
- Install project via pip: `pip install sdcopy`

## Usage


### Command-line Options

Usage: `sdcopy [OPTIONS] [SOURCE]... DEST`

* `SOURCE`: Source directory/directories from which files will be copied.
* `DEST`: Destination directory where organized files will be copied. It accepts `strftime` format: `%Y-%m-%d`
* `--ext`: Only selected file extensions will be processed.
* `--dry-run`: Perform a trial run without making changes.
* `--threads`: Number of concurrent thread for file copying (default: 4).

Example command: copying jpg/jpeg files into separate folders by file modified time and `YYYY-MM-DD` format
```bash
sdcopy /path/to/source /path/to/destination/%Y-%m-%d/ --ext jpg jpeg"
```

## License

sdcopy is licensed under the MIT License. See the `LICENSE` file for details.

