qtuick

Single keystroke minimal Linux image and video sorter in Qt 6.

Download

• Download the current AppImage from Release Page

Usage

• Open the app, then select File -> Open Folder.
• Configure mappings in Settings -> Edit Shortcuts... (one key -> one folder).
• The app shows one image at a time.
• Press a mapped key (for example t) to move the current image.
• The destination folder is created automatically if missing.
• If a filename already exists at destination, the app auto-renames (name_1.jpg, etc.).

Development

Build

The Bash script does the build for you.

bash build-ninja.sh

Config

Use Settings -> Edit Shortcuts... in the app, or create ~/.config/qtuick/config manually:

# one key = absolute folder path
include_pdf=false
include_video=false
g=/home/s/sort/tech
d=/home/s/sort/delete
h=/home/s/sort/hist
a=/home/s/sort/anime
f=/home/s/sort/funny
r=/home/s/sort/art
m=/home/s/sort/my
c=/home/s/sort/cute

Notes:

• ~ is supported in paths (for example ~/sorted/keep).
• Lines starting with # are comments.
• include_pdf=true enables PDF files in the source folder list.
• include_video=true enables common video files in the source folder list.

Quality checks

./qa-check.sh

AppImage / Releases

• Workflow: .github/workflows/release-appimage.yml
• Trigger:
  • push a tag like v0.1.0, or
  • run release-appimage manually in GitHub Actions.
• Result:
  • AppImage is uploaded as an Action artifact,
  • on tags, it is also attached to the GitHub Release.

Local Workflow Test

Using nektos/act the AppImage creation can be tested. The output is placed into ./dist

act workflow_dispatch --bind -W .github/workflows/release-appimage.yml -j appimage   -P ubuntu-24.04=ghcr.io/catthehacker/ubuntu:act-latest