Rename --XXX-buffer options (original) (raw)

There are 3 options to add delay/buffering:

• --display-buffer=
• --v4l2-buffer=
• --audio-buffer=

(and there is also a separate option --audio-output-buffer=, which is a workaround for some systems)

The naming is inconsistent: why --audio-buffer and not --video-buffer?

It's for historical reasons (there was only --display-buffer initially).

And there are 2 options related to video buffering (one for display, one for v4l2) and only one for audio. But this is "accidental", if we add the equivalent of v4l2 (pipewire) for audio, there would be another audio buffering option.

For consistency, I would like to rename --display-buffer= and audio-buffer= , either to:

• --video-playback-buffer=
• --audio-playback-buffer=
  or
• --video-buffer=
• --audio-buffer= (unchanged)

(--v4l2-buffer would be kept as is)

I like "video playback buffer" and "audio playback buffer" because it precisely describes what it refers to, but the options names are long.

I like "video buffer" and "audio buffer" because they are short, but --video-buffer= may suggest that it also applies to v4l2 (or even other use cases like recording).

(I think I prefer --video-buffer and --audio-buffer for now.)

What do you think?