Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[API] `--mode mp4` should require a declared stop

Closed
#657 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
python
Domain
backend, cli

Research direction

Look at the runner's command-line argument parsing and validation logic, likely in a file like cli/runner.py or flashdreams/run_v2.py. The --mode mp4 handling and the existing --timeout flag are entry points. Understand how the runner currently determines when to stop encoding. The change involves adding new flags (--total-model-steps, --total-ui-steps) and enforcing that at least one bound is provided for MP4 mode. Check the linked PR #652 to see the recent changes around app lifetime and UI overlays.

Written by the indexing model from the issue text.

Description

Summary

--mode mp4 writes a file. Nobody is sitting there to close a window, and this mode never sends a close event, so the run has to stop itself. Native-window and WebRTC can wait until the client closes.

If the app never finishes (is_finished stays false; no app-owned stop), an MP4 run has no reason to stop. It encodes until kill. Every app then has to invent its own file-length story, or people paper over it with --timeout.

This is chassis CLI, not a Cam2V special case. App flags after -- stay on the app. The runner does not parse them and does not special-case slugs.

Not this issue. #640 / #652 is Cam2V --mode mp4 with UI overlay that keeps encoding after the app declared lifetime (e.g. --total-blocks) is already done. Without the overlay, encoding already stopped. That hang is that PR.

Links

Dominant language
Python
Stars
522
Forks
66
Avg merge
2d 5h
Merged PRs (30d)
46

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from NVIDIA/flashdreams

All issues in NVIDIA/flashdreams

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.