It is underappreciated that every single command-line option parser/toolkit is its own full configuration language with individual tools being "programs/configs" in that language. The lexical similarity of the zillion dialects (mostly due to Unix shells doing the word splitting for the eventual argv to be interpreted) masks what is really a dizzying diversity that for whatever reasons people think is much more uniform than it really is.

For example, I've done experiments running every single program in /usr/bin with --help and -h. The number of failures to get any useful help are a huge percentage. (The normalization of said percentage naturally is idiosyncratic to the exact system I ran that on).

Anyway, adding types to a complex one like ffmpeg may help more people realize this as well as offering practical benefits. So, great job!

I know it's not the point you were trying to make but I find "man foo" to be more reliable and useful than "foo --help" or "foo -h"

Fair enough. Finding documentation on the language is often step 1. :-) There are also giant POSIX PDFs around these days.

Also, I should have been more clear that while the CL parser toolkits are basically CfLangs/PLangs (maybe without loops, etc.), every command doing its own hand-rolled argv parser is basically its own totally unique language, probably doing only a subset of the 6..10 common conventions. It's probably not a great language, just something serviceable.

Basically, getopt wasn't good enough or easy enough or taught well enough, or done "soon enough". By the time it had come along, even within Bell Labs, they had probably grandfathered in old commands like `dd` and `find` (because "hey, I have a whopping 5 scripts that work with the old way!") with all their many & varied bespoke syntaxes.

Anyway, sadly, we only get our one try at "history" and many things are "sticky".

It was even worse on DOS; wildcard expansion happened in the program, not in the shell, so you didn't know if wildcard expansion was supported for an individual command!

You still don't know if a Unix command would support processing multiple files even if the shell would expand wildcards. The tool might still process a single file and quit.

Another issue is that, around the same time getopt was appearing, the Bourne family of shells added `key1=val1 key2=val2 mycmd` syntax, accessed more simply with either `getenv("key1")`, etc. in a C program or simply `${key1-default1}` in a script, or in python `import os; E=os.environ.get; E("key1","default1")`. This is very lightweight on the mycmd impl as it can just start using the parameter wherever, possibly with string -> native value conversion, if needed.

So, though "shell specific" (right at a time when that started to mean anything), BOTH filename pattern matching aidenn0 mentions AND "long options of a sort" were built-in at the shell level on Unix. E.g., `help= mycmd` instead of `mycmd --help`. The inheritance of environment across fork/exec made these propagate which is both blessing (propagates through wrappers, so need not capture/repeat) and curse (have to worry about namespacing/re-use).

Basically, various timing effects had outsized influence - Unix & shell diversity and right around the time GNU introduced `mycmd --key[= ]value` combined with portability agendas, and possibly syntax/properties led to long options winning. The value proposition was "Use 'cmd --key=value', not 'key=value cmd' and users with any shell will have easy syntax". I dunno..It's also hard to attribute winning.

Today, for good or ill, most people seem to literally be unaware of `key=val mycmd` calling syntax even though for bash/POSIX "beat" the C shell/most things decades ago, around when bash added the better !! history and command-line editing that made tcsh popular because mistakes happen/etc. I believe the fish shell also dropped this syntax, though.

Never heard of that syntax but it falls short on several fronts like unnamed or not-needed-to-be-named parameters. It's very easy to be confused by existence or lack of spaces in "help= cmd" too; am I assigning a variable or running a command? Not to mention that if you have an environment variable that clashes with an argument, it can have catastrophic results. I'm glad that it hasn't caught on.

On a similar note, I remember CP/M 3.0 had square bracket syntax for options like `DIR [WIDE] [ATTR=ANY]`. I think that one was probably the most intuitive one, although may not be the easiest to type. But DOS had already caught on with forward slash parameter prefixes which it also got from pre-bracket CP/M.

I think you may misunderstand - the idea is "in addition to", not "instead of" the usual syntax, `a=123 b=456 mycmd arg1 arg2 arg3 ..`, but it happens to provide a way to give "long names".

Also, it did catch on in the sense of being available, if not well known as much as POSIX (BSDs) /Bash (Linux) / Zsh (Mac OSX) caught on.

The spacing is as confusing or not as any Unix shell quoting, as in `a="1 2 3" b="4 5 6" mycmd "arg 1" "arg 2"`.

FWIW, I agree `help= cmd` looks a bit funny, though a user could probably also say, in the interests of clarity, `help=1 cmd` or `help='' cmd` if the convention was to ignore the value of `$help` and just go by its existence.

cmd [key1] arg1 [key2=val2] arg2 is interesting. Thanks for that!

Oh, I've definitely misunderstood. Thanks for the clarification! I'm still glad that it hasn't caught on though :)

For the unitiated where was the conflict?

I'm not sure I understand your question. Are you asking for a list of the hundreds of commands which did nothing useful when run as cmd -h or cmd --help? I didn't save that, and as mentioned, it'd probably be different on your own systems/with your own packages.

If you want to try this at home, you should maybe either have GOOD BACKUPS HANDY OR DO IT WITHIN A VIRTUAL MACHINE/CONTAINER (EDIT: and almost certainly NOT AS SUPERUSER) also be ready to kill processes that are hanging waiting on stdin or somesuch. You're likely to have a least a few.

WITH THIS WARNING BEING GIVEN, you could just:

    (for cmd in /usr/bin/*; do echo "CMD: $cmd"; "$cmd" -h; done) >/tmp/dash-h 2>&1
    (for cmd in /usr/bin/*; do echo "CMD: $cmd"; "$cmd" --help; done) >/tmp/dashdash-help 2>&1

Of course, you could try /bin if that's any different (for me it's a symlink to the same dir as /usr/bin these days). You could also do single dash help.

If you want to accumulate some stats yourself, then you'll probably want to postprocess those output files.. So, you might also adapt the embedded echos to make it easy for whatever you like to do for that. Or, alternatively, you could re-direct each output to a per-command file with a little ${cmd##} massaging.

EDIT: and if you're asking what the CL syntax conflict was, well, I only meant to refer to "How to get any help at all - command with no args, with -h, -help, --help, -?, etc." as that is kind of the "very first question" on a user's mind. There are other syntactic conflicts (combining bool flags, option-value separation, unique prefix matching, etc., etc.).

This is interesting, and it's good to see something that's actively developed, but it seems to have some of the same issues as ffmpeg-python:

- It doesn't appear to have any way of specifying filters that do not have inputs, such as "color"

- There is no way to provide flags to Popen, e.g. to specify subprocess.CREATE_NO_WINDOW to avoid CMD windows popping up in a GUI app on Windows. This isn't a big deal for running ffmpeg itself, because you can just ffmpeg.compile() then run it manually, but that can't be done for ffprobe with ffmpeg.probe().

Edit: OK, figured out the source filter thing, ffmpeg.sources.color. Is there a way to use arbitrary source filters, like vfilter/afilter can do for regular ones?

If you're going to do script-based video processing in Python, I would highly recommend just going straight for Vapoursynth[1] instead. It's built for the purpose from the ground up, is actively maintained with a decent commmunity and tooling, and isn't tied to ffmpeg's CLI.

[1] https://www.vapoursynth.com/

Can you explain to me why, despite "full type safety, autocomplete and validation" being the focus of "typed-ffmpeg", it makes sense to be passing width and height (or the x and y co-ordinates) as strings here?

``` .drawbox(x="50", y="50", width="120", height="120", color="red", thickness="5") ```

(from https://github.com/livingbio/typed-ffmpeg?tab=readme-ov-file... )

I think the issue is those aren't integers, they are ffmpeg expressions evaluating to integers. See e.g. this example from the ffmpeg documentation:

  Draw a 2-pixel red 2.40:1 mask:
  drawbox=x=-t:y=0.5*(ih-iw/2.4)-t:w=iw+t*2:h=iw/2.4+t*2:t=2:c=red

Implementing type checking on this correctly would require something like a DSL.

Great idea. Personally looking forward to a typescript version of this.

Prompted the Jules preview to see what would happen. The implementation is pretty naive - there are much easier to read approaches I can think of. So not _awful_ considering the very short prompt I used.

Changes are on this branch for the curious:

https://github.com/matt-hensley/typed-ffmpeg/tree/feature/mu...

God’s native tongue

I agree would love to see a typescript version.

Typescript isn't mentioned anywhere.

Yes.

What are you answering yes to?

The fact that this particular implementation doesn't involve typescript has nothing to do with the fact that OP wishes for a typescript implementation. Your original response was a statement of fact that the poster already knew, so they said "yes" to affirm their knowledge

No.

Actually, yes.

It seems that there should be a machine-readable description of the ffmpeg command line to generate this in multiple languages.

The visual tool seems especially fantastic. FFMPEG seems an example of where modular/visual programming could really help, since I don't know all the bits FFMPEG offers. Minor UX note: I expected DEL to destroy nodes/edges (Win11/Chrome). But all in all: awesome!

It took this long for someone to finally come up with something resembling MS' DirectShow GraphEdit.

This is cool, but does it support piping frames between entire commands? In my opinion that's when you start to unlock the most interesting forms of FFMpeg flows.

this is great! let me plug my tool as well, in case you want to edit videos visually you can also use this tool https://newbeelearn.com/tools/videoeditor/ it generates ffmpeg commands.

Good work!

Unrelated, but my C++ solution: https://github.com/richardpl/lavfi-preview

this is what i was looking for: real time visual. very nice.