racopokemon / imagesort

Simple image gallery to quickly preview, zoom, categorize and delete images.

Image Sort

Simple javafx app that lets you cycle through the .jpg files in a folder, and organize / index / sort them:

• click and hold inside a photo to zoom (zoom adjustable)
• delete or backspace instantly move the shown image to a '/deleted' folder
• up and down change the category of the shown image, it may either be kept in the directory or moved to one of the subfolders 1, 2 or 3
• keys a, b, c, d to have a copy of the images into the corresponding folders
• the copying to the folders a, b, c, d and the moving to the 1, 2 and 3 folders is done when the application is closed (with user confirmation)

Installation

• Requires windows, use the .msi installer or the portable .zip, available at the releases section to the right!
  • If you don't have Windows ... contact me, porting the app to linux or mac should not be a big thing.

Supported formats / extensions

• .jpg/.jpeg
• .png
• .gif
• .bmp

Known issues

• See the issues category in the github page

Future features

• A big list of further feature ideas and requests can be found here.

The dev stuff: Building, running, etc.

Toolchain

• Use openjdk 17+ from here (the OpenLogic variant also ships with javafx which makes problems when jlinking, because then there are two editions with different hashes)
  • You will have to add the /bin folder to your PATH
  • And maybe also point your JAVA_HOME to the base folder (without the bin)
• Use and install maven (I know..)
• In your IDE, imagesort->Plugins->javafx->run should do the trick

Compiling for your OS

• With maven, do imagesort->Plugins->javafx->jlink
• This crashes the first time, because there are compatibility issues with a non-modular package we want to use anyways
  • Ugly workaround: The promted .jars to be non-modular are rewritten (moditect-plugin in the pom) to be modular. Copy both from target/modules to the promted path and replace
• Hopefully, jlink works now.
• jlink writes to target/imagesort, but this bunch of files is not bundled yet into an executable
• Run create_msi.bat (for Windows, the steps inside the .bat can be easily modified to other OS), which calls jpackage (included in newer jdks and creates packages for the OS you are currently on)
  • On Windows, you need some ominos 'wix'-tools to generate a .msi file, but the .bat will tell you more when you run it
    • Still, get the legacy download from here, v5 does not work anymore with jpackage...
    • And you will want to add C:\Program Files (x86)\WiX Toolset v3.14\bin to your PATH.

imagesort's Issues

Downscaled images show alaising effects

This became more and more annoying over time to me. The thing is, there is no easy way to fix this, as the image interpolation is done internally in the ImageView class, and even if I setSmooth(true), there is no difference.
Maybe I'll do some workaround with generating an artificially downscaled image that I render seconds after the image got previewed or so.

On slow HDD images are loading slow or not at all

Investigate by showing a load percentage indicator (which is offered in the javafx.image class) and show error messages (which are also available there)

Opening a folder without images shows a wrong error message

It writes something like there are no images to be moved to folder -1

Deleting files during filtering ends results in loading the next image

Happened at least once. How can this happen, shouldnt the other images be buffered already?
-> investigate this.

Micro-lags when (quickly) scrolling through images

The most likely origin of this phenomen is simply that I extract image metadata (for some future! image) on the fx thread, of course the app then blocks until the process is finished.

I should fix this in time..

Rotated small images - are not pixel accurate and the zoom is wrong on them

There is no logic already on how the image view rotates its content, and this is where all the trouble starts. Debugging this is probably pure joy.

On very small heaps image buffer size 1 is still too big

This results in an endlessly empty loading circle for the current image: Interally the other images are already loaded and block all available ram. The current image is being loaded, runs into the heap space error, and which just causes the image to being loaded again, where it obvioisly again runs into the same error.

"loading the image" hint is not shown

Yeah. I mean, bro.

Under zoom, we are not pixel accurate all the time

Known issue.
Unlikely that Ill fix that, for photos you usually are not interested in single pixels anyway

Long filenames are not right aligned when hovering the percentage bar, and some areas keep it flashing

Thats pretty much it.