MatthiasQuintern/imgsort
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Easily sort images from one directory into other directories
32 Commits 2 Branches 0 Tags 247 KiB
Python 100%
cd541d23e4
Go to file
matthias@arch cd541d23e4 fix --sort-dir not respected
2024-02-07 11:23:22 +01:00
imgsort fix --sort-dir not respected 2024-02-07 11:23:22 +01:00
.gitignore add gitignore 2023-10-21 13:30:50 +02:00
imgsort-example.jpg add example image 2023-11-01 01:22:07 +01:00
LICENSE Initial commit 2021-09-23 15:09:36 +02:00
pyproject.toml bumb version 2023-12-16 00:24:27 +01:00
README.md improve dependecy info 2023-12-16 00:34:38 +01:00

README.md

imgsort - Image Sorter

This is a python program for Linux that lets you easily sort images from one directory into other directories. It lets you go through a folder of images and simply move them using a single key press, which you define at program startup. This is very useful when you want to sort your phone's camera folder or messenger media folders. For example, you could quickly go through your WhatsApp media (after copying it to your pc) and sort the images into different directories like Selfies, Landscapes, Friends etc.

Usage

  1. Navigate to the folder containing the images and run "imgsort".
cd ~/Pictures
imgsort

  1. When you run it the first time, you will be prompted to create a new config. That means you need to assign keyboard keys to directories in your filesystem. For example, you could use:

    • f = ~/Pictures/Family
    • v = ~/Pictures/Vacation_2019
    • O = ~/Pictures/Other

    Note that s, u, o and q are reserved for skip, undo, open and quit, but you can use S, U and Q instead.

  2. Save the config if you might want to use it again. The config file will be stored in $XDG_CONFIG_DIR or ~/.config/imgsort.

  3. Enjoy the slideshow!

Installation

Clone this repository and install it using python-pip. This project depends on ueberzug to display the images in the terminal. The original ueberzug is no longer maintained, but there is a continuation as well as a new C++ alternative available. You need to manually install one of them and then choose the corresponding imgsort branch. I would recommend the ueberzugpp as it also works on Wayland.

For the version supporting the original ueberzug:

git clone https://github.com/MatthiasQuintern/imgsort.git
cd imgsort
python3 -m pip install .

For the version supporting the new ueberzug++:

git clone --branch ueberzugpp https://github.com/MatthiasQuintern/imgsort.git
cd imgsort
python3 -m pip install .

Changelog

1.2

1.2.1

  • Refactored configuration management

1.2.0

  • Support ueberzugpp
  • Added option to open file with xdg-open
  • Use pyproject.toml for installation

1.1

  • Terminal does not break anymore when program exits
  • Todo-Images are now sorted by filename

1.0

  • Initial Release

Important Notice:

This software comes with no warranty!