Omniscient Master Suite OMNISCIENT · 3.1
Sign in with OmniumPortalSign in

Dimension Sorter v1.0.0

Images dimension-sorter 2 actions MCP

Sort a folder of images into subfolders by their real pixel dimensions (Pillow, not the filename): exact width x height, size buckets by the longest edge, or megapixel buckets. Every sort previews as a dry-run first and can be undone.

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: sortundo

Sort by dimensions

sort Destructive

Move every image in a folder into a subfolder based on its width and height: 'exact' (one folder per literal WxH), 'bucket' (by longest edge against a threshold list), or 'megapixels' (by total megapixels). Use --dry-run to preview without moving anything.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
mode enum optional, default bucket bucketexactmegapixels
buckets string optional, default 512,1024,2048,4096
mp_buckets string optional, default 1,2,4,8,12,20,24,50
on_conflict enum optional, default rename renameskipoverwrite

Outputs

NameTypeNotes
moved int
skipped int
counts json
changes json

Undo last sort

undo Destructive

Reverse the most recent sort in a folder, using the journal Dimension Sorter keeps.

Inputs

NameTypeRequired / defaultValues and notes
folder path required

Outputs

NameTypeNotes
restored int
changes json

Use it

Sort by dimensions

Command line

shell
python app.py --action sort --params '{"folder": "D:/path/to/folder"}'

# preview first - destructive action, nothing is changed:
python app.py --action sort --params '{"folder": "D:/path/to/folder"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("dimension-sorter", "sort", {"folder": "D:/path/to/folder"})

# preview first:
run_action("dimension-sorter", "sort", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "dimension-sorter",
  "action": "sort",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Undo last sort

Command line

shell
python app.py --action undo --params '{"folder": "D:/path/to/folder"}'

# preview first - destructive action, nothing is changed:
python app.py --action undo --params '{"folder": "D:/path/to/folder"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp
run_action("dimension-sorter", "undo", {"folder": "D:/path/to/folder"})

# preview first:
run_action("dimension-sorter", "undo", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "dimension-sorter",
  "action": "undo",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.