Skip to content

Latest commit

 

History

History
127 lines (89 loc) · 4.87 KB

README.md

File metadata and controls

127 lines (89 loc) · 4.87 KB
Raw

sorting-assistant

PyPI - Version PyPI - Python Version

A tool that determines sets of photos taken consecutively based on the Exif shooting date and exposure time, and creates a directory for each set.

[ja]
Exif の撮影日時と露光時間から、連続撮影された写真のセットを判断し、セットごとにディレクトリを作成するツール。

Table of Contents

Specification

  • Only JPEG-format photos with Exif data are acceptable.
  • If the difference between the date and time of shooting in the Exif is within ±2 seconds of the exposure time, the camera is considered to have taken consecutive shots.
  • Directories for each set are created in the directory to be sorted.
    • The directory names created will be sequentially numbered from 0000.

[ja]

  • Exif が記録されている JPEG 形式の写真のみ対象です。
  • Exif の撮影日時の差が、露光時間 ±2 秒以内の場合に、連続撮影されたと判断します。
  • セットごとのディレクトリは、仕分け対象のディレクトリ内に作成します。
    • 作成されるディレクトリ名は 0000 からの連番となります。

Installation

pip install sorting-assistant

Dependency

  • Modules

  • Libraries

    If you do not use the GUI, you can omit installation.

    [ja]
    GUI を使用しない場合は、インストールを省略できます。

    # For Ubuntu 20.04; Mac and Windows do not require installation.
sudo apt install libgtk-3-dev libgstreamer-plugins-base1.0-dev libmpv-dev zenity

Usage

$ python -m sorting_assistant -h
usage: python -m sorting_assistant [-h] [--input-directory INPUT_DIRECTORY] [--grouping-threshould GROUPING_THRESHOULD] [--cli]

Sort photos based on Exif.

options:
  -h, --help            show this help message and exit
  --input-directory INPUT_DIRECTORY, -d INPUT_DIRECTORY
                        [required in cli] directory containing photos to be sorted.
  --grouping-threshould GROUPING_THRESHOULD, -t GROUPING_THRESHOULD
                        [optional, default: 1] threshold for the number of photos to be directory (0-99).
  --cli, -c             [optional, default: launch with gui] execute with CLI.

CLI

# Use as module.
python -m sorting_assistant -d /path/to/image/dir -t 1 -c
# Or, use with pyproject script.
sorting-assistant-cli -d /path/to/image/dir -t 1

GUI

# Use as module.
python -m sorting_assistant
python -m sorting_assistant -d /path/to/image/dir -t 1
# Or, use with pyproject script.
sorting-assistant-gui
sorting-assistant-gui -d /path/to/image/dir -t 1

sorting assistant flet

  • Set the Directory Path and Grouping threshould and press the Execute button to execute.
  • When specifying the Directory Path, you can press Select to display the file selection dialog.
  • DnD is not supported because flet does not support DnD (flet-dev/flet#112).

[ja]

  • Directory Path と Grouping threshould を設定して、Execute ボタンを押すと実行されます。
  • Directory Path を指定する際、Select を押すとファイルセレクションダイアログを表示できます。
  • flet が DnD に対応していない (flet-dev/flet#112) ため、DnD は非対応です。

License

sorting-assistant is distributed under the terms of the MIT license.

[ja]
sorting-assistant は MITライセンス の下で配布されています。

Acknowledgment

This tool uses the following libraries. Thank you.

[ja]
このツールでは、以下のライブラリを使用しています。ありがとうございます。

Library Author License
exif Tyler Thieding MIT License
flet flet-dev Apache License 2.0