This is an automated email from the git hooks/post-receive script. Git pushed a commit to branch master in repository ffmpeg.
commit f942d9ea9258e5c4ebae44212f05ba279ab8a256 Author: Romain Beauxis <[email protected]> AuthorDate: Tue Aug 18 17:00:39 2026 -0500 Commit: Romain Beauxis <[email protected]> CommitDate: Fri Sep 25 16:04:08 2026 +0000 doc/protocols: document the libcurl ICY options Also note where the libcurl protocol differs from the native one once in-band metadata is active. --- doc/protocols.texi | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/doc/protocols.texi b/doc/protocols.texi index 031bc5c88e..606ce07f3f 100644 --- a/doc/protocols.texi +++ b/doc/protocols.texi @@ -1178,8 +1178,39 @@ Default is @code{5}. Set the threshold, in bytes, for when a readahead should be preferred over a seek and new HTTP request. This is useful, for example, to make sure the same connection is used for reading large video packets with small audio packets in between. + +@item icy +If set to 1 request ICY (SHOUTcast) metadata from the server. If the server +supports this, the metadata has to be retrieved by the application by reading +the @option{icy_metadata_headers} and @option{icy_metadata_packet} options. +The default is 1. + +@item icy_status +If set to 1 accept the legacy Shoutcast v1 @code{ICY 200 OK} status line in +place of an HTTP one. Any reply whose status line starts with @code{ICY 200} +is then treated as a successful HTTP 200. +The default is 1. + +@item icy_metadata_headers +If the server supports ICY metadata, this contains the ICY-specific HTTP reply +headers, separated by newline characters. + +@item icy_metadata_packet +If the server supports ICY metadata, and @option{icy} was set to 1, this +contains the last non-empty metadata packet sent by the server. It should be +polled in regular intervals by applications interested in mid-stream metadata +updates. + +@item metadata +Set an exported dictionary containing Icecast metadata from the bitstream, if present. +Only useful with the C API. @end table +A stream carrying in-band ICY metadata is always treated as non-seekable, since +its byte offsets do not address the payload. @option{seekable}, +@option{request_size} and @option{max_retries} therefore have no effect on such +a stream. + For more information see: @url{https://curl.se/libcurl/}. @section libsmbclient -- To stop receiving notification emails like this one, please contact [email protected]. _______________________________________________ ffmpeg-cvslog mailing list -- [email protected] To unsubscribe send an email to [email protected]
