#image #sorting #square #directories #orientation #wide #quickly

bin+lib imgorisort

Quickly sort images into directories by orientation: tall, wide, and square

4 releases (2 breaking)

0.3.0 Jul 18, 2020
0.2.1 Jul 13, 2020
0.1.3 Jul 7, 2020
0.1.2 Jul 6, 2020

#16 in #orientation

Apache-2.0

15KB
247 lines

image-orientation-sorter

Quickly sort images into directories by orientation: tall, wide, and square.

Supported filetypes:

  • jpg
  • png
  • gif
  • webp
  • ico
  • tiff
  • bmp

This small tool's first release includes only the basic functionality: move images to direcotires named after their orientations.

Example

Move images

Move images to 'tall', 'wide', and 'square' directories. Use --overwrite if these directories exist, and you want files with the same name to overwrite files in destination directories instread of appending a number to the name.

$ tree /path/to/images
/path/to/images
├── foo
   └── square.jpg
├── portrait.jpg
└── landscape.jpg

$ imgorisort -r /path/to/images
Processed 3 files successfully.

$ tree /path/to/images
/path/to/images
├── foo
├── wide
   └── landscape.jpg
├── tall
   └── portrait.jpg
└── sqr
    └── square.jpg

Rename images

Rename images, adding 'tall', 'square', or 'wide' to the beginning of the filename.

Using --rename will not move images to new directories, in contrast to the above example.

$ tree /path/to/images
/path/to/images
├── foo
   └── square.jpg
├── portrait.jpg
└── landscape.jpg

$ imgorisort -r --rename /path/to/images
Processed 3 files successfully.

$ tree /path/to/images
/path/to/images
├── foo
   └── sqr_square.jpg
├── tall_portrait.jpg
└── wide_landscape.jpg

Usage

Run imgorisort --help to see the usage text:

imgorisort 0.3.0
Image Orientation Sorter

USAGE:
    imgorisort [FLAGS] <input-dir> [output-dir]

FLAGS:
    -h, --help         Prints help information
        --overwrite    Overrwite files in the destination directory if file names are the same. Without this flag set,
                       the default behavior is to append a number to make the filename unique.
    -q, --quiet        Do not print anything to stdout or stderr.
    -r, --recursive    Recurse into subdirectories.
        --rename       Prepend image orientation to filename instead of moving file.
    -V, --version      Prints version information
    -v, --verbose      Increase output verbosity by adding more flags: [-v|-vv|-vvv|-vvvv|-vvvvv]

ARGS:
    <input-dir>     Directory containing image files to sort by orientation.
    <output-dir>    Directory to output sorted images into. [default: .]

Dependencies

~18MB
~151K SLoC