{"report":{"v":1,"package":"@tmhs/screencast-mcp","version":"0.51.1","ranAt":"2026-11-16T11:39:05.954Z","install":{"ok":true,"integrity":"sha512-UW2ouUaBR8wK7hyDS0WZDnGuytbDBlCQZMrxS9IPB7i9C78HJq7H2Q7ovNu2WN7VfpGvnu/K7Siiks59p+/tAg==","deps":95,"scripts":[],"bins":["screencast-mcp"],"license":"CC-BY-NC-ND-4.0","engines":"node >=22.0.0","repository":"git+https://github.com/TMHSDigital/screencast-mcp.git","bin":"screencast-mcp"},"start":{"ok":true,"ms":275,"serverName":"screencast-mcp","serverVersion":"0.51.1","protocol":"2025-06-18"},"tools":[{"name":"start_recording","description":"Start a background screen recording. Returns a session id; finalize it with stop_recording. Never auto-starts.","params":["target","exactTitle","fps","quality","audio","output","overwrite","maxDurationSec","events","keys","focus","logs","perf","hotkeys","elements","cursor","backend","encoder","webcam","replayBufferSec","startWhen","stopWhen"]},{"name":"stop_recording","description":"Stop a recording gracefully so the file is finalized; returns the path and duration.","params":["sessionId","save"]},{"name":"delete_recording","description":"Delete a finished recording with its sidecars (event log, webcam, transcript, index, markers, pause parts) and registry entries; reports bytes freed. Asks the user first when the client supports it. Edits made from it are kept.","params":["sessionId","input"]},{"name":"pause_recording","description":"Pause a recording; until resume_recording nothing is captured, and the gap is left out of the file, events, and markers.","params":["sessionId"]},{"name":"resume_recording","description":"Resume a paused recording (same target and settings).","params":["sessionId"]},{"name":"save_replay","description":"Save the last N seconds of a replay buffer (start_recording replayBufferSec) to an mp4; the buffer keeps running.","params":["sessionId","lastSec","output","overwrite","reencode"]},{"name":"list_sessions","description":"List all recording sessions (active and finished) with their status, target, output path, and whether the process is still alive.","params":[]},{"name":"get_session","description":"Inspect a single recording session by id, including live status and whether its output file exists on disk.","params":["sessionId"]},{"name":"read_events","description":"Read the input events (clicks, scroll, cursor, shortcuts, typing bursts) of a recording made with events: true, in video seconds and pixels; e.g. types: ['down'], then sample_frames there.","params":["sessionId","input","from","to","types","inFrameOnly","limit"]},{"name":"add_marker","description":"Mark a labelled moment on a recording, live or at a second. Kept in the session and a sidecar; chapters and pipeline turn markers into chapters.","params":["label","sessionId","input","at"]},{"name":"review_recording","description":"Open a recording for a person to review: in MCP Apps clients an inline player to scrub, trim, and redact, then export; elsewhere just the video's details.","params":["input","sessionId"]},{"name":"screenshot","description":"Capture one PNG of the screen, a monitor, a window, or a region, returned inline and by path.","params":["target","exactTitle","backend","output","overwrite","returnImage","maxImageWidth"]},{"name":"sample_frames","description":"Sample PNG frames from a video (by fps, timestamps, or scene changes) and return the first few inline so the model can see what happened.","params":["input","mode","fps","timestamps","sceneThreshold","dedupe","outputDir","maxFrames","returnImages","maxInlineImages","maxImageWidth"]},{"name":"contact_sheet","description":"Tile timestamped frames of a video into one image to see a whole recording at a glance (the cheapest first look).","params":["input","count","mode","sceneThreshold","columns","tileWidth","poster","output","overwrite","returnImage","maxImageWidth"]},{"name":"screen_diff","description":"Compare two screenshots or frames: SSIM score, changed share, and changed boxes in b's pixels, to check a UI change happened only where expected.","params":["a","b","pixelThreshold","returnImage"]},{"name":"wait_for_change","description":"Wait until part of the screen changes, settles, or shows (or loses) some text, instead of guessing a sleep. Returns the elapsed time, changed regions (screenshot pixels; add `origin` for desktop), and the final state.","params":["target","exactTitle","mode","text","regex","gone","backend","timeoutSec","settleSec","intervalMs","pixelThreshold","returnImage","keep"]},{"name":"find_text","description":"OCR (built into Windows) on the screen, an image, or video frames, with line and match boxes in image pixels (add `origin` for desktop coordinates). Locate UI text or secrets (e.g. regex 'sk-|ghp_|api.?key') to redact. Best-effort: review results.","params":["target","input","timestamp","scanEverySec","maxFrames","exactTitle","backend","query","regex","redact","keep","returnImage"]},{"name":"index_recording","description":"Build a recording's text timeline (<video>.index.json: OCR per scene, events, markers, transcript) for search_recording.","params":["input","sessionId","sceneThreshold","maxFrames","transcript","force"]},{"name":"search_recording","description":"Search an index_recording timeline (screen text, events, markers, transcript): timecoded hits, best first, secrets masked. No frames unless asked. No input: search all indexes.","params":["input","sessionId","query","regex","limit","images"]},{"name":"get_media_info","description":"Probe a media file with ffprobe and return duration, resolution, frame rate, codecs, container format, and size.","params":["input"]},{"name":"trim","description":"Cut a video down to one sub-clip by start + (end or duration). For several segments use clip; to combine with other edits use pipeline.","params":["input","start","end","duration","exact","output","overwrite"]},{"name":"concat","description":"Join videos end to end with hard cuts: stream copy when they match, else a re-encode (`mode` says which). For transitions use xfade_transition or assemble_highlights.","params":["inputs","output","overwrite"]},{"name":"convert","description":"Convert media to mp4, webm, or gif. For a size-bounded GIF/WebP prefer export_gif; for a smaller mp4, compress or export_preset.","params":["input","format","fps","width","output","overwrite"]},{"name":"export_gif","description":"Export an animated GIF or WebP that fits a size budget (for PRs, issues, READMEs), stepping fps, width, and quality down until it fits.","params":["input","format","maxBytes","fps","width","start","duration","output","overwrite"]},{"name":"crop","description":"Crop a video to a pixel rectangle; one running off the frame is rejected.","params":["input","x","y","width","height","output","overwrite"]},{"name":"scale","description":"Resize a video to a target width and/or height and re-encode. Provide one side to keep the aspect ratio, or both to set an exact size.","params":["input","width","height","output","overwrite"]},{"name":"speed","description":"Change playback speed, or fast-forward ranges, and re-encode. Audio is retempo'd to match.","params":["input","factor","segments","output","overwrite"]},{"name":"overlay","description":"Composite an image or video (logo, watermark, picture-in-picture) onto a video at a pixel position, optionally scaled and time-limited; keeps the base's audio and length.","params":["input","overlay","x","y","width","height","start","end","shape","output","overwrite"]},{"name":"compose","description":"Lay 2-9 videos out side by side, stacked, or in a grid (before/after, app and terminal), labelled and in sync.","params":["inputs","layout","alignMarker","endWith","audio","output","overwrite"]},{"name":"perf_overlay","description":"Draw a recording's CPU or memory track as a small chart with a moving playhead (spikes in red).","params":["input","perf","metric","corner","width","output","overwrite"]},{"name":"translate_subtitles","description":"Translate an SRT without breaking its timing: call once for the numbered cues, translate them, then call with translations to write <input>.<language>.srt for chapters' subtitleTracks.","params":["input","language","translations","output","overwrite"]},{"name":"callout","description":"Annotate a video or screenshot with timed boxes, text labels, and arrows. Fallback fonts used are listed in fallbackFonts; characters no font covers are reported in warnings.","params":["input","items","fontFile","output","overwrite"]},{"name":"keystroke_overlay","description":"Burn keycast-style badges for shortcuts, clicks, and typing from the recording's input event log (start_recording events: true). Never shows typed text: the log has none.","params":["input","events","clicks","typing","keys","lingerSec","position","size","color","fontFile","dryRun","output","overwrite"]},{"name":"cursor","description":"Draw a smoothed, scaled cursor that hides when idle from the event log of a start_recording cursor: \"events\" recording (no OS cursor in the video), with click ripples and an optional spotlight.","params":["input","events","size","smoothing","hideAfterSec","clicks","spotlight","dryRun","output","overwrite"]},{"name":"backdrop","description":"Frame a video or screenshot on a gradient, color, or wallpaper with padding, rounded corners, and a drop shadow, optionally on a 16:9/1:1/9:16/4:5 canvas.","params":["input","preset","colors","image","padding","radius","shadow","shadowOpacity","aspect","output","overwrite"]},{"name":"compress","description":"Re-encode a video smaller (H.264 CRF ladder, optional width cap). For a platform target use export_preset.","params":["input","level","maxWidth","output","overwrite"]},{"name":"extract_audio","description":"Extract the audio track of a media file to its own file (mp3, aac, wav, or copy). Returns the output path.","params":["input","format","output","overwrite"]},{"name":"normalize_audio","description":"Normalize loudness to a delivery target (two-pass EBU R128 loudnorm); video is copied. Reports loudness before and after.","params":["input","target","output","overwrite"]},{"name":"denoise","description":"Reduce steady background noise (fan, hum, hiss) in a recording's audio with an adaptive FFT denoiser. Video is copied untouched. Returns the output path.","params":["input","strength","output","overwrite"]},{"name":"transcribe","description":"Transcribe a recording's speech to an SRT subtitle file, locally, with FFmpeg 8's whisper filter (needs a whisper.cpp model file). Returns the SRT path and the text. Pair with burn_subtitles to caption the video.","params":["input","model","language","words","output","overwrite"]},{"name":"burn_subtitles","description":"Burn SRT/ASS subtitles (e.g. from transcribe) into a video in the bundled font.","params":["input","subtitles","style","output","overwrite"]},{"name":"chapters","description":"Write chapters (markers, scene changes, transcript, or a list) into an mp4/mkv/mov copy without re-encoding; returns YouTube chapter text. Can mux an SRT as soft subtitles.","params":["input","sessionId","from","chapters","transcript","minChapterSec","subtitles","subtitleLanguage","subtitleTracks","textOnly","output","overwrite"]},{"name":"clip","description":"Extract several frame-exact segments, each to its own file. For one segment, trim does the same.","params":["input","segments","output","overwrite"]},{"name":"cut_idle","description":"Remove dead air: cut stretches where the screen is frozen (and silent), keeping a short pad. Returns the time saved.","params":["input","minIdleSec","keepSec","useAudio","action","factor","dryRun","output","overwrite"]},{"name":"cut_by_transcript","description":"Edit a video by its transcript: cut quoted text, cue numbers, or fillers. Also writes the re-timed .srt.","params":["input","srt","remove","fillers","dryRun","output","overwrite"]},{"name":"redact_region","description":"Cover given rectangles in a video or screenshot (e.g. secrets on screen). Not automatic detection: find them with find_text redact: true. Off-frame regions are rejected.","params":["input","regions","style","pad","color","output","overwrite"]},{"name":"list_audio_devices","description":"List DirectShow audio devices and flag a likely loopback (Stereo Mix or a virtual-audio driver), for start_recording's audio.device.","params":[]},{"name":"list_video_devices","description":"List DirectShow cameras for start_recording's webcam.device.","params":[]},{"name":"list_targets","description":"List the desktop, monitors, and visible windows (topmost first, with capturability per backend). Each entry has a `target` string to pass as-is to capture tools; use it instead of guessing a title.","params":["exe","titleContains","capturableOnly"]},{"name":"doctor","description":"Check the setup: ffmpeg/ffprobe (FFmpeg 8+?), optional filters, capture devices, Windows OCR, settings, and enabled toolsets; `problems` says what is missing and how to fix it. Call on first use or when a tool reports a missing feature.","params":[]},{"name":"xfade_transition","description":"Join two videos with an xfade transition (audio crossfaded); they need not match in size, fps, or audio. For more clips use assemble_highlights.","params":["inputA","inputB","transition","duration","output","overwrite"]},{"name":"assemble_highlights","description":"Stitch clips (including title cards) into one video with cuts or xfade transitions; they need not match in size, fps, or audio.","params":["clips","transition","duration","width","height","fps","output","overwrite"]},{"name":"title_card","description":"Generate a title card clip (centered text on a solid background, silent audio track) to stitch in with assemble_highlights. Uncoverable characters are reported in warnings.","params":["text","duration","width","height","fps","bg","fontColor","fontSize","bold","fontFile","output","overwrite"]},{"name":"music_bed","description":"Lay music under a video: looped or trimmed to length, faded, leveled, and mixed with any existing audio. Video is stream-copied.","params":["video","music","musicVolume","fadeIn","fadeOut","duck","output","overwrite"]},{"name":"narrate","description":"Offline voiceover with the built-in Windows voices: speaks each line at its time or marker over the audio, plus an SRT.","params":["video","lines","voice","rate","duck","output","overwrite"]},{"name":"reframe","description":"Re-aspect a video to 16:9, 9:16, 1:1, or 4:5 by padding or cropping.","params":["input","aspect","fit","output","overwrite"]},{"name":"zoom","description":"Smooth animated zoom-and-pan into the action and back out, from keyframes or planned from logged clicks or screen changes.","params":["input","keyframes","follow","events","highlightClicks","highlightColor","transitionSec","maxZoom","holdSec","dryRun","output","overwrite"]},{"name":"pipeline","description":"Run several edits (trim, crop, scale, speed, cut_idle, redact, callout, keystroke_overlay, cursor, reframe, zoom, backdrop, audio, burn_subtitles, then optionally export_preset or export_gif) in one ffmpeg pass: one re-encode, no intermediate files. Prefer it over chaining edit tools; a recipe does the usual polish in one call.","params":["input","fromEdit","steps","recipe","quality","dryRun","output","overwrite","chapters"]},{"name":"export_preset","description":"Encode a platform-ready H.264 file (aspect, fps, bitrate, faststart) for a named platform.","params":["input","platform","fit","output","overwrite"]},{"name":"bug_report","description":"Package a recording as a paste-ready repro folder: secret-scanned, redacted clip and GIF, contact sheet, steps from the event log, OCR'd errors, environment, report.md for gh issue create --body-file.","params":["input","sessionId","title","actual","expected","start","end","clipSec","redact","secretPattern","regions","errorPattern","scanEverySec","maxFrames","gif","maxBytes","outputDir","overwrite"]},{"name":"step_guide","description":"Turn a recording's event log into a numbered how-to: a ringed screenshot and caption per step, marker headings; Markdown and/or one HTML file. Never includes typed text.","params":["input","sessionId","title","format","ocr","outputDir","overwrite"]}],"toolsHash":"940ffc54fbc4db235aa902a4ce1dafe8cb63b1e824261b38d5a35acf0bb5afe2","wrote":[],"callsAt":"2026-11-16T11:39:13.000Z","calls":[{"tool":"list_sessions","ok":true,"ms":5,"bytes":34},{"tool":"read_events","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Pass sessionId or input."},{"tool":"find_text","ok":false,"ms":4,"bytes":0,"error":"tool reported an error: Required ffmpeg and ffprobe not found on PATH.\n\nffmpeg and ffprobe must be installed and on PATH (or set FFMPEG_PATH / FFPROBE_PATH). Windows: `winget install Gyan.FFmpeg` or `choco install ffmpeg`. m"},{"tool":"list_audio_devices","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: Required ffmpeg and ffprobe not found on PATH.\n\nffmpeg and ffprobe must be installed and on PATH (or set FFMPEG_PATH / FFPROBE_PATH). Windows: `winget install Gyan.FFmpeg` or `choco install ffmpeg`. m"},{"tool":"list_video_devices","ok":false,"ms":3,"bytes":0,"error":"tool reported an error: Required ffmpeg and ffprobe not found on PATH.\n\nffmpeg and ffprobe must be installed and on PATH (or set FFMPEG_PATH / FFPROBE_PATH). Windows: `winget install Gyan.FFmpeg` or `choco install ffmpeg`. m"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":61,"wrote":0,"callsTried":5,"callsAnswered":1,"callContacts":[]},"history":[{"package":"@tmhs/screencast-mcp","version":"0.51.1","ranAt":"2026-11-16T11:39:05.954Z","outcome":"started","tools":61,"contacts":0,"flags":0,"serious":0,"toolsHash":"940ffc54fbc4db235aa902a4ce1dafe8cb63b1e824261b38d5a35acf0bb5afe2"},{"package":"@tmhs/screencast-mcp","version":"0.49.1","ranAt":"2026-11-12T17:55:18.560Z","outcome":"started","tools":58,"contacts":0,"flags":0,"serious":0,"toolsHash":"a0429b297acca4cdf26f3bd66f5ff0cd8114e32e869d9521ef19cda603a0f033"}],"page":"https://bragproof.smaverk.com/r/%40tmhs/screencast-mcp"}