Reported issues for mcp-video

Pod holds 17 of 62 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to mcp-video.

Most discussed

Spec: Product and object matte on hyperframes-remove-background

Spec: Product and object matte on existing hyperframes-remove-background

Status: agent-ready Date: 2026-08-19 Public guide: docs/PRODUCT_MATTE.md Example: examples/product-matte/

Who this is for

Kinocut users who shoot things, not people: product photographers, shop operators, catalog studios, UGC sellers, marketplace listings. Jewelry on a turntable, shoes on a sweep, bottles on a lightbox, phones on a table, ceramics on a banding wheel, boxed SKUs on a kitchen t

Read the thread · 2026-08-19 · closed · 7 comments

Product/object matte: operator guide, doctor, composite-layers recipe

Parent

#461 — Spec: Product and object matte on hyperframes-remove-background

Type

AFK

Who it is for

Strangers discovering Kinocut: product photographers, shop operators, UGC sellers, and agents. They must be able to go from README/skill/--help to a working cutout without reading an internal plan.

What to build

Docs + doctor. Object matte is --model, not a new verb.

Public operator guide (required): docs/PRODUCT_MATTE.md in the 360-assembly voice: who it is for, mod

Read the thread · 2026-08-19 · closed · 5 comments

Product/object matte: fail-closed dispatcher + Kinocut-owned --info

Parent

#461 — Spec: Product and object matte on hyperframes-remove-background

Type

AFK

Who it is for

Any Kinocut user (photographer, shop, agent) who needs to choose people vs product cutouts on the command they already have. This slice does not yet run BiRefNet; it makes the choice honest and fail-closed.

What to build

Fail-closed dispatcher on the existing hyperframes-remove-background command.

• Default / u2net_human_seg still shells Hyperframes with no `--mode

Read the thread · 2026-08-19 · closed · 4 comments

Make the projectstore test suite portable to Windows

Parent

#447

What to build

The projectstore test suite collects and runs on Windows. The lock-failure security test stops importing the POSIX lock module bare (it targets the portable lock seam introduced by PR #446 — coordinate with that PR, whose review already requests the seam fix), and the executable ffmpeg/ffprobe test stubs that rely on shebang lines and exec bits are invoked through the current interpreter instead, or skip explicitly where a stub cannot be made portable. After th

Read the thread · 2026-08-15 · closed · 4 comments

Spec: Insta360 X4 360 dual-cam assembly

Spec: Insta360 X4 360 dual-cam assembly

Status: ready-for-agent
Date: 2026-08-13
Design companion: docs/superpowers/specs/2026-08-13-x4-360-assembly-design.md

Test seams (highest, existing first)

One compiler seam: propose → validate → approve → render a 360_assembly_plan.

Hook it through existing surfaces only:

• Intent — video_intent with goal= emits the plan (no new MCP name).
• Review — same approve/reject contract as shorts/EDL review.
• **Rende

Read the thread · 2026-08-13 · closed · 4 comments

Product/object matte: birefnet-general extra and hole-cut plate

Parent

#461 — Spec: Product and object matte on hyperframes-remove-background

Type

AFK

Who it is for

Shop and catalog users who already picked --model birefnet-general and need the cutout to actually run: jewelry, bottles, shoes, electronics, ceramics, boxed SKUs, any non-person object.

What to build

kinocut[object-matte] extra + kinocut/object_matte/ module that runs pinned BiRefNet-general ONNX. Same public command. Never call HF for this model in v1.

*Pin (frozen):

Read the thread · 2026-08-19 · closed · 3 comments

Wayfinder map: first-class Windows support and honest diagnostics

Destination

The spec first-class Windows support and honest diagnostics implemented and merged: the MCP entry point reports real import failures, doctor exercises the MCP server import path, the projectstore tests run on Windows, CI guards the platform on every PR, and Windows lock errors surface instead of hanging. The maintainers work these tickets themselves — the PR #446 contributor's scope ends at his own diff.

Notes

• Domain

Read the thread · 2026-08-15 · closed · 3 comments

Add long-form stream-to-shorts repurposing workflow

Product goal

Add a reusable operator workflow that turns a completed 30–60 minute livestream recording into several reviewable short-form candidates, approval-gated vertical drafts, and manual-publishing export packages for YouTube Shorts and Instagram Reels.

Required workflow

1. Inspect and preserve the source recording.
2. Transcribe long-form media and discover multiple distinct moments.
3. Present candidates with timestamps, transcript context, hook/title, rationale, and review warn

Read the thread · 2026-07-22 · closed · 3 comments

Most recent

video-ai-remove-silence produces corrupted mp4 (missing moov atom) with multiple silence regions

Summary

video-ai-remove-silence (kino video-ai-remove-silence) produces a corrupted output .mp4 (missing moov atom, unreadable by ffprobe) when the chosen --silence-threshold is loose enough to detect multiple silence regions in a real speech recording. The command itself exits 0 and reports success.

Environment

• kinocut 1.15.0 (installed via pip install kinocut)
• ffmpeg 6.1.1 (Ubuntu)
• Source: a real ~3.5min speech video, 1280x720, AV1 video / Opus audio (webm cont

Read the thread · 2026-08-29 · open · external user · 0 comments

Product/object matte: temporal interval and studio-equipment overlay

Parent

#461 — Spec: Product and object matte on hyperframes-remove-background

Type

AFK

Who it is for

Catalog studios shooting on a motorized turntable, stand, tripod, sweep, or lightbox. A SKU cutout that still includes the wheel or clamp is unsellable. This slice is the optional gate, off by default.

What to build

Wire temporal interval + studio-equipment overlay on all four surfaces (parser, handlers_hyperframes.py, MCP, Client). Object-backend only.

`--mask-inter

Read the thread · 2026-08-19 · closed · 2 comments

CI: add a Windows smoke job

Parent

#447

What to build

Every code-touching PR gets a Windows runner job mirroring the existing smoke pattern: lint, the canonical client-import compatibility check, doctor, and the public-surface tests. A change that breaks Windows can no longer land silently — which is exactly how #445's root cause shipped. The job respects the changes-filter conventions used by the existing workflows and stays fast and focused; widening its scope comes later, only once it is reliably green.

Acc

Read the thread · 2026-08-15 · closed · 0 comments

projectstore: narrow Windows lock error handling to contention-only

Parent

#447

What to build

On the Windows file-lock backend introduced by PR #446, blocking acquisition retries indefinitely only for genuine contention (the two contention errnos), and the non-blocking lease probe reports contention only for contention errors. Every permanent error — bad descriptor, permissions, unreadable file — propagates as a platform-native error so the existing mappers surface it: a render job with a broken lease fails loudly instead of hanging forever, and a corru

Read the thread · 2026-08-15 · closed · 1 comment

doctor: verify the MCP server import path

Parent

#447

What to build

kino doctor gains a check that actually imports the MCP server tool tree and reports it as its own component. On a machine where the server tree cannot import (the #445 scenario), doctor names the failing component and does not report overall OK — "OK" starts to mean the primary integration paths work, not just the ffmpeg binaries. The check is failure-isolated (a failed check can never crash doctor) and uses the same stable, privacy-safe error mapping as the

Read the thread · 2026-08-15 · closed · 1 comment

MCP mode: surface real import failures instead of 'missing mcp package'

Parent

#447

What to build

When kino --mcp fails to start because something in the MCP server tool tree cannot import, the command prints the real cause — through the project's privacy-safe error vocabulary, with a non-zero exit — instead of today's "MCP mode requires the 'mcp' package" message. Only the genuine absence of the MCP package keeps the current install hint. The lazy-import structure of the entry point and CLI startup behavior are unchanged. (This is the second half of #445

Read the thread · 2026-08-15 · closed · 1 comment

MCP mode fails on Windows: projectstore/store.py imports Unix-only fcntl (error masked as missing 'mcp' package)

kino --mcp fails on Windows because kinocut/projectstore/store.py imports fcntl, which is Unix-only. The user-facing message points at the wrong cause, which makes this hard to diagnose.

What happens

> kino --mcp
MCP mode requires the 'mcp' package.
Install with: pip install kinocut

That message is misleading: mcp is installed (1.29.0, pulled in by the package itself). The real error is swallowed by a broad except ImportError in __main__.py:

if args.mcp o

[Read the thread](https://github.com/KyaniteLabs/kinocut/issues/445) · 2026-08-15 · closed · outside contributor · 1 comment

### Stream shorts slice 6: CLI, client, and MCP adapters

Child of #399; PR #400 is a non-mergeable review umbrella.

Land thin CLI, Python client, and MCP adapters over the shared orchestrator. Split registration, CLI stages, and surface-count updates into PRs under 400 changed lines as needed.

Acceptance: source-free saved-plan review; explicit proposal/review/render/package CLI stages; exact saved-plan selection; client/MCP parity; plain-language recovery errors; no posting/authentication.

Depends on the orchestrator/package slice.

[Read the thread](https://github.com/KyaniteLabs/kinocut/issues/406) · 2026-07-22 · closed · 1 comment

### Stream shorts slice 5: review-gated render and packaging

Child of #399; PR #400 is a non-mergeable review umbrella.

Land the shared review-gated shorts orchestrator and complete export packaging in dependency-sized PRs under 400 changed lines. Rendering must fail closed without approval, enforce per-platform duration, preserve safe padded composition, synchronize captions to effective bounds, persist plans, and cache unchanged rerenders.

Acceptance: approve/reject/trim/title/sensitivity records; two platforms; video/SRT/thumbnail/metadata/manifest p

[Read the thread](https://github.com/KyaniteLabs/kinocut/issues/405) · 2026-07-22 · closed · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/KyaniteLabs/kinocut/issues).