console_record
Record a running guest's console as an MP4/H.264 video at its own resolution, including VM sound when available, without showing it on your screen; start, stop, or check recording status.
Instructions
Record a running guest's console as a video (MP4, H.264), with the VM's sound when it has a SPICE sound card, at the guest's own resolution, with nothing shown on the user's screen. action start begins it — then work in the console as usual (console_send, console_click…): typing, commands and builds all go into the video — and action stop finishes it and says where the file is (the user's Videos folder, Proxmox Controller). status says whether one runs. It stops by itself after max_minutes (60 unless given) or when the guest stops. Works on desktops, servers' text screens and containers (containers without sound).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"host": "<host>",
"vmid": "<vmid>",
"action": "<action>",
"reason": "<reason>"
},
"name": "console_record"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The host's id, from list_hosts. | |
| vmid | Yes | The guest's ID (VMID). | |
| sound | No | Record the VM's sound too (default true). | |
| action | Yes | ||
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. | |
| max_minutes | No |