Apps / Autotagger
Autotagger v1.0.0
Brand and tag images with text overlays - the full studio: live preview, font/colour/style, custom resolution with blurred-canvas fill, downsizing, threaded batch tagging, drag-and-drop, thumbnails, recent files and clipboard capture. Headless actions tag a single image or a whole folder.
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:
tag_imagetag_folder
Overlay text onto a single image and save a tagged copy.
Inputs
Name Type Required / default Values and notes
image
path
required
text
string
required
position
enum
optional, default bottom-right
top-lefttoptop-rightleftcenterrightbottom-leftbottombottom-right
color
string
optional, default #FFFFFF
size
int
optional, default 42
opacity
int
optional, default 100
bold
bool
optional, default false
margin
int
optional, default 4
downsize
int
optional, default 0
out
path
optional, default ""
Outputs
Overlay the same text onto every image in a folder, writing tagged copies to a 'tagged' subfolder.
Inputs
Name Type Required / default Values and notes
folder
path
required
text
string
required
position
enum
optional, default bottom-right
top-lefttoptop-rightleftcenterrightbottom-leftbottombottom-right
color
string
optional, default #FFFFFF
size
int
optional, default 42
opacity
int
optional, default 100
bold
bool
optional, default false
margin
int
optional, default 4
downsize
int
optional, default 0
recursive
bool
optional, default false
Outputs
Name Type Notes
count
int
out_dir
path
Requires
Python >=3.10
Packages Pillow
Models none
Use it
tag_image
tag_folder
Tag one image
Command line
shell Copy
python app.py --action tag_image --params '{"image": "D:/path/to/image", "text": "<text>"}'
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 Copy
run_action("autotagger", "tag_image", {"image": "D:/path/to/image", "text": "<text>"})
Workflow node
json Copy
{
"id": "n0",
"app": "autotagger",
"action": "tag_image",
"params": {
"image": "D:/path/to/image",
"text": "<text>"
},
"inputs": {}
}
Tag a folder
Command line
shell Copy
python app.py --action tag_folder --params '{"folder": "D:/path/to/folder", "text": "<text>"}'
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 Copy
run_action("autotagger", "tag_folder", {"folder": "D:/path/to/folder", "text": "<text>"})
Workflow node
json Copy
{
"id": "n0",
"app": "autotagger",
"action": "tag_folder",
"params": {
"folder": "D:/path/to/folder",
"text": "<text>"
},
"inputs": {}
}
Example prompts
Things you can say to Claude, Cursor or Codex once the MCP server is registered.
watermark every image in D:/renders with 'Brecht Corbeel' bottom-right tag this image with my name in the top-left, large white bold text