Latest revision as of 12:16, 3 June 2022

The FFmpeg Decoder Wrapper allows you to play any FFmpeg-supported audio format through foobar2000.

You need standalone FFmpeg binaries (ffmpeg.exe, ffprobe.exe) on your system in order to use it.

Getting FFmpeg binaries

Compatible FFmpeg binaries for Windows can be obtained from:

https://github.com/BtbN/FFmpeg-Builds/releases (64-bit builds)

https://www.gyan.dev/ffmpeg/builds (64-bit builds)

https://github.com/sudo-nautilus/FFmpeg-Builds-Win32/releases (32-bit builds)

No specific requirement about 64bit/32bit/static/shared builds, either should work as long as it runs on your computer.

After downloading and extracting FFmpeg package, use the bottom editbox of the preferences page to specify the folder containing your FFmpeg binaries - ffmpeg.exe and ffprobe.exe are required. If your FFmpeg binaries are present in %PATH%, there's no need to do so.

Configuration

FFmpeg Decoder Wrapper
	; foo_input_ffmpeg
Developer(s)	Peter
Repository
Release information
Initial release
Stable release	0.7 (November 12, 2021)
Preview release
foobar2000 compatibility
Architecture	{{{foobar2000_architecture}}}
Minimum version	1.5
Maximum version
UI module(s)	N/A
Additional information
Use	Output
License
Discussion thread	{{{discussion_thread}}}
	View all components

Before using, you must configure the component for use with specific file formats, as well as point the component at the location of FFmpeg binaries on your system.

The format list comes pre-populated with most common format configurations; however all of them are unchecked by default.

Format name

The name you wish to refer to the format by - shown in open file dialog etc.

File type mask

A wildcard-pattern that defines what files should be fed to this decoder.

Example: *.TAK for TAK files.

Multiple patterns may be specified per one decoder, delimited by semicolon.

This is intentionally kept separate from "format name" to allow alternate extensions and prefix extensions.

You can also specify protocols, e.g. rtmp://* - or combine file types and protocols, e.g. http://*.m3u8

Additional arguments

Additional command-line arguments for ffmpeg. The extra arguments are injected before -i %s. To inject arguments after -i %s, include -i %s in arguments, -i %s will not be inserted again.^[1]

Show codec names from FFmpeg

By default, the format name specified above is shown in "codec" info.

Check this to take "codec" info from FFmpeg. Note that since FFmpeg reports short codec names in lowercase, the codec name will be uppercased to match foobar2000 conventions.

Support chapters

Controls whether chapters reported by FFprobe should be presented as separate playlist entries.

This is checked by default. Uncheck to suppress chapter support.

Write tag types

Tag types to write to when the user attempts to edit tags on the file.

You do not need to enable this to read tags from your files, the component will attempt to read popular tag types (ID3v1/v2, APEv2) from your files regardless of this setting.

Warning

This feature may damage your files if used incorrectly; enable only after checking file format specifications for the file format you're dealing with!

Gallery

Preferences

References

↑ Problems with component FFmpeg Decoder Wrapper (foo_input_ffmpeg) on hydrogenaudio

Links

FFmpeg Decoder Wrapper on foobar2000.org
FFmpeg website

[1] Problems with component FFmpeg Decoder Wrapper (foo_input_ffmpeg) on hydrogenaudio

[1]

@@ Line 45: / Line 45: @@
 A wildcard-pattern that defines what files should be fed to this decoder.
-Example: *.TAK for TAK files.
+Example: <code>*.TAK</code> for TAK files.
 Multiple patterns may be specified per one decoder, delimited by semicolon.
@@ Line 51: / Line 51: @@
 This is intentionally kept separate from "format name" to allow alternate extensions and prefix extensions.
-You can also specify protocols, e.g. rtmp://* - or combine file types and protocols, e.g. http://*.m3u8
+You can also specify protocols, e.g. <code>rtmp://*</code> - or combine file types and protocols, e.g. <code><nowiki>http://*.m3u8</nowiki></code>
 ===Additional arguments===
-Additional command-line arguments for ffmpeg. The extra arguments are injected before -i %s. To inject arguments after -i %s, include -i %s in arguments, -i %s will not be inserted again.[https://hydrogenaud.io/index.php/topic,114855.msg946957.html#msg946957]
+Additional command-line arguments for ffmpeg. The extra arguments are injected before <code>-i %s</code>. To inject arguments after <code>-i %s</code>, include <code>-i %s</code> in arguments, <code>-i %s</code> will not be inserted again.<ref>{{ha|https://hydrogenaud.io/index.php/topic,114855.msg946957.html#msg946957|Problems with component FFmpeg Decoder Wrapper (foo_input_ffmpeg)}}</ref>
 ===Show codec names from FFmpeg===
@@ Line 68: / Line 68: @@
 Tag types to write to when the user attempts to edit tags on the file.
-'''USE WITH CAUTION''' - this feature may damage your files if used incorrectly; enable only after checking file format specifications for the file format you're dealing with!
+You do not need to enable this to read tags from your files, the component will attempt to read popular tag types (ID3v1/v2, APEv2) from your files regardless of this setting.
+{{panel|title=Warning|This feature may damage your files if used incorrectly; enable only after checking file format specifications for the file format you're dealing with!|color=yellow}}
+==Gallery==
+<gallery>
+foo input ffmpeg preferences.png|Preferences
+</gallery>
-You do not need to enable this to read tags from your files, the component will attempt to read popular tag types (ID3v1/v2, APEv2) from your files regardless of this setting.
+==References==
+<references/>
 ==Links==
 * {{foobar2000|https://www.foobar2000.org/components/view/foo_input_ffmpeg|FFmpeg Decoder Wrapper}}
 * [http://ffmpeg.org FFmpeg website]