Omniscient Master Suite OMNISCIENT · 3.1
Sign in with OmniumPortalSign in

Folder Randomiser v1.0.0

Files & backup folder-randomiser 3 actions MCP

Shuffle the sort order of files in a folder by renumbering them randomly, in place. Every shuffle can be previewed as a dry-run and undone afterwards.

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: previewshuffleundo

Preview shuffle

preview

Show what a shuffle would rename files to, without touching any file.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
prefix string optional, default ""
pattern string optional, default *
pad int optional, default 3
start int optional, default 1
seed int optional

Outputs

NameTypeNotes
plan json
count int
seed int

Shuffle files

shuffle Destructive

Randomly renumber the files matching a filter in a folder, so they sort in a new random order. Keeps each file's own extension. Use --dry-run to preview, or pass a fixed seed to reproduce an earlier shuffle exactly.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
prefix string optional, default ""
pattern string optional, default *
pad int optional, default 3
start int optional, default 1
seed int optional

Outputs

NameTypeNotes
renamed int
changes json
seed int

Undo last shuffle

undo Destructive

Reverse the most recent shuffle in a folder, using the journal Folder Randomiser keeps.

Inputs

NameTypeRequired / defaultValues and notes
folder path required

Outputs

NameTypeNotes
restored int

Use it

Preview shuffle

Command line

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

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("folder-randomiser", "preview", {"folder": "D:/path/to/folder"})

Workflow node

json
{
  "id": "n0",
  "app": "folder-randomiser",
  "action": "preview",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Shuffle files

Command line

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

# preview first - destructive action, nothing is changed:
python app.py --action shuffle --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("folder-randomiser", "shuffle", {"folder": "D:/path/to/folder"})

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

Workflow node

json
{
  "id": "n0",
  "app": "folder-randomiser",
  "action": "shuffle",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Undo last shuffle

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("folder-randomiser", "undo", {"folder": "D:/path/to/folder"})

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

Workflow node

json
{
  "id": "n0",
  "app": "folder-randomiser",
  "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.