Python library for creating image and video catalog. Catalog is organized by the dates and events. Main purpose is to handle task whe you have large number of pictures in flat directory and want to automatically group them into separate directories corresponding to events e.g. directory for your daughter's birthday, separate directory for the excursion you make next day after the birthday etc..
- clustering media (images, video) by event
- detecting duplicate files and stores the in separate output dir
- detecting media belonging to events that are already in the library
- detect if imported photo belongs to event that is already in database/filesystem
- mark folders from events that has large amount of media (folder suffix:
_rich)
Clone the repo, install required packages (see filecluster/requirements.txt)
On Windows to have numpy working one might need to install:
Typical usage:
$ file_cluster.py --inbox-dir inbox --watch-dirs zdjecia --db-driver dataframeor in abbreviated form:
$ file_cluster.py -i inbox -w zdjecia -d dataframeOther run options:
usage: file_cluster.py [-h] [-i INBOX_DIR] [-o OUTPUT_DIR] [-w WATCH_DIR] [-t] [-n] [-y] [-f] [-d] [-c] [--version]
Group media files by event
optional arguments:
-h, --help show this help message and exit
-i INBOX_DIR, --inbox-dir INBOX_DIR
directory with input images
-o OUTPUT_DIR, --output-dir OUTPUT_DIR
output directory for clustered images
-w WATCH_DIR, --watch-dir WATCH_DIR
directory with structured media (official media repository)
-t, --development-mode
Run script with development configuration - work on tests directories
-n, --no-operation Do not introduce any changes on the disk. Dry run.
-y, --copy-mode Copy instead of default move
-f, --force-deep-scan
Force recalculate cluster info for each existing cluster.
-d, --drop-duplicates
-c, --use-existing-clusters
--version show program's version number and exit
There is available experimental graphical interface: (filecluster/gui.py).
