MEDIA_VOLUME
Set system or app volume.
macOS only
This capability uses native Apple apps and is available in the macOS edition. The Linux editions offer equivalent cross-platform capabilities instead.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
level | integer | yes | Volume level (0-100) |
target | system | Music | Spotify | — | What to adjust |
How to use it
You normally trigger this by describing what you want in chat — the agent selects MEDIA_VOLUME automatically. For example:
Try saying
“use mac media to media …”
In a workflow
As a step in a multi-step workflow DAG:
json
{
"id": "s1",
"agent": "mac_media",
"action": "MEDIA_VOLUME",
"args": {
"level": 1,
"target": "system"
},
"depends_on": [],
"outputs": []
}Direct call
For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.
bash
curl -X POST http://127.0.0.1:8000/execute_tool \
-H "Content-Type: application/json" \
-d '{"tool_name":"MEDIA_VOLUME","args":{"level":1,"target":"system"}}'Part of the mac_media plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.