Difference between revisions of "Foobar2000:Foobar2000"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(Columns UI)
(Updated version info.)
 
(579 intermediate revisions by more than 100 users not shown)
Line 1: Line 1:
'''foobar2000''' is a free music player for Windows. It features multiple playlists, a music database, streaming, [[ReplayGain]] support, extensive plug-ins support and more.
+
{{title|foobar2000}}
 +
{{Software Infobox|
 +
|name                = foobar2000
 +
|logo                = [[Image:foobar2000 Logo.png|48px]]
 +
|screenshot          = [[Image:Foobar2000-1.0-default-ui.png|250px]]
 +
|caption              = Screenshot of foobar2000 v1.0 using the default user interface
 +
|developer            = Peter Pawlowski
 +
|released            = {{start date and age|2002|12|20}}<ref>{{ha|https://hydrogenaud.io/index.php/topic,4997.0.html|Official Foobar2000 site & Foobar2000 0.3 & SDK!}}</ref>
 +
|stable_release      = 1.5<ref>{{foobar2000|http://www.foobar2000.org/download|Download foobar2000 for Windows}}</ref>
 +
|stable_release_date  = 2019-11-29
 +
|preview_release      = 1.5 beta 21
 +
|preview_release_date = 2019-11-12
 +
|operating_system    = Windows
 +
|use                  = Media Player
 +
|license              = Proprietary, BSD
 +
|website              = [http://www.foobar2000.org/ foobar2000.org]
 +
}}
 +
'''foobar2000''' is an advanced freeware audio player for the Windows platform. Some of the basic features include full Unicode support, [[ReplayGain]] support and native support for several popular audio formats.
  
 +
== Platforms ==
  
 +
foobar2000 has been written specifically for the Windows platform, and there are no plans to port it to any others. However, although not officially supported, it is known to run on [http://www.hydrogenaudio.org/forums/index.php?showtopic=54933 Linux] and [http://www.hydrogenaudio.org/forums/index.php?showtopic=77261 Mac OS X] through Wine and WineBottler, respectively. Also there is an [https://aur.archlinux.org/packages/foobar2000 Arch Linux native package] maintained by a community member.
  
=== Supported formats ===
+
== Features ==
 +
* Powerful open component architecture allowing third-party developers to extend functionality of the player, including the ability to fully replace the user interface.
 +
* Full Unicode support: File names, user interface, tagging, etc.
 +
* [[ReplayGain]] support: Both playback and writing ReplayGain information to file tags.
 +
* [[Gapless playback]].
 +
* Advanced [[tagging]] capabilities - through built-in [[foobar2000:Properties|Properties dialog]] and various optional tagging-related components.
 +
* Built-in [[foobar2000:Preferences:Media Library|Media Library]] functionality.
 +
** Intuitive [[foobar2000:Query syntax|query syntax]] for searching the Media Library.
 +
** Autoplaylist support: Generate dynamically updating playlists based on queries.
 +
* [[foobar2000:Preferences:General:Keyboard Shortcuts|Customizable keyboard shortcuts]].
 +
* Support for [[transcoding]] all supported audio formats using the [[Foobar2000:Converter|Converter component]] (requires external command-line encoder executables for different output formats).
 +
* [[Secure_ripping|Secure]] [[foobar2000:Ripping CDs|CD ripping]].
 +
* Streaming support.
 +
* Efficient handling of large playlists.
 +
* [[foobar2000:Components/Default_user_interface_%28foo_ui_std%29|User interface]] with simple configuration to create even complex layouts quickly and easily.
 +
* Highly customizable display of track information using [[foobar2000:Titleformat_Introduction|title formatting scripts]].
  
==== Playback ====
+
==Supported audio formats==
 +
Natively supported ("out-of-the-box"):
 +
* [[MP1]], [[MP2]], [[MP3]], [[MP4]], [[Musepack]], [[AAC]], [[Ogg Vorbis]], [[FLAC]] / Ogg FLAC, [[Speex]], [[WavPack]], [[WAV]], [[AIFF]], [[AU|AU/SND]], [[CDDA]], [[WMA]], [[Matroska]], [[ALAC]], [[MMS]], [[RSTP]], [[Opus]].
 +
Supported through optional components:
 +
* [[TTA]], [[Monkey's Audio]], [[MOD]], [[SPC]], [[Shorten]], [[OptimFROG]], [[AC3]], [[DTS]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[TAK]], [[AMR]], ''etc.''
  
* [[MP3]], [[Ogg Vorbis]], [[MP2]], [[AAC]], [[WAV]], [[AIFF]], [[Musepack]], [[VOC]], [[SND]]
+
In addition, foobar2000 can also play audio files within ZIP and RAR archives (typically compressed) directly, ''i.e.'' without requiring the user to extract the files first. More archive formats are supported ''via'' additional components: [http://www.foobar2000.org/components/view/foo_unpack_lha LHA/LZH], [http://www.foobar2000.org/components/view/foo_unpack_7z 7-Zip], [http://kode54.foobar2000.org/ JMA]
  
Supported through plug-ins:
+
== Using foobar2000 ==
  
* [[TTA]], [[FLAC]], [[Monkey's Audio]], [[WavPack]], [[Speex]], [[Mod]], [[SPC]], [[TFMX]], [[Shorten]], [[OptimFROG]], [[LPAC]], [[WMA]], [[AC3]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[Matroska]]
+
=== Important pages ===
 +
* {{foobar2000|http://www.foobar2000.org/FAQ|foobar2000 FAQ}}
 +
* [[foobar2000:components|foobar2000 components]]
 +
* [[foobar2000:Encouraged Tag Standards|foobar2000 encouraged tag standards]]
 +
* [[foobar2000:FAQ|foobar2000 FAQ (unofficial)]]
 +
* [[:Category:Foobar2000_Guides|foobar2000 guides (category)]]
 +
* [[:Category:Foobar2000_Preferences|foobar2000 preferences (category)]]
  
In addition, foobar2000 can also play music directly from compressed RAR, ZIP and 7-ZIP archives without requiring the user to extract the files prior to playing.
+
=== Specific guides ===
----
+
=== User Interface ===
+
  
====Standard====
+
'''Preferences'''
 +
* [[foobar2000:Preferences|Preferences dialog]]
  
By default foobar2000 uses the standard interface, foo_ui_standard.  This interface is based around a tabbed list of playlists.  Playlists are then formatted according to the title formatting strings entered by the user.  These allow access to tag data, as well as information about the state of the program in the playlist display.
+
'''Metadata'''
 +
* [[foobar2000:Properties|Tag editing: the Properties dialog]]
 +
* [[foobar2000:Query syntax|Query Syntax]]: details of Syntax for querying metadata.
  
====Columns UI====
+
'''Title formatting'''
 +
* [[foobar2000:Title Formatting Introduction|Introduction to titleformat scripts]]
 +
* [[foobar2000:Title Formatting Reference|Titleformat Reference]]: reference guide to all fields and functions
 +
* [[foobar2000:Titleformat Examples|Titleformat Examples]]: user-submitted code for various purposes; submit your own!
  
[http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 foo_ui_columns] is an extension of the ideas used in the standard interface.  It takes the open area of the playlist and divides it into one or more columns that have individual formatting strings.  Recent versions of Columns UI have also added support for UI Extension panels which appear in Columns UI's sidebar or in the toolbar.<br>
+
'''Others'''
Some popular extension panels include (in no particular order):
+
* [[foobar2000:File operations|File operations dialog]]: move, copy, rename, and delete files from within foobar2000
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=28869 foo_uie_tabs] '''Tabbed Panel Stack'''<br>Allows multiple extension panels to be added to a stack.
+
* [[foobar2000:Commandline Guide|Commandline usage]]
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=29383 foo_uie_albumart] '''Album Art Panel'''<br>Displays album art from images in a specified folder.
+
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=29363 foo_uie_trackinfo]'''Track Info Panel'''<br>Displays information about the currently playing or selected track. Can be customised using TAGZ strings.
+
  
Because of the useful extensions to the Standard UI, Columns UI is rapidly becoming popular and continues to be under rapid development.
+
=== External Guides ===
 +
* [http://www.audiohq.de/viewforum.php?id=27 German-language guides]
 +
* [http://foobar2000.xrea.jp/ fb2k Wiki Page] for Japanese users.
 +
* [http://winamp2foobar.blogspot.com Winamp To Foobar Guide] with information relevant for general users also.
  
*[http://music.everywebhost.com/wiki/doku.php?id=columns_ui:faqs Columns UI FAQ]
+
=== Technical information ===
 
+
* [[foobar2000:ID3 Tag Mapping|ID3 Tag Mapping]]
*[http://music.everywebhost.com/wiki/doku.php?id=columns_ui:documentation Columns UI documentation]
+
* [[foobar2000:Metadata Compatibility|Metadata Compatibility]]: information about compatibility with metadata written by other applications
 
+
----
+
 
+
=== TAGZ ===
+
TAGZ is the language used to format the way information is displayed.  Thorough documentation on various TAGZ fields and functions is laid out in titleformat_help.html, which can be found in your foobar2000 directory.
+
 
+
----
+
=== Beginner's Guide ===
+
 
+
==== Getting Started ====
+
 
+
Always remember that the best way to become comfortable with foobar is to read [http://www.hydrogenaudio.org/forums/index.php?showforum=28 the forums] regularly and to play around with foobar itself.  Download some configs (found under "Appearance" in the "External Links" section below), study how they do what they do, change them around to see how you affect things, explore the preferences window, see what happens when you check/uncheck things if you can't figure out what they mean, etc., etc.  '''90% of what you learn will come from the forums and experimentation.'''
+
 
+
Bookmark and try to familiarize yourself thoroughly with titleformat_help.html in your foobar directory. This contains all the TAGZ code you need to know to write your own formatting strings. It might look very strange at first, but once you see some TAGZ strings "in action" it will begin to make sense, and you will refer to it constantly.
+
 
+
Any question you have as a beginner has probably already been asked and answered in the forums a half dozen times. Please search the forums thoroughly for an answer before posting your question.
+
 
+
==== Using Columns UI ====
+
 
+
It is best to start with [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI] as your user interface; the TAGZ formatting needed is very basic and the panel plug-ins will make foobar much more user-friendly, resembling mp3 players you're more accustomed to.
+
 
+
Bookmark these sites before using Columns UI:
+
 
+
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 the Columns UI thread]: '''very''' large, but the first post contains links to important related sites
+
 
+
*[http://music.everywebhost.com/wiki/doku.php?id=columns_ui:faqs Columns UI FAQ]: a short FAQ, including installation instructions
+
 
+
*[http://music.everywebhost.com/wiki/doku.php?id=columns_ui:documentation Columns UI documentation]: it is '''crucial''' that you familiarize yourself with this over time
+
 
+
===== Panel Extensions =====
+
 
+
Installing panel extensions to Columns UI (such as [http://www.hydrogenaudio.org/forums/index.php?showtopic=29383 albumart] and [http://www.hydrogenaudio.org/forums/index.php?showtopic=29363 track info]) is simple; just copy the .dll into your foobar2000\components folder and restart foobar.  To enable these panels, first you must enable Columns UI's sidebar.  Check both "Enable sidebar" and "Show sidebar" in the "Columns UI" subgroup of the "Components" menu.  To add a panel or toolbar to the sidebar, right-click on any gray area of the sidebar for a list of items you can add.  A list of supported panels is given in [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 the Columns UI thread] of [http://www.hydrogenaudio.org/forums/index.php?showforum=28 the foobar2000 forums].
+
 
+
The [http://www.hydrogenaudio.org/forums/index.php?showtopic=29363 trackinfo] panel can be VERY helpful in teaching you how TAGZ strings behave. This panel updates in real-time as you edit its TAGZ-based configuration. It is recommended that you install and display this panel, using it as a "scratch pad" to help you become familiar with TAGZ.
+
 
+
==== Basic TAGZ Commands ====
+
 
+
The text displayed in each column is given by TAGZ code. To view this code look in "Preferences > Display > Columns UI > (Columns tab)"
+
 
+
The TAGZ code used for the "Artist" column is:
+
 
+
[%artist%]
+
 
+
This code retrieves the ARTIST field stored in the file's tag, if it exists. Not to be confused with TAGZ, a file's "tag" contains information about its artist, album, year, etc. The name of the field is ARTIST, so to retrieve the contents of this field, %artist% is used. The brackets [ ] around %artist% mean that the ARTIST field should only be shown if it exists in the file's tag. If there is no ARTIST field, nothing will be displayed; without the brackets, a question mark would be displayed.
+
 
+
Some common tag fields are:
+
 
+
*'''ARTIST'''
+
*'''ALBUM'''
+
*'''ALBUM ARTIST''' (for "Various Artists," etc.)
+
*'''ALBUM'''
+
*'''TRACKNUMBER'''
+
*'''TITLE''' (track title)
+
*'''DATE'''
+
*'''GENRE'''
+
*'''COMMENT'''
+
 
+
To see which tags are contained within a particular file, right-click on that file in the playlist and click "Properties."
+
 
+
Other fields, such as %__bitrate% and %_path%, are given in titleformat_help.html.
+
 
+
The TAGZ code used for the "Title" column is:
+
 
+
$if2(%title%,%_filename%)
+
 
+
Knowing what you learned from analyzing [%artist%], and referring to titleformat_help.html, try to figure out what this TAGZ code will produce, and why it was written this way. You might also want to try creating columns that contain your own TAGZ strings.
+
 
+
More info on the "Columns" tab of Columns UI's settings can be found on [http://music.everywebhost.com/wiki/doku.php?id=columns_ui:config:columns this page] of the Columns UI documentation.
+
 
+
==== Color Codes ====
+
 
+
Click on the "Colour" tab within the "Columns" tab of the Columns UI preferences. It is empty. If you want to customize the colors used in a column, you would put the color codes here and check the "Use custom colour spec" box above. Beneath the text box you will see a six-digit number with a block character on either side of it:
+
 
+
[]41800[]
+
 
+
This is what a color code looks like. To get a color code for a specific color, click on the "..." button, which will pop-up a pallette and return the color you choose in the same gray box.
+
 
+
The way you format colors is given by clicking the "Tools" button, then by clicking "String help." Concentrate on the first four items, which are required in every color code string:
+
 
+
text|selected text|background|selected background
+
 
+
For example, if I wanted my "Artist" column to display red text on white background when not selected, and yellow text on blue background when selected, I would use this format:
+
 
+
(red color code)|(yellow color code)|(white color code)|(blue color code)
+
 
+
The proper color code would then be:
+
 
+
[]0000FF[]|[]00FFFF[]|[]FFFFFF[]|[]FF0000[]
+
 
+
----
+
 
+
=== Advanced Use ===
+
 
+
----
+
 
+
=== Tips & Tricks ===
+
 
+
==== Placing Panels Above the Playlist ====
+
 
+
To place panels above the playlist, check "List all toolbars" in the "Other" tab of the Columns UI preferences.  When checked, clicking on the toolbar will give you the option of placing panels on the toolbar.  If a panel appears "squashed," it is because it needs to have a minimum height set in its preferences.  If the panel extension has no minimum height setting, you may place it in a [http://www.hydrogenaudio.org/forums/index.php?showtopic=28869 panel stack], and set give a minimum height via the panel stack options.
+
 
+
==== Handy Strings ====
+
 
+
===== Convert "The Beatles" to "Beatles, The" =====
+
 
+
$if($strcmp($left(%artist%,4),The ),$right(%artist%,$sub($len(%artist%),4))', 'The,%artist%)
+
 
+
----
+
 
+
=== Supported languages ===
+
 
+
* English
+
 
+
----
+
=== Supported platforms ===
+
 
+
* Windows
+
 
+
No known plans exists to port it to other platforms, but attempts have been made, with varying degrees of success, to run foobar2000 on x86 Linux systems by using Wine.
+
----
+
=== Guides ===
+
 
+
* [[FB2K's Masstagger]] (written by [[picmixer]])
+
----
+
=== External links ===
+
 
+
==== Official Site ====
+
  
 +
== Important Links ==
 +
=== Official site ===
 
* [http://www.foobar2000.org foobar2000.org: Homepage]
 
* [http://www.foobar2000.org foobar2000.org: Homepage]
 +
* [http://www.foobar2000.org/download foobar2000.org: Download]
 +
* [http://www.foobar2000.org/components foobar2000.org: Components]
  
* [http://www.foobar2000.org/download.html foobar2000.org: Download]
+
=== Community ===
 
+
* Official IRC Channel: #foobar2000 on [http://freenode.net/ freenode]
* [http://www.foobar2000.org/requirements.html foobar2000.org: Requirements]
+
* {{ha|https://hydrogenaud.io/index.php/board,28.0.html|foobar2000 Forums}}
 
+
* [http://foobar-users.de/ German Support Forum]
==== Community ====
+
* [http://foobar2000.pl/ Polish Support Forum]
 
+
* [http://www.fforum.ru/index.php?showforum=59 Russian-language forum]
* [http://foobar2000.h12.ru/ Russian foobar site]
+
* [http://www.foobar2000.ru/forum/ Another Russian-language forum]
 
+
==== Appearance ====
+
 
+
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery]: screenshot thread
+
 
+
* [http://pelit.koillismaa.fi/fb2k/index.php Default UI formatting strings]: cut-n-paste ready
+
 
+
* [http://foobar.nub4life.net/columns/ Columns UI configs]: .fcs file format
+
 
+
* [http://www.barciaonline.com/aural/foobarlooks/foobarlooks.htm foo_looks]: skin support for foobar
+
 
+
* [http://www.btinternet.com/~sean.m.kelly/ foo_looks community links]
+
 
+
==== Components / Plugins ====
+
 
+
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=21105 Most Sought-After Plugins]
+
 
+
* [http://pelit.koillismaa.fi/plugins/ Official third-party components site]
+
 
+
* [http://www.saunalahti.fi/cse/html/foobar.html case's Page]: special installer, diskwriter components, etc.
+
 
+
* [http://www.saunalahti.fi/cse/kode54/index.php kode's Page]: components: file-formats, archive-support, OSD, shuffle (temporary mirror since the above host is down)
+
 
+
* [http://www.stud.uni-karlsruhe.de/~uzbs/fb2k/html/ foosion's Page]: components: dbsearch, cut n' paste, history, etc.
+
  
* [http://members.chello.pl/d.sieradzki/foobar/ Messer's page]: components: freedb-masstagger, streaming with save-function, etc.
+
=== Appearance ===
 +
* {{ha|https://hydrogenaud.io/index.php/topic,61333.0.html|Default UI .fth thread}} (fast way to clone another's DUI configuration)
 +
* [[foobar2000:Preferences:Columns UI/Appearance|Columns UI appearance customization guides]]
 +
* {{ha|https://hydrogenaud.io/index.php/topic,31027.0.html|Columns UI configurations}}
  
* [http://music.everywebhost.com/ Musicmusic's Page]: components: textwriter, quicktag, custom sort, ui_columns, panels
+
== References ==
 +
<references/>
  
* [http://foobar2000.free.fr/ A comprehensive guide to foobar2000 components] (French)
+
[[Category:foobar2000]]
 +
[[Category:Media Players|foobar2000]]
 +
[[Category:CD Rippers]]
 +
[[Category:Software]]
 +
[[Category:Tag editors]]

Latest revision as of 15:04, 29 November 2019

foobar2000
foobar2000
Foobar2000 Logo.png
Foobar2000-1.0-default-ui.png
Screenshot of foobar2000 v1.0 using the default user interface
Developer(s) Peter Pawlowski
Release information
Initial release December 20, 2002; 18 years ago[1]
Stable release 1.5[2] (November 29, 2019)
Preview release 1.5 beta 21 / November 12, 2019
Compatibility
Operating system Windows
Additional information
Use Media Player
License Proprietary, BSD
Website foobar2000.org

foobar2000 is an advanced freeware audio player for the Windows platform. Some of the basic features include full Unicode support, ReplayGain support and native support for several popular audio formats.

Platforms[edit]

foobar2000 has been written specifically for the Windows platform, and there are no plans to port it to any others. However, although not officially supported, it is known to run on Linux and Mac OS X through Wine and WineBottler, respectively. Also there is an Arch Linux native package maintained by a community member.

Features[edit]

  • Powerful open component architecture allowing third-party developers to extend functionality of the player, including the ability to fully replace the user interface.
  • Full Unicode support: File names, user interface, tagging, etc.
  • ReplayGain support: Both playback and writing ReplayGain information to file tags.
  • Gapless playback.
  • Advanced tagging capabilities - through built-in Properties dialog and various optional tagging-related components.
  • Built-in Media Library functionality.
    • Intuitive query syntax for searching the Media Library.
    • Autoplaylist support: Generate dynamically updating playlists based on queries.
  • Customizable keyboard shortcuts.
  • Support for transcoding all supported audio formats using the Converter component (requires external command-line encoder executables for different output formats).
  • Secure CD ripping.
  • Streaming support.
  • Efficient handling of large playlists.
  • User interface with simple configuration to create even complex layouts quickly and easily.
  • Highly customizable display of track information using title formatting scripts.

Supported audio formats[edit]

Natively supported ("out-of-the-box"):

Supported through optional components:

In addition, foobar2000 can also play audio files within ZIP and RAR archives (typically compressed) directly, i.e. without requiring the user to extract the files first. More archive formats are supported via additional components: LHA/LZH, 7-Zip, JMA

Using foobar2000[edit]

Important pages[edit]

Specific guides[edit]

Preferences

Metadata

Title formatting

Others

External Guides[edit]

Technical information[edit]

Important Links[edit]

Official site[edit]

Community[edit]

Appearance[edit]

References[edit]

  1. Official Foobar2000 site & Foobar2000 0.3 & SDK! on hydrogenaudio
  2. Download foobar2000 for Windows on foobar2000.org