Skip to content

Show how to install ffmpegd when it isn't connected - #60

Merged
alfg merged 3 commits into
masterfrom
ffmpegd-install-hint
Sep 11, 2026
Merged

alfg merged 3 commits into
masterfrom
ffmpegd-install-hint

Conversation

@alfg

@alfg alfg commented Sep 11, 2026 •

Copy link
Copy Markdown
Owner

Summary

Until now, the only mention of ffmpegd was the toggle label, "Send encode jobs to a local ffmpegd daemon (experimental)". When it couldn't connect, the Queue just said "● ffmpegd offline". Nothing explained what ffmpegd is or how to get it.

  • Options: a line under the toggle, always shown, says what ffmpegd is and links to its install guide.
  • Enabled but not connected: Options and the Queue show a setup panel:
    • "Can't reach ffmpegd at localhost:8080", using the saved address if one is set
    • install it with brew install alfg/tap/ffmpegd, or follow the install guide for Windows, Go or Docker. The panel also asks people with an existing install to make sure it's up to date, since versions before 0.1.2 can't connect to ffmpeg-commander.com
    • run ffmpegd in the folder with your videos, since paths are relative to it
    • the page connects on its own once ffmpegd is running
  • Connection status in Options: "Connecting to ffmpegd at …" while the socket opens, then a green "● Connected to ffmpegd at …" once it does. If nothing answers within 1.5 s, the setup panel replaces the "Connecting" line, so a daemon that connects normally never flashes install steps.

Testing

  • 352 tests pass (npm test); tsc -b and oxlint are clean. New tests cover the install link when ffmpegd is off, the connecting line and the grace period, the connected line replacing the steps, the saved address, the Queue, and the update note.
  • Checked in headless Chrome against the dev server with no daemon running: Options and Queue on desktop in light mode, and Options on a 390px phone screen in dark mode. Fixed a repeated sentence in Options, and the brew command no longer breaks across lines on phones. Also checked the connected state with a real ffmpegd behind the dev server: the connecting line appears first, then the green connected line.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FJAB1xUz2Ks7btZ9WRyMgh

- Options: a line under the ffmpegd toggle says what ffmpegd is and links
  to its install guide.
- When ffmpegd is enabled but unreachable, Options and the Queue show the
  address being tried and the setup steps: brew install, run it in the
  folder with your videos, and that the page connects on its own.
- The steps wait 1.5s before appearing so a normal connect doesn't flash
  them.
- Options shows "Connecting to ffmpegd at ..." while the socket opens,
  then "Connected to ffmpegd at ..." once it does, or the setup steps if
  nothing answers. Before, connecting showed nothing in Options.
- Replace "An older copy may need updating" with what it meant: ffmpegd
  0.1.0 and earlier don't allow ffmpeg-commander.com and can't connect.
- The setup steps now say to make sure an existing install is up to date,
  rather than naming the versions that can't connect.
- Move displayHost into lib/ffmpegd so FfmpegdSetup.tsx only exports
  components and constants (react/only-export-components).
@alfg
alfg merged commit 3d3fa89 into master Sep 11, 2026
2 checks passed
@alfg
alfg deleted the ffmpegd-install-hint branch September 11, 2026 16:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant