Hydrogenaudio Knowledgebase - User contributions [en]

Foobar2000:Components

2009-09-14T16:57:27Z

Reglib: /* General */ Added stub link for new foo_logitech_lcd component

{{fb2k}}
This page contains most Foobar2000 v0.9.x components available at time of [http://wiki.hydrogenaudio.org/index.php?title=Foobar2000:Components_0.9&action=history last update].
=1st Party Components=
The following components are created and maintained by the foobar2000 development team. Support for them should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=29 Support forum]
===Included in Installer===
[[Image:Optional_features.png|thumb|The Optional Features screen of the fb2k Installer]]
In addition to foobar2000's core functionality, the following components can be installed as needed, in the Optional Features section of the installer.
*Audio CD Support (foo_cdda) Adds Support for [[CD|Audio CD]] Playback
*Album List (foo_albumlist) Gives quick access to Media Library Content with customizable tree view
*Standard DSPs (foo_dsp_std) Equalizer, resampler, advanced limiter, hard limiter, stereo to 4 channel upmixer and a couple other effects
*ReplayGain Scanner (foo_rgscan) advanced solution for volume matching
*[[Foobar2000:Converter|Converter (foo_converter)]] Converts files to WAV or any other formats using command line encoders
*[[Foobar2000:File_operations|File Operations (foo_fileops)]] Renames, moves, or copies files according to specified patterns
*Archive Reader (foo_unpack) Adds support for playing files directly from ZIP RAR and GZIP archives
*ABX Comparator (foo_abx) [[ABX]] component for double blind listening tests
*[[Foobar2000:Components_0.9/Freedb_Tagger_(foo_freedb2)|freedb Tagger (foo_freedb2)]] Tag retrieving support from freedb service for any set of files (mp3,mpc,flac,...-not only CDDA tracks)

===Additional Components===
These components are provided as separate downloads, found on the [http://www.foobar2000.org/components/index.html Additional Components page].
* [[Foobar2000:Components 0.9/Monkey's Audio Decoder (foo_input_monkey)|Monkey's Audio Decoder (foo_input_monkey)]] Adds decoding support for Monkey's Audio files (.[[APE]]) as well as APE Link files (.[[APL]]).
*[[Foobar2000:Components 0.9/ALAC Decoder (foo_input_alac)|ALAC Decoder (foo_input_alac)]] Apple Lossless ([[ALAC]]) decoder (has known stability issues: random crashes during decoding)
*[[Foobar2000:Components 0.9/Playback Statistics (foo playcount)|Playback Statistics (foo playcount)]] Collects playback statistics for your Media Library content.
*[[Foobar2000:Components 0.9/Binary Comparator (foo_bitcompare)|Binary Comparator (foo_bitcompare)]] Performs binary comparison between two or more tracks and reports differences.
* [[Foobar2000:Components 0.9/File Integrity Verifier (foo_verifier)|File Integrity Verifier (foo_verifier)]] Checks specified media files for decoding errors.
* [[Foobar2000:Components 0.9/Quick Tagger (foo_quicktag)| Quick Tagger (foo_quicktag)]] Adds customizable context menu commands for quickly setting tag fields to preconfigured values
* [[Foobar2000:Components 0.9/Text Tools (foo texttools)|Text Tools (foo_texttools)]] Adds customizable context menu commands for copying information about the selected tracks to Windows Clipboard.
* [[Foobar2000:Components 0.9/Decoding Speed Test (foo_benchmark)|Decoding Speed Test (foo_benchmark)]] Measures decoding speed of audio files.
* [[Foobar2000:Components 0.9/Convolve (foo_convolve)|Impulse response convolver (foo_convolve)]] Allows arbitrary effects to be captured and used inside foobar2000. ([http://www.hydrogenaudio.org/forums/index.php?showtopic=10611 More Info])
* [[Foobar2000:Components 0.9/Kernel Streaming Output (foo_out_ks)|Kernel Streaming support (foo_out_ks)]] Allows bit-exact playback bypassing Windows kernel mixer.
* [[Foobar2000:Components 0.9/ASIO Output (foo_out_asio)|ASIO output support (foo_out_asio)]] Adds ASIO output support.
* [[Foobar2000:Components 0.9/WASAPI output support (foo_out_wasapi)|WASAPI output support (foo_out_wasapi)]] Adds Windows Audio Session API exclusive mode output support, allowing bit-exact output and muting all other sounds on Windows Vista systems.
* [[Foobar2000:Components 0.9/Audio CD Writer (foo_burninate)|Audio CD Writer (foo_burninate)]] CD burning support (requires Nero to be installed on your system.)
====Deprecated components====
These components are no longer maintained and provided only for compatibility with old configurations that rely on them. Functionality similar to what they offer is now provided through other still-maintained components.
* [[Foobar2000:Components 0.9/Masstagger (foo_masstag)|Masstagger (foo_masstag)]]

=3rd Party Components=
The following components are created and maintained by 3rd-party authors, using foobar2000's [http://www.foobar2000.org/SDK.html SDK]. Support for these components should be asked for in the [http://www.hydrogenaudio.org/forums/index.php?showforum=33 3rd Party Plugins forum] Asking for help directly in the component's thread is usually preferred.
== User Interfaces ==

=== Columns UI ===
[[Foobar2000:Components 0.9/Columns UI (foo_ui_columns)|Columns UI (foo_ui_columns)]] Very popular alternate interface for foobar2000 based on a columns and panel layout.

Columns UI introduced components with [[#Panels|panel]] capability which extend the user interface.

===GFX===
[[Foobar2000:Components 0.9/GFX window (foo_ui_gfx)|GFX window (foo_ui_gfx)]] is a skinnable user interface, which doesn't only focus on looking good but tries to be as fast and "lightweight" as possible, too. It uses lua as scripting language. Two skins are included in the archive. Development of this component appears to have ceased.

===Panels UI===
[[Foobar2000:Components 0.9/Panels UI (foo_ui_panels)|Panels UI (foo_ui_panels)]] gives the ability to manage multiple [[#Panels|panels]] through titleformating. No longer maintained and not compatible with current foobar2000 releases anymore.

== User Interface Addons ==
=== UI Elements ===
The [[Foobar2000:Components 0.9/Default user interface (foo_ui_std)|default user interface (foo_ui_std)]], included in the standard installation package, can be extended with the following component(s):
* [[Foobar2000:Components 0.9/Facets (foo_facets)|Facets (foo_facets)]] Flexible media library viewer based on linked lists.
=== Panels ===
Panels extend the functionality of Columns UI / Panels UI components.
* [[Foobar2000:Components 0.9/Album Art Panel (foo_uie_albumart)|Album Art Panel (foo_uie_albumart)]] Panel to display album art.
* [[Foobar2000:Components 0.9/Album Art Panel for matroska (foo_uie_albumart_mka)|Album Art Panel for matroska (foo_uie_albumart_mka)]] Albumart mod to read matroska covers.
* [[Foobar2000:Components 0.9/Album List Panel (foo_uie_albumlist)|Album List Panel (foo_uie_albumlist)]] Displays the database in a treeview using customizable sorting methods (by genre, artist, directory, etc.)
* [[Foobar2000:Components 0.9/Bookmarks (foo_uie_bookmarks)|Bookmarks (foo_uie_bookmarks)]] Help you remember positions in songs.
* [[Foobar2000:Components 0.9/Console (foo_uie_console)|Console (foo_uie_console)]] Panel version of console. Displays diagnostic messages. Requires Columns UI 0.1.3 beta 1 or newer.
* [[Foobar2000:Components 0.9/Cover Flow (foo_bubble_coverflow)|Cover Flow (foo_bubble_coverflow)]] The plugin can work either as a UI panel or a standalone window (found in the view menu), and a fullscreen mode for both.
* [[Foobar2000:Components 0.9/Dockable Panels (foo_dockable_panels)|Dockable Panels (foo_dockable_panels)]] It allows you to create windows that host columns ui panels as floating windows that can be attached to the side of the main foobar2000 window or each other.
* [[Foobar2000:Components 0.9/Egoh Spectrum Analyser (foo_uie_vis_egoh)|Egoh Spectrum Analyser (foo_uie_vis_egoh)]] Similar to the default spectrum analyser.
* [[Foobar2000:Components 0.9/Explorer Panel (foo_uie_explorer)|Explorer Panel (foo_uie_explorer)]] Displays a treeview of selected disks/folders.
* [[Foobar2000:Components 0.9/Grouped playlist panel (foo_uie_pvt)|Grouped playlist panel (foo_uie_pvt)]] Preview version of columns playlist with grouping.
* [[Foobar2000:Components 0.9/Lyrics Panel (foo_uie_lyrics_panel)|Lyrics Panel (foo_uie_lyrics_panel)]] Display lyrics stored in file tags.
* [[Foobar2000:Components 0.9/Music Browser (foo_browser)|Music Browser (foo_browser)]] Panels for Browsing Library, Similar to iTunes.
* [[Foobar2000:Components 0.9/Playlist Dropdown (foo_uie_playlists_dropdown)|Playlist Dropdown (foo_uie_playlists_dropdown)]] Displays the playlist in a dropdown menu.
* [[Foobar2000:Components 0.9/Playlist Tree (foo_playlist_tree)|Playlist Tree (foo_playlist_tree)]] Tree based media library with many available customizations.
* [[Foobar2000:Components 0.9/Power Panels (foo_uie_powerpanels)|Power Panels (foo_uie_powerpanels)]] Seekbar and volume transparent version panels. Useful for theming.
* [[Foobar2000:Components 0.9/ProjectM Visualisation Panel (foo_uie_vis_projectM)|ProjectM Visualisation Panel (foo_uie_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components 0.9/Queue Manager (foo_uie_queuemanager)|Queue Manager (foo_uie_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue.
* [[Foobar2000:Components 0.9/Quicksearch Panel (foo_uie_quicksearch)|Quicksearch Panel (foo_uie_quicksearch)]] Search toolbar that sends results to a playlist.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[Foobar2000:Components_0.9/Single Column Playlist (foo_uie_single_column_playlist)|Single Column Playlist Viewer (foo_uie_single_column_playlist)]] Displays the playlist in a single column with "headers". Useful for creating a narrower and smaller layout.
* [[Foobar2000:Components 0.9/Tabs (foo_uie_tabs)|Tabs (foo_uie_tabs)]] Tabs allows you to break Pauli's Exclusion principle by placing multiple panels in the same position at the same time.
* [[Foobar2000:Components 0.9/Track Info Panel (foo_uie_trackinfo)|Track Info Panel (foo_uie_trackinfo)]] Uses TAGZ to display information about a selected track.
* [[Foobar2000:Components 0.9/Track Info Panel Mod (foo_uie_trackinfo_mod)|Track Info Panel Mod (foo_uie_trackinfo_mod)]] Improved Track Info panel with the ability to use multiple fonts in the same panel. Also has the ability to display images.
* [[Foobar2000:Components 0.9/Typefind (foo_typefind)|Typefind (foo_typefind)]] Provides some in-line search facilities.
* [[Foobar2000:Components 0.9/WmpVis (foo_uie_wmpvis)|WmpVis (foo_uie_wmpvis)]] Uses the visualizations from WMP.
* [[Foobar2000:Components 0.9/WSH panel (foo_uie_wsh_panel)|WSH panel (foo_uie_wsh_panel)]] Windows script host panel.

==DSP==
* [[Foobar2000:Components 0.9/4Front Headphones (foo_dsp_headphones9)|4Front Headphones (foo_dsp_headphones9)]] Effects for headphone users.
* [[Foobar2000:Components 0.9/ATSurround Processor (foo_dsp_atsurround)|ATSurround Processor (foo_dsp_atsurround)]] Reproduces surround sound information present in many stereo audio material and more.
* [[Foobar2000:Components 0.9/BS2D (foo_dsp_bs2p)|BS2D (foo_dsp_bs2p)]] Improves headphone listening of regular hi-fi stereo records.
* [[Foobar2000:Components 0.9/Voice Cut Filter (foo_dsp_centercut)|Voice Cut Filter (foo_dsp_centercut)]] Voice cut filter.
* [[Foobar2000:Components 0.9/Channel Mixer (foo_channel_mixer)|Channel Mixer (foo_channel_mixer)]] Up/down mix to/from 1-6 channels.
* [[Foobar2000:Components 0.9/Crossfeed (foo_dsp_crossfeed)|Crossfeed (foo_dsp_crossfeed)]] Filters the music to help reduce fatigue caused by listening to music with headphones.
* [[Foobar2000:Components 0.9/Dolby Headphone Wrapper (foo_dsp_dolbyhp)|Dolby Headphone Wrapper (foo_dsp_dolbyhp)]] Dolby Headphone engine DLL.
* [[Foobar2000:Components 0.9/Dolby Pro Logic II wrapper (foo_dsp_pl2)|Dolby Pro Logic II wrapper (foo_dsp_pl2)]] Dolby Pro Logic II engine DLL (dll not included).
* [[Foobar2000:Components 0.9/Downmix (foo_dsp_downmix)|Downmix (foo_dsp_downmix)]] Downmix [[AC3]], [[DTS]], etc. to stereo.
* [[Foobar2000:Components 0.9/FreeSurround (foo_dsp_fsurround)|FreeSurround (foo_dsp_fsurround)]] It takes Dolby Surround / Pro Logic I/II encoded stereo music and decodes it into 5.1 sound.
* [[Foobar2000:Components 0.9/George Yohng's VST Wrapper (foo_dsp_vstwrap)|George Yohng's VST Wrapper (foo_dsp_vstwrapper)]] Enables VST plug-ins.
* [[Foobar2000:Components 0.9/LPCM - Delta-PCM Converter (foo_dsp_delta)|LPCM - Delta-PCM Converter (foo_dsp_delta)]] Noise sharpening filter.
* [[Foobar2000:Components 0.9/OSS/3D (foo_dsp_oss3ddsp)|OSS/3D (foo_dsp_oss3ddsp)]] Audio enhancement. SHAREWARE.
* [[Foobar2000:Components 0.9/Post-track Silence (foo_dsp_silence)|Post-track Silence (foo_dsp_silence)]] Inserts a configurable amount of silence after each track to help external devices like MiniDisc players to sync track changes.
* [[Foobar2000:Components 0.9/Secret Rabit Code Resampler (foo_dsp_src9)|Secret Rabit Code Resampler (foo_dsp_src9)]] Mega Nerd's Secret Rabbit Code sample rate converter.
* [[Foobar2000:Components 0.9/Skip Silence (foo_dsp_skip_silence)|Skip Silence (foo_dsp_skip_silence)]] Detect and skip silence.
* [[Foobar2000:Components 0.9/Soundtouch (foo_dsp_soundtouch)|Soundtouch (foo_dsp_soundtouch)]] Ajust pitch, tempo and rate.
* [[Foobar2000:Components 0.9/SSRC (foo_dsp_ssrc)|SSRC (foo_dsp_ssrc)]] Sample rate converter.
* [[Foobar2000:Components 0.9/Stereo Convolver (foo_dsp_stereoconv)|Stereo Convolver (foo_dsp_stereoconv)]] Take stereo audio and convolve each channel with two impulse responses.
* [[Foobar2000:Components 0.9/Surround Pan (foo_dsp_span)|Surround Pan (foo_dsp_span)]] WYSIWYG Surround panning.
* [[Foobar2000:Components 0.9/Tube Sound (foo_dsp_tube)|Tube Sound (foo_dsp_tube)]] Emulate tube sound.
* [[Foobar2000:Components 0.9/VLevel (foo_dsp_vlevel)|VLevel (foo_dsp_vlevel)]] Dynamic compressor which amplifies the quiet parts of music.
* [[Foobar2000:Components 0.9/VST Host (foo_dsp_vst)|VST Host (foo_dsp_vst)]] Adds support to Virtual Studio Technology audio interface.
* [[Foobar2000:Components 0.9/Winamp DSP Bridge (foo_dsp_winamp)|Winamp DSP Bridge (foo_dsp_winamp)]] Allows the use of Winamp DSPs.
* [[Foobar2000:Components 0.9/XOver (foo_dsp_xover)|XOver (foo_dsp_xover)]] Implements this digital crossover to achieve active multi-amplification.

==Input==
===Music codecs===
* [[Foobar2000:Components 0.9/AC3 Decoder (foo_ac3)|AC3 Decoder (foo_ac3)]] Decodes Dolby Digital lossy audio compression technologies format ([[AC3]]).
* [[Foobar2000:Components 0.9/AC3 Packet Decoder (foo_packet_decoder_ac3)|AC3 Packet Decoder (foo_packet_decoder_ac3)]] Needed for [[AC3]] in [[Matroska]].
* [[Foobar2000:Components 0.9/DTS Decoder (foo_dts)|DTS Decoder (foo_dts)]] Decodes Digital Theater Systems ([[DTS]]) audio format.
* [[Foobar2000:Components 0.9/Matroska Plugin (foo_input_mkx)|Matroska Plugin (foo_input_mkx)]] Decodes [[Matroska]] audio container format.
* [[Foobar2000:Components 0.9/MIDI Synthesizer Host (foo_midi)|MIDI Synthesizer Host (foo_midi)]]
* [[Foobar2000:Components 0.9/OptimFROG Lossless Audio Decoder (foo_input_ofr)|OptimFROG Lossless Audio Decoder (foo_input_ofr)]] Decodes both the Lossless ([[OptimFROG|OFR]]) and DualStream (OFS) audio format.
* [[Foobar2000:Components 0.9/Shorten Decoder (foo_input_shorten)|Shorten Decoder (foo_input_shorten)]] Decodes Shorten ([[SHN]]) audio format.
* [[Foobar2000:Components 0.9/SPDIF Passthrough (foo_spdif)|SPDIF Passthrough (foo_spdif)]] SPDIF passthrough for [[AC3]] and [[DTS]] files.
* [[Foobar2000:Components 0.9/TTA Audio Decoder (unofficial) (foo_input_tta)|TTA Audio Decoder (unofficial) (foo_input_tta)]] Decodes True Audio ([[TTA]]) audio format.
* [[Foobar2000:Components 0.9/WavPack Packet Decoder (foo_packet_decoder_wavpack)|WavPack Packet Decoder (foo_packet_decoder_wavpack)]].

===Other codecs===
* [[Foobar2000:Components 0.9/ADPCM Decoder (foo_adpcm)|ADPCM Decoder (foo_adpcm)]] Plays GameCube ADPCM audio data and some. (DSP, ADP, GCM, HPS, STM, AST, etc.)
* [[Foobar2000:Components 0.9/Another Slight Atari Player (foo_asap)|Another Slight Atari Player (foo_asap)]] [http://asap.sourceforge.net/ ASAP] is a player/converter of Atari 8-bit music for modern computers. It provides high-quality, identical to the popular Atari800 emulator, emulation of the POKEY sound chip and the 6502 processor.
* [[Foobar2000:Components 0.9/DUMB Module Decoder (foo_dumb)|DUMB Module Decoder (foo_dumb)]] Plays your favorite module files, and then some. (MOD, S3M, XM, IT, 669, PTM, PSM, MTM, UMX)
* [[Foobar2000:Components 0.9/Game Audio Decoder (foo_game)|Game Audio Decoder (foo_game)]] Plays Westwood's audio (AUD), Sierra's sounds (SFX/AUD), Core design's cd audio (cdaudio.WAD), Funcom's music (ISS), Rome Total War's IDX (.IDX/DAT), Timegate's format (RWD), EA's Pathfinder audio (MUS) and Ben Gerard's music (SC68).
* [[Foobar2000:Components 0.9/Game Emu Player (foo_gep)|Game Emu Player (foo_gep)]] Plays several emulation formats. (GBS, NSF, SPC, GYM, HES, VGM)
* [[Foobar2000:Components 0.9/Ganbatte! (foo_ganbatte)|Ganbatte! (foo_ganbatte)]] Plays compressed Edlib (.d00, .d01) files.
* [[Foobar2000:Components 0.9/Lunar 2 PCM Decoder (foo_lunar2)|Lunar 2 PCM Decoder (foo_lunar2)]] Plays audio files found on the original Lunar: Eternal Blue CD (RP*.PCM).
* [[Foobar2000:Components 0.9/M1 Decoder (foo_m1)|M1 Decoder (foo_m1)]] Plays arcade/pinball game sound.
* [[Foobar2000:Components 0.9/MDX Decoder (foo_input_mdx)|MDX Decoder (foo_input_mdx)]] MDX is a MIDI-like format that is designed to be played using the X68000's FM synthesizer.
* [[Foobar2000:Components 0.9/NSF Decoder (foo_input_nsf)|NSF Decoder (foo_input_nsf)]] NSF file is a sound data file containing instructions for the Nintendo Entertainment System (NES) sound hardware.
* [[Foobar2000:Components 0.9/PSF Decoder (foo_psf)|PSF Decoder (foo_psf)]] Plays PlayStation Sound Format (PSF) files.
* [[Foobar2000:Components 0.9/Reverse (foo_input_reverse)|Reverse (foo_input_reverse)]] Play music in reverse.
* [[Foobar2000:Components 0.9/SID Player 2 (foo_sid)|SID Player 2 (foo_sid)]] Sound chip of Commodore's CBM-II, Commodore 64 and Commodore 128 home computers.
* [[Foobar2000:Components 0.9/S98 Decoder (foo_input_s98)|S98 Decoder (foo_input_s98)]] Sound format for the NEC PC-98 microcomputer.
* [[Foobar2000:Components 0.9/USF Decoder (foo_input_usf)|USF Decoder (foo_input_usf)]] Decodes sound data ripped directly from a Nintendo 64 video game.

==Visualisation==
* [[Foobar2000:Components 0.9/Peakmeter (foo uie peakmeter)|Peakmeter for Columns UI (foo_uie_peakmeter)]] Displays the level for each channel in dB.
* [[Foobar2000:Components 0.9/Peakmeter Spectrum (foo uie vis peakmeter spectrum)|Peakmeter and spectrum analyzer (foo_uie_vis_peakmeter_spectrum)]] Plugin that combines a peakmeter with a spectrum analyzer.
* [[Foobar2000:Components 0.9/ProjectM Visualisation (foo_vis_projectM)|ProjectM Visualisation (foo_vis_projectM)]] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [[Foobar2000:Components 0.9/Shpeck (foo_vis_shpeck)|Shpeck (foo_vis_shpeck)]] Winamp visualisation plugins wrapper.
* [[#wmpvis|WmpVis (foo_uie_wmpvis)]] Uses the visualizations from WMP. ''Panel version only''.

==Other==
===General===
* [[Foobar2000:Components 0.9/Alarm (foo_alarm)|Alarm (foo_alarm)]] Starts playback at the specified period of time.
* [[Foobar2000:Components 0.9/Channel Usage Visualisation (foo_vis_channelusage)|Channel Usage Visualisation (foo_vis_channelusage)]] Channel Usage Visualisation.
* [[Foobar2000:Components 0.9/Common Services (foo_common)|Common Services (foo_common)]] Common services.
* [[Foobar2000:Components 0.9/Converter (foo converter)|Converter (foo converter)]]
* [[Foobar2000:Components 0.9/Cwbowron's Title formating (foo_cwb_hooks)|Cwbowron's Title Format Hooks (foo_cwb_hooks)]] Adds various global titleformat functions/variables, tagger window, new file tagger, and more. No longer maintained, not compatible with current foobar2000 versions anymore.
* [[Foobar2000:Components_0.9/Directory_Monitor_(foo_dirwatch)|Directory Monitor (foo_dirwatch)]] Allows you to specify directories to monitor, and notifies the Media Library of any changes (additions, renames, deletions) that occur.
* [[Foobar2000:Components 0.9/EXTM3U Playlist Creater (foo_extm3u)|EXTM3U Playlist Creater (foo_extm3u)]] Allow to save current playlist in the EXTM3U format.
* [[Foobar2000:Components 0.9/Feature Watcher (foo_whatsnew)|Feature Watcher (foo_whatsnew)]] Watches for added or removed features.
* [[Foobar2000:Components 0.9/File Date (foo_filedate)|File Date (foo_filedate)]] Add to file tag date added, accessed, created or modified from context menu entries.
* [[Foobar2000:Components 0.9/HyperIM (foo_2hyperim)|HyperIM (foo_2hyperim)]] Provides 19 media macros.
* [[Foobar2000:Components 0.9/iPod Manager (foo_dop)|iPod Manager (foo_dop)]] Experimental iPod plugin for foobar2000 0.9.2+, currently in alpha version.
* [[Foobar2000:Components 0.9/Logitech G15 LCD Display (foo_g15lcd)|Logitech G15 LCD Display (foo_g15lcd)]] Control the LCD panel on a Logitech G15 keyboard.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=72720|Logitech G15/G19/Z-10 Display (foo_logitech_lcd)] Customizable visualizations and track info on the LCD panel on a Logitech G15/G19/Z-10.
* [[Foobar2000:Components 0.9/Menu Addons (foo_menu_addons)|Menu Addons (foo_menu_addons)]] Adds a few shortcuts in menu.
* [[Foobar2000:Components 0.9/Open URL (foo_openurl)|Open URL (foo_openurl)]] Adds a context menu item to open URLs from metadata fields in a web browser.
* [[Foobar2000:Components 0.9/Pause On Lock (foo_lock)|Pause On Lock (foo_lock)]] Pauses/unpauses foobar2000 on workstation lock/unlock.
* [[Foobar2000:Components 0.9/Pause on Lock (extended) (foo_lock_ex)|Pause on Lock (extended) (foo_lock_ex)]] Pause playing on workstation lock. Optimized for use with Windows XP/2003.
* [[Foobar2000:Components 0.9/Preview (foo_preview)|Preview (foo_preview)]] Play only part of each track in the playlist.
* [[Foobar2000:Components 0.9/Replaygain Override (foo_rg_trn)|Replaygain Override (foo_rg_trn)]] Allows you to automatically switch between replaygain modes based on specified criteria (e.g. use track based RG for shuffle mode, etc.)
* [[Foobar2000:Components 0.9/Run (foo_run)|Run (foo_run)]] Able you to run a external program with the foobar syntax.
* [[Foobar2000:Components 0.9/Run Commands (foo_runcmd)|Run Commands (foo_runcmd)]] Search and execute menu commands.
* [[Foobar2000:Components 0.9/Scheduler (foo_scheduler)|Scheduler (foo_scheduler)]] Plugin for scheduling actions like play, stop, system shutdown/wake up and many more.
* [[Foobar2000:Components 0.9/Send To Device (foo_sendtodevice)|Send To Device (foo_sendtodevice)]] Add "Send to Device" feature.
* [[Foobar2000:Components 0.9/Shell Link Resolver (foo_lnk)|Shell Link Resolver (foo_lnk)]] Shell link resolver.
* [[Foobar2000:Components 0.9/Timebomb (foo_timebomb)|Timebomb (foo_timebomb)]] Stop playback / exit program after a specified time.
* [[Foobar2000:Components 0.9/Unpacker for JMA archive (foo_unpack_jma)|Unpacker for JMA archive (foo_unpack_jma)]]
* [[Foobar2000:Components 0.9/Unpacker for LHA archive (foo_unpack_lha)|Unpacker for LHA archive (foo_unpack_lha)]]
* [[Foobar2000:Components 0.9/Winamp API Emulator (foo_winamp_spam)|Winamp API Emulator (foo_winamp_spam)]] Designed to create a fake Winamp 1.x window which will act as a wrapper between applications written to use the Winamp API and foobar2000.

===Lyrics===
* [[Foobar2000:Components 0.9/Gasazip Lyrics (foo_gasazip)|Gasazip Lyrics (foo_gasazip)]] Search for lyrics and displays it in external window.
* [[Foobar2000:Components 0.9/LyricsDB (foo_lyricsdb)|LyricsDB (foo_lyricsdb)]] Search lyrics basing on song's artist title and sometimes album.
* [[Foobar2000:Components 0.9/Mini Lyrics (foo_ui_minilyrics)|Mini Lyrics (foo_ui_minilyrics)]] Lyrics viewer for synchronizing and displaying lyrics of the currently playing song.
* [[Foobar2000:Components 0.9/Sakura Script Lyrics (foo_sstp_lyrics)|Sakura Script Lyrics (foo_sstp_lyrics)]] Plays a SAKURA script lyrics to a SSP client.

===Notifier===
* [[Foobar2000:Components 0.9/AMIP Wrapper (foo_amipwrapper)|AMIP Wrapper (foo_amipwrapper)]] Complete now-playing plug-in for mIRC, PIRCH, Klient, Bersirc, other IRC and Mail clients, supporting full player control from mIRC, playlist search, clipboard integration, HTTP, dynamic image signatures, etc.
* [[Foobar2000:Components 0.9/Listening To (foo_listeningto)|Listening To (foo_listeningto)]] Sends NowPlaying information to Miranda IM.
* [[Foobar2000:Components 0.9/Miranda IM Notifier (foo_mim_notify)|Miranda IM Notifier (foo_mim_notify)]] Sends configurable information about the current playing song to Miranda-IM and shows popup windows with this info.
* [[Foobar2000:Components 0.9/MSN avatar changer (foo_uie_albumart_msn)|MSN avatar changer (foo_uie_albumart_msn)]] Set currently playing song's album art as avatar.
* [[Foobar2000:Components 0.9/MSN Now Playing (alt) (foo_msnalt)|MSN Now Playing (alt) (foo_msnalt)]] Show the current song as "Now Playing" in MSN and MS Live messenger.
* [[Foobar2000:Components 0.9/On-Screen Display (foo_osd)|On-Screen Display (foo_osd)]] On screen display of track information and volume bar.
* [[Foobar2000:Components 0.9/On-Screen Display GDI (foo_osd_gdiplus)|On-Screen Display GDI (foo_osd_gdiplus)]] Same as foo_osd but uses GDI+ for osd drawing.
* [[Foobar2000:Components 0.9/Pretty Popup (foo_prettypop)|Pretty Popup (foo_prettypop)]] Display a moderately sized popup of song information when a new song plays.

===Online database===
* [[Foobar2000:Components 0.9/Audioscrobbler (foo_audioscrobbler)|Audioscrobbler (foo_audioscrobbler)]] Audioscrobbler will send the name of every song you play on your computer to Last.fm. This effortlessly populates your profile to play radio you like and make personalized recommendations.
* [[Foobar2000:Components 0.9/Foosic Music Database (foo_sic)|Foosic Music Database (foo_sic)]] Sends track information to the [http://www.foosic.org/ foosic online database]. You can currently view your top artist, album and track statistics with foosic. Now support FooID fingerprints.

===Online radio===
* [[Foobar2000:Components 0.9/MSLive (foo_input_mslive)|MSLive (foo_input_mslive)]] Support for [[MMS]] and [[RSTP]] broadcast radio protocols.
* [[Foobar2000:Components 0.9/XM Radio Online Player (foo_xm)|XM Radio Online Player (foo_xm)]] Allow you to listen to XM Radio channels over the Internet by using XM Radio Online.

===Playlist tools===
* [[Foobar2000:Components 0.9/Audioscrobble Charts (foo_scrobblecharts)|Audioscrobble Charts (foo_scrobblecharts)]] Generate a playlist from an artist's Last.fm chart. It also allows you to sort a selection in the playlist by the artist's charts.
* [[Foobar2000:Components 0.9/Bin Pack (foo_binpack)|Bin Pack (foo_binpack)]] Creates playlists from a list with a maximum length.
* [[Foobar2000:Components 0.9/Command Playlist (foo_cmd_playlist)|Command Playlist (foo_cmd_playlist)]] Add /playlist-activate:"Name" to the foobar command line to activate the named playlist.
* [[Foobar2000:Components 0.9/Cuesheet Creator (foo_cuesheet_creator)|Cuesheet Creator (foo_cuesheet_creator)]] Cuesheet creator.
* [[Foobar2000:Components 0.9/Database Search (foo_dbsearch)|Database Search (foo_dbsearch)]] Database search.
* [[Foobar2000:Components 0.9/Default Video Player (foo_default_videoplayer)|Default Video Player (foo_default_videoplayer)]] Allows you to play your video clips from foobar playlist with default external player.
* [[Foobar2000:Components 0.9/Delete Current (foo_deletecurrent)|Delete Current (foo_deletecurrent)]] Adds a menu item giving the possibility to delete from computer the current playing track.
* [[Foobar2000:Components 0.9/Highlight Playing (foo_highlightplaying)|Highlight Playing (foo_highlightplaying)]] Highlights actual now playing item even when the playlist has been broken.
* [[Foobar2000:Components 0.9/History (foo_history)|History (foo_history)]] Very basic song history.
* [[Foobar2000:Components 0.9/Inactive Tracks (foo_skip)|Inactive Tracks (foo_skip)]] Skips tracks that are marked via a tag as inactive.
* [[Foobar2000:Components 0.9/MeowDB (foo_meowdb)|MeowDB (foo_meowdb)]] Takes the Media Library and outputs the results to a form and uploads it to your server using the cURL library.
* [[Foobar2000:Components 0.9/Navigator (foo_navigator)|Navigator (foo_navigator)]] Advanced history component.
* [[Foobar2000:Components 0.9/Now Playing Simple (foo_np_simple)|Now Playing Simple (foo_np_simple)]] Simple now playing plugin to output formatted string to plain text file.
* [[Foobar2000:Components 0.9/Playback Queue Viewer (foo_pqview)|Playback Queue Viewer (foo_pqview)]] Playback queue viewer.
* [[Foobar2000:Components 0.9/Playlist Bind (foo_playlist_bind)|Playlist Bind (foo_playlist_bind)]] Synchronize playlist with contents of specific directory.
* [[Foobar2000:Components 0.9/Playlist Clear (foo_playlistclear)|Playlist Clear (foo_playlistclear)]] All playlists are cleared at startup.
* [[Foobar2000:Components 0.9/Playlist Manager (foo_playlist_manager)|Playlist Manager (foo_playlist_manager)]] Playlist manager.
* [[Foobar2000:Components 0.9/Playlist Name Enhenced (foo_playlist_name_enhanced)|Playlist Name Enhenced (foo_playlist_name_enhanced)]] Appends automatically playlist info ("items / length") to all playlist names.
* [[Foobar2000:Components 0.9/Playlist Tools (foo_utils)|Playlist Tools (foo_utils)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Playlist Tools for Matroska (foo_utils_mka)|Playlist Tools for Matroska (foo_utils_mka)]] Provides various general commands.
* [[Foobar2000:Components 0.9/Queue Manager (foo_queuemanager)|Queue Manager (foo_queuemanager)]] It provides a window that shows the queue's contents and allows you to delete parts of them or clear the whole queue. ''Non-ColumnUI obsolete version, try panel version instead.''
* [[Foobar2000:Components 0.9/Randomized Playlist Entry (foo_random)|Randomized Playlist Entry (foo_random)]] Randomized playlist entry.
* [[Foobar2000:Components 0.9/Rating (foo_rating)|Rating (foo_rating)]] Display an icon in the systray with a tooltip popup from which you can choose a rating between 1 and 5 for the currently playing file.
* [[Foobar2000:Components 0.9/Remove Played (foo_removeplayed)|Remove Played (foo_removeplayed)]] It removes tracks from the playlist once they've been played.
* [[Foobar2000:Components 0.9/Track Finder (foo_trackfinder)|Track Finder (foo_trackfinder)]] Displays a context menu that lets you quickly find songs based on their album title or artists name.
* [[Foobar2000:Components 0.9/Track Position (foo_trackpos)|Track Position (foo_trackpos)]] Provides a new context menu item "place after current playing", that allows you to place any tracks after the current playing one in the playing playlist.
* [[Foobar2000:Components 0.9/XSPF (foo_xspf)|XSPF (foo_xspf)]] Adds XSPF support. XSPF is an open, XML based playlist format.

===Playback Statistics===
* [[Foobar2000:Components 0.9/Playback Statistics Custom (foo_playback_custom)|Playback Statistics Custom (foo_playback_custom)]] Stores playback statistics in tags like foo_playcount_mod, with claimed faster response, and uses foo_custominfo db if file is unavailable for writing.
* [[Foobar2000:Components 0.9/Play Count Mod (foo_playcount_mod)|Play Count Mod (foo_playcount_mod)]] Unofficial playcount modded to supress the update tag popups.

===Remote control===
* [[Foobar2000:Components 0.9/Advanced Controls (foo_advancedcontrols)|Advanced Controls (foo_advancedcontrols)]] Control all the playback functions from icons in the Taskbar Notification Area (play, pause, next, previous, open)
* [[Foobar2000:Components 0.9/Appcommand (foo_appcommand)|Appcommand (foo_appcommand)]] Adds the ability to assign multimedia keyboard buttons that sends APPCOMMAND (for example some HP keyboards) as (global) keyboard hotkeys.
* [[Foobar2000:Components 0.9/Bluetooth Control (foo_bluetooth_ctrl)|Bluetooth Control (foo_bluetooth_ctrl)]] Control your favourite music player using your favourite Symbian-based bluetooth enabled phone.
* [[Foobar2000:Components 0.9/COM Automation Server (foo_comserver2)|COM Automation Server (foo_comserver2)]] Allows controlling foobar2000 through COM Automation
* [[Foobar2000:Components 0.9/Control Server (foo_controlserver)|Control Server (foo_controlserver)]] Acts as a server to control Foobar2000. Connect with a telnet client and control it using ASCII commands.
* [[Foobar2000:Components 0.9/DDE Control (foo_ddecontrol)|DDE Control (foo_ddecontrol)]] Control foobar remotelly with DDE interprocess communication (interface in japanese only).
* [[Foobar2000:Components 0.9/HTTP Writer (foo_write_http)|HTTP Writer (foo_write_http)]] It's TCP/IP server that listens on a specified port for incoming requests such as play, stop, etc.
* [[Foobar2000:Components 0.9/Joystick Control (foo_joystick_control)|Joystick Control (foo_joystick_control)]] Control foobar2000 from a joystick/gamepad.
* [[Foobar2000:Components 0.9/Minibar2k (foo_Minibar2k)|Minibar2k (foo_Minibar2k)]] Control Foobar2k from your PDA (PocketPC based).
* [[Foobar2000:Components 0.9/Remote Control (foo_remotecontrol)|Remote Control (foo_remotecontrol)]] Adds support to Melloware Intelliremote software which claims to work with Creative remote control (Soundblaster Live!, Audigy, Extigy, Audigy ZS and Soundblaster X-Fi.)
* [[Foobar2000:Components 0.9/RM-1800 (foo_mr1800)|RM-1800 (foo_mr1800)]] Adds support of Creative X-Fi's remote (RM-1800).
* [[Foobar2000:Components 0.9/RM-X Media Edition (foo_rmx)|RM-X Media Edition (foo_rmx)]] Yet another plugin for remote control. SHAREWARE.
* [[Foobar2000:Components 0.9/Titlebar (foo_managedWrapper)|Titlebar (foo_managedWrapper)]] Create a personal title bar that shows the currently playing song on the top of the screen all the time. It supports custom-made skins.
* [[Foobar2000:Components 0.9/WinLIRC Client (foo_lirc)|WinLIRC Client (foo_lirc)]] Control Foobar from a remote control.

===Tagging===
* [[Foobar2000:Components 0.9/Custom Info (foo_custominfo)|Custom Info (foo_custominfo)]] Allows you to set info fields for files without modifying them.
* [[Foobar2000:Components 0.9/Discogs (foo_discogs)|Discogs (foo_discogs)]] Retrieve info and album art from Discogs.com database.
* [[Foobar2000:Components 0.9/Freedb Tagger (foo_freedb2)|Freedb Tagger (foo_freedb2)]] Freedb.org tagger. Now included with official foobar2000 installers.
* [[Foobar2000:Components 0.9/Live Show Tagger (foo_tradersfriend)|Live Show Tagger (foo_tradersfriend)]] Live show tagger.
* [[Foobar2000:Components 0.9/Masstagger Addons (foo_masstag_addons)|Masstagger Addons (foo_masstag_addons)]] Some addons for masstagger, including code page conversion and chinese conversion.

==Links==
* [http://pelit.koillismaa.fi/plugins/ Official third-party components site]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42730&st=0 List of components] from earlier versions not yet ported to 0.9.x.

* [[foobar2000:foobar2000|Go back to Main Page]]

Foobar2000:Components/ASIO Output (foo out asio)

2007-11-11T04:25:29Z

Reglib:

{{stub}}

=Description=

Adds ASIO output support.

=Installation and Usage=
# Install an ASIO driver such as ASIO4ALL
# Install the ASIO component for Foobar2000
# Configure ASIO
# Set your output device in Foobar2000 to ASIO

=Links=
* [http://www.foobar2000.com/components/index.html Official Website]
* [http://www.asio4all.com/ ASIO4ALL Universal ASIO Driver For WDM Audio]

Foobar2000:Components 0.9/Delete Current (foo deletecurrent)

2007-11-07T19:21:28Z

Reglib: added author's name and current version

Author: Niver

Current Version: 1.0.0.0 (Mar 10, 2007)

==Description==

* This is a simple component which adds a menu item giving the possibility to delete the current playing track. It becomes accessible as the menu item: Playback -> Delete current song.
* It allows you to assign a hotkey to this function.
* When the function is activated, a confirmation box pops up, and if the user chooses to delete, the current playing track is stopped and the associated file is moved to the recycle bin. The next track in the playlist, if any, is then started.

==Link==
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=53305 Discussion thread]
* [http://www.niversoft.com/downloads/foo_DeleteCurrent.zip Download link]

Foobar2000:Components 0.9/Delete Current (foo deletecurrent)

2007-11-07T19:19:32Z

Reglib: /* Description */ elaborated details

==Description==

* This is a simple component which adds a menu item giving the possibility to delete the current playing track. It becomes accessible as the menu item: Playback -> Delete current song.
* It allows you to assign a hotkey to this function.
* When the function is activated, a confirmation box pops up, and if the user chooses to delete, the current playing track is stopped and the associated file is moved to the recycle bin. The next track in the playlist, if any, is then started.

==Link==
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=53305 Discussion thread]
* [http://www.niversoft.com/downloads/foo_DeleteCurrent.zip Download link]

Foobar2000:Components 0.9/Playback Statistics Custom (foo playback custom)

2007-10-07T13:52:09Z

Reglib: /* Introduction */ linkified names of components

=Introduction=
This component stores playback statistics (play count, first played date, last played date) in a tag like [[Foobar2000:Components 0.9/Play Count Mod (foo playcount mod)|foo_playcount_mod]], but has a faster response time. If the component is unable to write a tag, you can have it write the information into the custom_info database (this requires you to have [[Foobar2000:Components 0.9/Custom Info (foo_custominfo)|foo_custominfo]] installed).

=Features=
* Writes playback statistics (play_counter, first_played, last_played) in tags
* Allows you to select which information to be written
* Allows you to select the tags where the information is to be stored: only in the tag, only in the custominfo database or in custominfo database only if tag cannot be written.
* Allows you to select when the information is updated (when the song starts playing, when it has finished etc).
* Allows you to convert from old standards and the official playback statistics format to new standards (e.g. Play_Time, Play_date, Last Played Timestamp, First Played Timestamp, Play Count etc. to Play_Counter, Last_Played, and First_Played)

=Default Settings=
Note: All of the following can be changed
* Default tag name for play count: %play_counter%
* Default tag name for first played: %first_played%
* Default tag name for last played: %last_played%
* format of first played and last played is: YYYY-MM-DD HH:MM:SS
* Update playback statistics: when song has been played for 60 seconds

=Installation=
Copy the foo_playback_custom to foobar2000's components directory. Restart foobar.

=Settings=
#. Run foobar2000
#. Check to see that foo_playback_custom is installed by going to Preferences -> Components. Also, check to see if you are using the latest version
#. Go to Preferences -> Tools -> Playback Statistics Custom

==Playback Statistics Update Timing==
This option allow you to change when the plugin updates information:
* Disable (Do not update)
(self explanatory)
* Update when a track is started
(self explanatory)
* Update when a track is ended
(self explanatory)
* Update when playback percentage is
You can select a value between 1% and 99%
* Update counter when playback second(s) is:
You can set any value greater than 1 second

==Playback statistics settings==
* Use the dropdown menu to select where you would like to store the information:
** 'only tag': this option will write the information into the song's tag.
** 'only foo_custominfo database': this option will write the information into the foo_custominfo database. You need the foo_custominfo component to be installed.
** 'tag and foo_custominfo...': this option will write the information to the song's tag whenever possible, if it is unable to do so (e.g. format does not support tagging -> wav), then the information will be stored in foo_custominfo.

Which option should i choose? Writing tags in information means that the information will always be present regardless of whether you rename or move the file. However, when you back up your collection even a single change in tag will register as a file change and will result in the backup program copying the entire file again. if you play lots of music, you could easily be forced to copy a lot of (otherwise unchanged) music needlessly. Also, writing the tag will change the file's MD5 signature, which will wreak havoc if you're using MD5 to verify your files. Foo_custominfo database option avoids the need to write the tags in the file, so you don't have the backup or the MD5 problem. However, foo_custominfo information is lost when you rename/move the file, and the options aren't acccessible through masstagger/properties window. The third option is a compromise between the two, however requires the foo_custominfo component to be installed. So it's not justified for people who don't use wav/wma files very often..

* Use the checkboxes to select which tags you want to write
* If you want to use a different tag to store the information (e.g. Play_Count instead of Play_counter), type Play_count in the box next to the tag and press the apply button.
* If you want to remove older tag standards as they are encountered, check the "convert old tag and remove" option. If you used to use the offfical playback statistics component, leave the tag names unchanged. Otherwise, replace as necessary

==Other Settings==
* Only Tracks in media library update playback statistics
If selected, no information will be written to songs that are not in the media library

* Store playback statistics with foo_custominfo database...
If selected, the component will write information to custominfo database if it fails to write a tag. NOTE: foo_custominfo has to be installed.

=FAQ=
'''Q.''' I get a popup window when playback statistics is being updated. Is this normal?

'''A.''' Normally, the window shouldn't appear while using the component. it only appears when I/O processing time while writing the tag is long. The track might also stop playing.

Cause:
* While playing losssless files (e.g. Flac, APE, Wavpack, TAK) which are highly compressed, IO processing time can be long
* Another component is trying to update the file information at the same time
* Your Hard drive is slow/ fragmented

Solution:
* Use a lower compressed lossless file
* Try changing the update time setting. (Usually components like foosic and audioscrobbler update at around 1 min.)
* Defrag your hard drive

If none of the above works, make the plugin write the information to the custominfo database.

'''Q.''' How do i convert the tag standards in ALL my files at once form the last_played_timestamp (etc.) format to the new standard?

'''A.''' The plugin is capable of cleaning the old information as they are encountered, however it might be more prudent to convert the old information to the newer standard in one go (for autoplaylists, columns display etc).

The main difference between the standards used by the official plugin and these unofficial ones are:
* ''Play_count'' in the official plugin vs ''Play_counter'' in the unofficial plugin

To convert from play_count to play_counter is pretty straightforward. Make an autoplaylist with all the files which have the "play_count" tag (by using <tt>NOT play_count MISSING</tt> in the Query). Select all files, right click them, go to <tt> Tagging -> Manage Scripts </tt>. Click <tt>Add</tt>, and choose <tt>Copy Value</tt>. Under Source put <tt>play_count</tt>, under Destination put <tt>play_counter</tt> and click OK. Again click <tt>Add</tt> and select <tt>Delete values</tt>. Put <tt>play_count</tt> and click OK. Run this script. Now all your play_count information is in play_counter field.

* ''Last_played_timestamp'' and ''First_played_timestamp'' (which are in the Win32Filetime format, and linked to last_played and first_played) vs ''Last_played'' and ''first_played'' (which are in YYYY-MM-DD HH:MM:SS format)
Note: the official playback plugin is still installed for this to work

This is slightly trickier because of the different standards used. One method to overcome this hurdle is to use Text Tools which is a part of foo_utils. Go to the Text Tools preferences and delete the entries in header, body and footer. Under body enter: <tt> %last_played%. %first_played%$crlf()</tt>. Now create a playlist of all the files that contain both first_played_timestamp and last_played_timestamp (use <tt>NOT first_played_timestamp MISSING AND NOT last_played_timestamp MISSING</tt> as the query). Select about 550 files in the autoplaylist, right click them <tt> Text Tools -> Copy Text</tt>. Now open Masstagger (do not unselect the files). Click <tt> Add</tt>, choose <tt>Input data (one line per track)</tt> and paste the contents into the resulting window (press Ctrl-V or right click paste). Under Scheme, use <tt>%last_played%. %first_played%</tt>. Click OK. and run the script. Repeat these steps for remaining files. NOTE: 550 files is due to the limitations of the masstagger window. If you try to paste more information, the contents will be truncated.

=Link=
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=55746 Discussion thread]
* [http://kitahei.cocolog-nifty.com/youyou/2007/04/foo_custominfo__6ab8.html Download Site]

Foobar2000:Components/ProjectM Visualisation (foo vis projectM)

2007-09-17T05:14:26Z

Reglib:

{{stub}}

==Description==
Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.

==Requirements==
* [http://acropolis.lokalen.org/wp-content/plugins/DownloadCounter/download.php?id=15 VC8 sp1 runtime libraries]
* [http://acropolis.lokalen.org/wp-content/plugins/DownloadCounter/download.php?id=20 libmmd.dll] Extract it to either the SYSTEM32 or foobar directory.
* Processor compatible with SSE instructions (Pentium 3 +).

==Installation==
# Download and unpack the projectM [http://stephan.kochen.nl/proj/foobar2000.html#projectM component DLL] into your foobar2000 components directory
# Download and unpack the [http://www.msu.edu/~singergr/foo_vis_projectm/ fonts and presets] from the 0.8.x version of projectM.
# Configure projectM in the preferences, making sure to point the fonts and presets to the corresponding directories used in step 2.
# Test projectM by activating it through the menu: "View -> Visualizations -> ProjectM"

==Link==
* [http://stephan.kochen.nl/proj/foobar2000.html#projectM Official Website]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=34584 Discussion thread (0.8.x)]

Foobar2000:Foobar2000

2006-08-15T14:33:40Z

Reglib: /* Specific Guides */ autoplaylist typo

==Introduction==

Foobar2000 is a freeware audio player, and more. It can not only play, it can also make a library, transcode files, rip CDs, ... the list goes on and on. A very powerful tool.

Check it out to explore its full power.

==Features==

* Open component architecture allowing third-party developers to extend functionality of the player
* Full Unicode support
* ReplayGain support
* Low memory footprint, efficient handling of really large playlists
* Advanced file info processing capabilities (generic file info box and masstagger)
* Highly customizable playlist display
* Customizable keyboard shortcuts
* Gapless playback
* Multiple playlists
* Music library
* Streaming Support
* Freeware

==Supported Audio Formats==

Native Support ("out-of-the-box"):
* [[MP1]], [[MP2]], [[MP3]], [[MP4]], [[Musepack]], [[AAC]], [[Ogg Vorbis]], [[FLAC]] / Ogg FLAC, [[WavPack]], [[WAV]], [[AIFF]], [[AU]], [[SND]], [[CDDA]], [[WMA]].

Supported through plug-ins:
* [[TTA]], [[Monkey's Audio]], [[ALAC]], [[Mod]], [[SPC]], [[TFMX]], [[Shorten]], [[OptimFROG]], [[LPAC]], [[AC3]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[Matroska]], etc.

In addition, foobar2000 can also play music directly from compressed RAR, ZIP archives without requiring the user to extract the files prior to playing.

Foobar2000 has been coded exclusively for the Windows platform with an English interface. The author does not intend to provide alternate language versions nor alternate platform versions. However, several people have had success running foobar2000 on x86 Linux systems by using [http://www.winehq.org/ Wine], although the Columns UI plugin is known to be problematic.

==Using foobar2000==
* [[foobar2000:components 0.9|foobar2000 0.9.x Components]]
* [[foobar2000:Directories|foobar2000 Directories]]
* [[foobar2000:FAQ|foobar2000 FAQ]]
* [[foobar2000:Encouraged Tag Standards|foobar2000 Encouraged Tag Standards]]
* [[foobar2000:Tips & Tricks|foobar2000 Tips & Tricks]]

===Technical Information===
* [[Foobar2000:ID3 Tag Mapping|ID3 Tag Mapping]]

===General Guides===

* [[foobar2000:Newbie User Guide|Newbie User Guide]]
* [[foobar2000:Intermediate User Guide|Intermediate User Guide]]
* [[foobar2000:Advanced User Guide|Advanced User Guide]]

===Specific Guides===

* [[foobar2000:Preferences|Preferences Dialog]]
* [[foobar2000:Titleformat Introduction|Introduction to titleformat scripts]]
* [[foobar2000:Titleformat Reference|Titleformat Reference]] - Quick-Reference for fields and functions
* [[foobar2000:Masstaggers User Guide|Masstagger]]
* [[foobar2000:Commandline Guide|Commandline Usage]]
* [[foobar2000:Increasing Performance|Increasing Performance]] - Tips

The following articles contain outdated information that does not apply to Foobar2000 v0.9:
* [[foobar2000:Tagz|Tagz (Simple Syntax)]]
* [[foobar2000:Tagscript|Tagscript (Script-like Syntax)]]
* [[foobar2000:Autoplaylist|Autoplaylist]] Guide and Cookbook

===External Guides===

* [http://eolindel.free.fr/foobar0.9/index.shtml Bachi-Bouzouk's guide] Complete manual about foobar2000 (version 0.9.X), Replaygain, the masstagger (with a tutorial) and common plugins.Two rather extensive FAQ for UI columns and overall use. Step by step guide to help new users.
* [http://foobar2000.audiohq.de/ Frank Bicking's German-language guide]
* [http://www.dizwell.com/html/foobar.htm Howard Rogers' Beginners' Configuration Guide]
* [http://shsc.info/foobar2000#titelanker2 SH/SC New user guide]
* [http://www.techspot.com/tweaks/foobar/ TechSpot's "complete guide to Foobar2000"]
* [http://eolindel.free.fr/foobar/ Bachi-Bouzouk's guide]

==== Scripting Tutorials ====

* [http://eolindel.free.fr/foobar0.9/tutorial.shtml Bachi-Bouzouk's Scripting Tutorial] Color schemes detailed. Main functions explained, basic and complex code for your columns. Several .fcs explained, detailed FAQ.
* [http://tagz.brother-john.net/ Brother John's Foobar2000 Scripting Tutorial]

==Important Links==

===Official Site===

* [http://www.foobar2000.org foobar2000.org: Homepage]
* [http://www.foobar2000.org foobar2000.org: Download]
* [http://www.foobar2000.org/requirements.html foobar2000.org: Requirements]

===Community===

* [http://www.hydrogenaudio.org/forums/index.php?showforum=28 Official foobar2000 forum]
* [http://www.fforum.ru/index.php?showforum=59 Russian-language forum]
* [http://www.foobar.prv.pl/ Polish-language forum]
* [http://foobar2000.fo.funpic.de/ German Support Forum]
* [http://www.foobar2000.tk Portuguese forum]

===Appearance===

* [[Foobar2000:Preferences:Columns UI/Appearance|Appearance]] Guides to customizing the look of your Foobar2000
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43077 Foobar Gallery 0.9]: screenshot thread
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery 0.8]: 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

==Thanks==

picmixer: ReplayGain tutorial

[[Category: foobar2000]]

Foobar2000:Foobar2000

2006-08-15T14:33:16Z

Reglib: /* Specific Guides */

==Introduction==

Foobar2000 is a freeware audio player, and more. It can not only play, it can also make a library, transcode files, rip CDs, ... the list goes on and on. A very powerful tool.

Check it out to explore its full power.

==Features==

* Open component architecture allowing third-party developers to extend functionality of the player
* Full Unicode support
* ReplayGain support
* Low memory footprint, efficient handling of really large playlists
* Advanced file info processing capabilities (generic file info box and masstagger)
* Highly customizable playlist display
* Customizable keyboard shortcuts
* Gapless playback
* Multiple playlists
* Music library
* Streaming Support
* Freeware

==Supported Audio Formats==

Native Support ("out-of-the-box"):
* [[MP1]], [[MP2]], [[MP3]], [[MP4]], [[Musepack]], [[AAC]], [[Ogg Vorbis]], [[FLAC]] / Ogg FLAC, [[WavPack]], [[WAV]], [[AIFF]], [[AU]], [[SND]], [[CDDA]], [[WMA]].

Supported through plug-ins:
* [[TTA]], [[Monkey's Audio]], [[ALAC]], [[Mod]], [[SPC]], [[TFMX]], [[Shorten]], [[OptimFROG]], [[LPAC]], [[AC3]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[Matroska]], etc.

In addition, foobar2000 can also play music directly from compressed RAR, ZIP archives without requiring the user to extract the files prior to playing.

Foobar2000 has been coded exclusively for the Windows platform with an English interface. The author does not intend to provide alternate language versions nor alternate platform versions. However, several people have had success running foobar2000 on x86 Linux systems by using [http://www.winehq.org/ Wine], although the Columns UI plugin is known to be problematic.

==Using foobar2000==
* [[foobar2000:components 0.9|foobar2000 0.9.x Components]]
* [[foobar2000:Directories|foobar2000 Directories]]
* [[foobar2000:FAQ|foobar2000 FAQ]]
* [[foobar2000:Encouraged Tag Standards|foobar2000 Encouraged Tag Standards]]
* [[foobar2000:Tips & Tricks|foobar2000 Tips & Tricks]]

===Technical Information===
* [[Foobar2000:ID3 Tag Mapping|ID3 Tag Mapping]]

===General Guides===

* [[foobar2000:Newbie User Guide|Newbie User Guide]]
* [[foobar2000:Intermediate User Guide|Intermediate User Guide]]
* [[foobar2000:Advanced User Guide|Advanced User Guide]]

===Specific Guides===

* [[foobar2000:Preferences|Preferences Dialog]]
* [[foobar2000:Titleformat Introduction|Introduction to titleformat scripts]]
* [[foobar2000:Titleformat Reference|Titleformat Reference]] - Quick-Reference for fields and functions
* [[foobar2000:Masstaggers User Guide|Masstagger]]
* [[foobar2000:Commandline Guide|Commandline Usage]]
* [[foobar2000:Increasing Performance|Increasing Performance]] - Tips

The following articles contain outdated information that does not apply to Foobar2000 v0.9:
* [[foobar2000:Tagz|Tagz (Simple Syntax)]]
* [[foobar2000:Tagscript|Tagscript (Script-like Syntax)]]
* [[foobar2000:Autoplaylist Autoplaylist]] Guide and Cookbook

===External Guides===

* [http://eolindel.free.fr/foobar0.9/index.shtml Bachi-Bouzouk's guide] Complete manual about foobar2000 (version 0.9.X), Replaygain, the masstagger (with a tutorial) and common plugins.Two rather extensive FAQ for UI columns and overall use. Step by step guide to help new users.
* [http://foobar2000.audiohq.de/ Frank Bicking's German-language guide]
* [http://www.dizwell.com/html/foobar.htm Howard Rogers' Beginners' Configuration Guide]
* [http://shsc.info/foobar2000#titelanker2 SH/SC New user guide]
* [http://www.techspot.com/tweaks/foobar/ TechSpot's "complete guide to Foobar2000"]
* [http://eolindel.free.fr/foobar/ Bachi-Bouzouk's guide]

==== Scripting Tutorials ====

* [http://eolindel.free.fr/foobar0.9/tutorial.shtml Bachi-Bouzouk's Scripting Tutorial] Color schemes detailed. Main functions explained, basic and complex code for your columns. Several .fcs explained, detailed FAQ.
* [http://tagz.brother-john.net/ Brother John's Foobar2000 Scripting Tutorial]

==Important Links==

===Official Site===

* [http://www.foobar2000.org foobar2000.org: Homepage]
* [http://www.foobar2000.org foobar2000.org: Download]
* [http://www.foobar2000.org/requirements.html foobar2000.org: Requirements]

===Community===

* [http://www.hydrogenaudio.org/forums/index.php?showforum=28 Official foobar2000 forum]
* [http://www.fforum.ru/index.php?showforum=59 Russian-language forum]
* [http://www.foobar.prv.pl/ Polish-language forum]
* [http://foobar2000.fo.funpic.de/ German Support Forum]
* [http://www.foobar2000.tk Portuguese forum]

===Appearance===

* [[Foobar2000:Preferences:Columns UI/Appearance|Appearance]] Guides to customizing the look of your Foobar2000
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43077 Foobar Gallery 0.9]: screenshot thread
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery 0.8]: 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

==Thanks==

picmixer: ReplayGain tutorial

[[Category: foobar2000]]

Discrete Cosine Transform

2006-07-26T07:43:50Z

Reglib: cleanup

The Discrete Cosine Transform (DCT) is similar to the [[DFT|Discrete Fourier Transform]]: It transforms a signal from the [[time domain]] into the [[frequency domain]]. And just as the fourier transform uses sine and cosine waves to represent a signal, the DCT only uses cosine waves. The DCT I and II, is mostly used in image compression, while [[MDCT]] (DCT-IV) is used in audio encoding.

The DCT is an invertible, discrete orthogonal transformation.

Talk:Download page

2006-07-06T19:43:30Z

Reglib: /* Nondestructive MP3 editors */ added more details

== table formatting confusion ==
I LOLed reading HotShot's comments. Here's a summary of things to watch when formatting table.

* '''The key is the first character.''' The pipe character ( | ) produces standard text, the exclaim character ( ! ) produces boldface text. Unless the table's style has been modified to make all text bold.

* '''The general alignment is set by the table's style,''' which is the very first line in the table definition.

* '''The line with a pipe-dash ( |- ) marks start of a new row.''' You can put style here, which applies to the whole row.

* '''You can override style for a single cell.''' E.g., the table is styled to center the text. To left align a cell, slip the style after the first char ( | or ! ) and put another pipe char before the cell's entry.

Hope this helps. Oh and for comment re: Linux downloads, see below...
--[[User:Pepoluan|pepoluan]] 04:34, 19 June 2006 (CDT)

== pretty tables ==
Looking at the recent changes here, it would be nice to be able to get into the style.css for the wiki to make it easier to make pretty tables.
--[[User:Reglib|Reglib]] 04:57, 1 June 2006 (CDT)

I'm not sure but I think you can do that at [[MediaWiki:Monobook.css]].
[[User:Jan|Jan]] 05:20, 1 June 2006 (CDT)

Currently all the CSS pages are protected. Templates are another option, but being really lazy, CSS can be simpler if you put in the initial work. I'll try template-only formatting for a few weeks, and if I think CSS is needed I'll come a hollerin'

some links for me to look at later: [http://en.wikipedia.org/wiki/Template_talk:Prettytable] [http://meta.wikimedia.org/wiki/Help:Tables#Style_templates]
[[MediaWiki:Common.css]]
--[[User:Reglib|Reglib]] 11:54, 1 June 2006 (CDT)

Templates are an excellent choice. I think for the timg being though, it would just be easier to add CSS2 tags instead. Templates would keep things more organized, despite the fact though.
--[[User:HotshotGG|HotshotGG]] 20:40, 1 June 2006 (CDT)

'''HotshotGG''', please keep the outer border ala the tables in [[Recommended Ogg Vorbis]]. Outer borders prevent table runins making them currently rather confusing and all mixed-up IMO.
Also... next time you make extensive editing, why not edit the whole page at once instead of section by section (1) I got a headache looking at the history :P (2) Jan still has not put spacing before section/subsection heads so the sections all run together :(
--[[User:Pepoluan|pepoluan]] 13:59, 5 June 2006 (CDT)

Disregard my previous comments. The dotted lines look ugly. I changed to 2px solid line. But the color looks... um, unappetizing now. Edit all page, and replace every occurence of #ffdead with something better (using notepad or similar).

A thought: Should we maintain same coloring for all page, or vary it like in the [[Listening Tests]] page?
--[[User:Pepoluan|pepoluan]] 15:14, 5 June 2006 (CDT)

It looks fine with the solid border. A user defined template would be better so that the style can be consist across the wiki pages. Yes do the same for the listening test page. The standard border is irrating to my eyes.
--[[User:HotshotGG|HotshotGG]] 19:06, 6 June 2006 (CDT)

Some bureaucracy before some real work... what nomenclature should we use for table formatting templates? It must be short, because they'll be used frequently, but still descriptive. Template:<prefix><family>[-variant] so... stuff like Template:TFpretty, Template:TFpretty-head
--[[User:Reglib|Reglib]] 17:36, 6 June 2006 (CDT)

using simple lingo will work. page-head, page-body, etc.
--[[User:HotshotGG|HotshotGG]] 19:06, 6 June 2006 (CDT)

Mmm... recolorized the tables. I pull out the colors just out of thin air. I ''think'' Microsoft's color is blue. I'm not sure about the others, though. As to why they are pastels, I tried pure colors (e.g. #0000ff) and believe me, it looks awful.

If we want to maintain sameness, IMO the template name must contain something to indicate its relation, e.g. Microsoft's color, Apple's color, Linux's color, etc.
--[[User:Pepoluan|pepoluan]] 14:16, 12 June 2006 (CDT)

I just realized that the tables are displayed differently in I.E 6.0 vs. Mozilla. This may be a problem? ;-/ [[User:HotshotGG|HotshotGG]] 23:38, 23 June 2005 (CDT)

== merge the linux download page? ==

Now that the Download Page is detailed into Windows and Mac OS/X parts (and also PocketPC part), do you think we ought to merge the Download Page for Linux here? --[[User:Pepoluan|pepoluan]] 16:29, 6 June 2006 (CDT)

Yes I think so.
[[User:Jan|Jan]] 16:58, 6 June 2006 (CDT)

Yes we should.
[[USer:HotshotGG|HotshotGG]] 18:58, 9 June 2006 (CDT)

mmmmmmkayyyy... I'll see what I can do over the next several days. --[[User:Pepoluan|pepoluan]] 14:16, 12 June 2006 (CDT)

It seems HotShotGG beat me to it... so can we retire/redirect the links to the Download Linux page? Don't forget to use the '''What links here''' link on the toolbox on the left (just under the search box) --[[User:Pepoluan|pepoluan]] 04:34, 19 June 2006 (CDT)

I think most - if not all - information from the Download Linux page has been merged. I've removed notice at top of this page, and put a decommission notice at the top of Download Linux page. I haven't replaced/deleted the link to Download Linux from anywhere else. --[[User:Pepoluan|pepoluan]] 08:53, 23 June 2006 (CDT)

== Nondestructive MP3 editors ==
win32:
* [http://mpesch3.de/ MP3DirectCut] - Freeware, supports cue sheets
* [http://musicutter.szm.sk/ musiCutter] - Freeware supports OGG Vorbis, VBR, cuesheets
* [http://www.mptrim.com/ MPTrim] - Freeware, made for trimming heads and tails
<nowiki>*nix:</nowiki>
* [http://www.puchalla-online.de/cutmp3.html cutmp3]
other/x-platform:
* [http://mp3splt.sourceforge.net/ MP3 Split] - Command Line, Vorbis, CUE,
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=35654&hl=pcut pcutmp3]
* [http://www.mpgedit.org/mpgedit/ mpgedit]
* [http://www.librelogiciel.com/software/PyMP3Cut/action_Presentation PyMP3Cut (Python)]

taken from http://www.hydrogenaudio.org/forums/index.php?showtopic=30049

Talk:Download page

2006-07-06T19:38:34Z

Reglib: proposed new section: mp3 editors

== table formatting confusion ==
I LOLed reading HotShot's comments. Here's a summary of things to watch when formatting table.

* '''The key is the first character.''' The pipe character ( | ) produces standard text, the exclaim character ( ! ) produces boldface text. Unless the table's style has been modified to make all text bold.

* '''The general alignment is set by the table's style,''' which is the very first line in the table definition.

* '''The line with a pipe-dash ( |- ) marks start of a new row.''' You can put style here, which applies to the whole row.

* '''You can override style for a single cell.''' E.g., the table is styled to center the text. To left align a cell, slip the style after the first char ( | or ! ) and put another pipe char before the cell's entry.

Hope this helps. Oh and for comment re: Linux downloads, see below...
--[[User:Pepoluan|pepoluan]] 04:34, 19 June 2006 (CDT)

== pretty tables ==
Looking at the recent changes here, it would be nice to be able to get into the style.css for the wiki to make it easier to make pretty tables.
--[[User:Reglib|Reglib]] 04:57, 1 June 2006 (CDT)

I'm not sure but I think you can do that at [[MediaWiki:Monobook.css]].
[[User:Jan|Jan]] 05:20, 1 June 2006 (CDT)

Currently all the CSS pages are protected. Templates are another option, but being really lazy, CSS can be simpler if you put in the initial work. I'll try template-only formatting for a few weeks, and if I think CSS is needed I'll come a hollerin'

some links for me to look at later: [http://en.wikipedia.org/wiki/Template_talk:Prettytable] [http://meta.wikimedia.org/wiki/Help:Tables#Style_templates]
[[MediaWiki:Common.css]]
--[[User:Reglib|Reglib]] 11:54, 1 June 2006 (CDT)

Templates are an excellent choice. I think for the timg being though, it would just be easier to add CSS2 tags instead. Templates would keep things more organized, despite the fact though.
--[[User:HotshotGG|HotshotGG]] 20:40, 1 June 2006 (CDT)

'''HotshotGG''', please keep the outer border ala the tables in [[Recommended Ogg Vorbis]]. Outer borders prevent table runins making them currently rather confusing and all mixed-up IMO.
Also... next time you make extensive editing, why not edit the whole page at once instead of section by section (1) I got a headache looking at the history :P (2) Jan still has not put spacing before section/subsection heads so the sections all run together :(
--[[User:Pepoluan|pepoluan]] 13:59, 5 June 2006 (CDT)

Disregard my previous comments. The dotted lines look ugly. I changed to 2px solid line. But the color looks... um, unappetizing now. Edit all page, and replace every occurence of #ffdead with something better (using notepad or similar).

A thought: Should we maintain same coloring for all page, or vary it like in the [[Listening Tests]] page?
--[[User:Pepoluan|pepoluan]] 15:14, 5 June 2006 (CDT)

It looks fine with the solid border. A user defined template would be better so that the style can be consist across the wiki pages. Yes do the same for the listening test page. The standard border is irrating to my eyes.
--[[User:HotshotGG|HotshotGG]] 19:06, 6 June 2006 (CDT)

Some bureaucracy before some real work... what nomenclature should we use for table formatting templates? It must be short, because they'll be used frequently, but still descriptive. Template:<prefix><family>[-variant] so... stuff like Template:TFpretty, Template:TFpretty-head
--[[User:Reglib|Reglib]] 17:36, 6 June 2006 (CDT)

using simple lingo will work. page-head, page-body, etc.
--[[User:HotshotGG|HotshotGG]] 19:06, 6 June 2006 (CDT)

Mmm... recolorized the tables. I pull out the colors just out of thin air. I ''think'' Microsoft's color is blue. I'm not sure about the others, though. As to why they are pastels, I tried pure colors (e.g. #0000ff) and believe me, it looks awful.

If we want to maintain sameness, IMO the template name must contain something to indicate its relation, e.g. Microsoft's color, Apple's color, Linux's color, etc.
--[[User:Pepoluan|pepoluan]] 14:16, 12 June 2006 (CDT)

I just realized that the tables are displayed differently in I.E 6.0 vs. Mozilla. This may be a problem? ;-/ [[User:HotshotGG|HotshotGG]] 23:38, 23 June 2005 (CDT)

== merge the linux download page? ==

Now that the Download Page is detailed into Windows and Mac OS/X parts (and also PocketPC part), do you think we ought to merge the Download Page for Linux here? --[[User:Pepoluan|pepoluan]] 16:29, 6 June 2006 (CDT)

Yes I think so.
[[User:Jan|Jan]] 16:58, 6 June 2006 (CDT)

Yes we should.
[[USer:HotshotGG|HotshotGG]] 18:58, 9 June 2006 (CDT)

mmmmmmkayyyy... I'll see what I can do over the next several days. --[[User:Pepoluan|pepoluan]] 14:16, 12 June 2006 (CDT)

It seems HotShotGG beat me to it... so can we retire/redirect the links to the Download Linux page? Don't forget to use the '''What links here''' link on the toolbox on the left (just under the search box) --[[User:Pepoluan|pepoluan]] 04:34, 19 June 2006 (CDT)

I think most - if not all - information from the Download Linux page has been merged. I've removed notice at top of this page, and put a decommission notice at the top of Download Linux page. I haven't replaced/deleted the link to Download Linux from anywhere else. --[[User:Pepoluan|pepoluan]] 08:53, 23 June 2006 (CDT)

== Nondestructive MP3 editors ==
win32:
* [http://mpesch3.de/ MP3DirectCut]
* [http://musicutter.szm.sk/ musiCutter]
* [http://www.mptrim.com/ MP3Trim]
* [http://mp3splt.sourceforge.net/ MP3 Split]
<nowiki>*nix:</nowiki>
* [http://www.puchalla-online.de/cutmp3.html cutmp3]
other/x-platform:
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=35654&hl=pcut pcutmp3]
* [http://www.mpgedit.org/mpgedit/ mpgedit]
* [http://www.librelogiciel.com/software/PyMP3Cut/action_Presentation PyMP3Cut (Python)]

taken from http://www.hydrogenaudio.org/forums/index.php?showtopic=30049

Download page

2006-07-06T19:31:05Z

Reglib: /* Encoders, Decoders, Etc. */ extra space was annoying me

All programs mentioned anywhere in the wiki can be downloaded here.

'''Note:''' Linux downloads have been migrated here. The older Download Linux page will not be maintained anymore.

=CD Rippers=

===Windows===

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ccccff;"
|- style="background:#ccccff"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:300px;" | Description
|-
! align="left" | [[CDex]]
| GPL
| [http://cdexos.sourceforge.net/ here]
| align="left" | An open-source ripper for Windows that uses cdparanoia functionality
|
|- style="background-color: #eeeeee;"
! align="left" | [[dBpowerAMP]]
| Free
| [http://www.dbpoweramp.com/ here]
| align="left" | A secure ripper for Windows that includes Accurate Stream functionality
|-
! align="left" | Deep Ripper
| GPL
| [http://www.deepburner.com/ here]
|
|- style="background-color: #eeeeee;"
! align="left" | [[EAC]]
| Free
| [http://www.exactaudiocopy.de/ here]
| align="left" | One of the most secure rippers for Windows, C2, Accurate Stream, etc.
|}

===Mac OS/X===

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #bbffbb;"
|- style="background:#bbffbb;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:350px;" | Description
|-
! align="left" | [[Max]]
| GPL
| [http://sbooth.org/Max/ here]
| align="left" | A secure ripper for OS/X that uses additional cdparanoia functionality
|}

===Linux===

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ffcccc;"
|- style="background:#ffcccc;"
! style="width:150px;" | Name
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:320px;" | Description
|- style="background-color:#eeeeee;"
! align="left" | abcde
| GPL
|[http://www.hispalinux.es/~data/abcde.php here]
| align="left" | A command-line based ripper with cdparanoia functionality
|-
! align="left" | [[cdparanoia]]
| BSD, GPL
| [http://www.xiph.org/paranoia/ here]
| align="left" | One of the first secure standalone rippers for the Linux platform
|- style="background-color:#eeeeee;"
! align="left" | [[Rubyripper]]
| GPL
| [http://www.rubyforge.org/ here]
| align="left" | A secure ripper for the Linux that uses additional cdparanoia functionality
|-
! align="left" | [[Grip]]
| GPL
| [http://www.nostatic.org/grip here]
| align="left" | An open-source Gnome interface ripper that uses cdparanoia functionality
|}

=CD Writers=

===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ccccff;"
|- style="background:#ccccff"
! style="width:185px;" | Name
! style="width:80px;" | Unicode
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:270px;" | Description
|-
! align="left" | BurnAtOnce
| N
| Free
| [http://www.burnatonce.com/ here]
| align="left" | CD writing application based upon CDRDAO
|
|- style="background-color: #eeeeee;"
! align="left" | [[Burrrn]] (CDA only)
| N
| Free
| [http://www.burrrn.net/ here]
|
|-
! align="left" | CDBurnerXP Pro
|
| Free
| [http://www.cdburnerxp.se/ here]
|
|- style="background-color: #eeeeee;"
! align="left" | DeepBurner Free
| N
| GPL
| [http://www.deepburner.com/ here]
|
|-
! align="left" | DeepBurner Pro
|
| Shareware
| [http://www.deepburner.com/ here]
|
|- style="background-color: #eeeeee;"
! align="left" | Express Burn
| N
| Free
| [http://nch.com.au/burn/index.html here]
|
|-
! align="left" | Express Burn Plus
|
| Shareware
| [http://nch.com.au/burn/index.html here]
|
|-style="background-color: #eeeeee;"
! align="left" | [[Nero]]
| N
| Shareware
| [http://www.nero.com/ here]
| align="left" | Popular windows commercial CD Writing application
|-
! align="left" | SilentNight Micro-CD Burner
| N
| Free
| [http://www.silentnight2004.com/Download.html here]
|
|}

===Mac OS/X===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #bbffbb;"
|- style="background:#bbffbb;"
! style="width:130px;" | Name
! style="width:80px;" | Unicode
! style="width:90px;" | License
! style="width:100px;" | Website
! style="width:310px;" | Description
|-
! align="left" | [[FireStarter FX]]
| N
| Free
| [http://www.projectomega.org/subcat.php?lg=en&php=products_firestarter here]
| align="left" | Free OS/X Cocoa CD writing application
|- style="background-color: #eeeeee;"
! align="left" | [[X-CD-Roast]]
| N
| Free
| [http://www.xcdroast.org/xcdr098/xcdrosX.html here]
| align="left" | New OS/X port of this Linux CD writing application
|}

===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ffcccc;"
|- style="background:#ffcccc;"
! style="width:130px;" | Name
! style="width:80px;" | Unicode
! style="width:90px;" | License
! style="width:100px;" | Website
! align="center" style="width:260px;" | Description
|-
! align="left" | CDRDAO
| N
| GPL
| [http://www.cdrdao.org/ here]
| align="left" | Cdrdao records audio or data CD-Rs in disk-at-once (DAO) mode
|- style="background-color:#eeeeee;"
! align="left" | Gnome Baker
| N
| GPL
| [http://www.gnomefiles.org/app.php?soft_id=291 here]
| align="left" | Popular open-source Gnome interface CD/DVD writing application
|-
! align="left" | [[k3B]]
| N
| GPL
| [http://www.k3b.org/ here]
| align="left" | Popular open-source KDE CD writing application for Linux platform
|- style="background-color:#eeeeee;"
! align="left" | [[X-CD-Roast]]
| Y
| GPL
| [http://www.xcdroast.org here]
| align="left" | New open-source Gnome interface CD/DVD writing application
|}

=Multimedia Players=

===Windows===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ccccff;"
|- style="background:#ccccff"
! style="width:120px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! align="center" style="width:220px;" | Description
|-
! align="left" | [[Foobar2000]]
| Free
| [http://www.foobar2000.org/ here]
| align="left" | Advanced tagging, plugin capabilities, and kernel streaming support
|- style="background-color: #eeeeee;"
! align="left" | [[MediaMonkey]]
| Free, Shareware
| [http://www.mediamonkey.com/ here]
| align="left" | Supports many Winamp plugins
|-
! align="left" | MusikCube
| BSD
| [http://www.musikcube.com/ here]
| align="left" | Supports dynamic playlists and advanced SQL capabilities
|- style="background-color: #eeeeee;"
! align="left" | VUplayer
| Free
| [http://www.vuplayer.com/ here]
| align="left" | Supports many popular digital audio codecs and MOD tracker formats
|-
! align="left" | [[Winamp]]
| Free, Shareware
| [http://www.winamp.com/ here]
| align="left" | Popular audio player for Windows
| align="left" |
|- style="background-color: #eeeeee;"
! align="left" | [[wxMusik]]
| GPL
| [http://musik.berlios.de/ here]
| align="left" |A cross-platform open-source audio player
|}

===Mac OS/X===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #bbffbb;"
|- style="background:#bbffbb;"
! style="width:120px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:220px;" | Description
|-
! align="left" | Cog
| GPL
| [http://cogosx.sourceforge.net/ here]
| align="left" | An open-source digital audio player for OS/X.
|- style="background-color: #eeeeee;"
! align="left" | [[wxMusik]]
| GPL
| [http://musik.berlios.de/ here]
| align="left" |A cross-platform open-source audio player
|}

===Linux===
{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ffcccc;"
|- style="background:#ffcccc;"
! style="width:120px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:220px;" | Description
|-
! align="left" | [[wxMusik]]
| GPL
| [http://musik.berlios.de/ here]
| align="left" |A cross-platform open-source audio player
|- style="background-color: #eeeeee;"
! align="left" | [[XMMS]]
| GPL
| [http://www.xmms.org/ here]
| align="left" | Popular open-source audio player similiar to Winamp
|}

===PocketPC===
''These players may not play all your media files. Check their websites for the format support.''
* GSPlayer: http://hp.vector.co.jp/authors/VA032810/
* MortPlayer: http://www.sto-helit.de/
* TCPMP: http://tcpmp.corecodec.org/about

=Tagging Utilities=

===Windows===

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ccccff;"
|- style="background:#ccccff"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:270px;" | Description
|-
! align="left" | Abander TagControl
| Shareware
| [http://www.softartstudio.com/tagcontrol/ here]
|
|- style="background-color: #eeeeee;"
! align="left" | AudioShell
| Free
| [http://www.softpointer.com/AudioShell.htm here]
| align="left" | Integrates with Windows Explorer
|-
! align="left" | Magic MP3 Tagger
| Shareware
| [http://www.magic-tagger.com here]
| align="left" | Optimized for automatic music identification
|- style="background-color: #eeeeee;"
! align="left" | [[MediaMonkey]]
| Free, Shareware
| [http://www.mediamonkey.com/ here]
| align="left" | Also a Media Player & Library
|-
! align="left" | MP3 Book Helper
| Free
| [http://mp3bookhelper.sourceforge.net/ here]
| align="left" | Tags [[ID3v1]], ID3v2.3, and Vorbis comments. Features: FreeDB, unicode, guessing and matching, and supporting PAR, SFV, SV, and NFO generation.
|- style="background-color: #eeeeee;"
! align="left" | Mp3tag
| Free
| [http://www.mp3tag.de/ here]
| align="left" | Tags all files supporting [[ID3]], [[APEv2]], and Vorbis comments, not only MP3s
|-
! align="left" | Mp3/Tag Studio
| Shareware
| [http://www.magnusbrading.com/mp3ts/ here]
| align="left" | Supports ID3v1 & v2 '''only'''. Powerful matching and fancy filters
|- style="background-color: #eeeeee;"
! align="left" | [[Tag.exe]]
| GPL
| [http://www.synthetic-soul.co.uk/tag/ here]
| align="left" | Command-line universal tagger for Windows
|-
! align="left" | Tag & Rename
| Shareware
| [http://www.softpointer.com/tr.htm here]
|
|- style="background-color: #eeeeee;"
! align="left" | TagScanner
| Free/Donate
| [http://xdev.narod.ru/tagscan_e.htm here]
|
|-
! align="left" | The GodFather
| Card/Donate
| [http://users.otenet.gr/~jtcliper/tgf/ here]
|
|}

===Mac OS/X===

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #bbffbb;"
|- style="background:#bbffbb;"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:270px;" | Description
|-
! align="left" | Tag
| GPL
| [http://sbooth.org/Tag/ here]
| align="left" | An open-source tagging application for OS/X
|}

===Linux===

{| border="0" cellpadding="0" cellspacing="1" style="text-align:center; border:2px solid #ffcccc;"
|- style="background:#ffcccc;"
! style="width:150px;" | Name
! style="width:100px;" | License
! style="width:100px;" | Website
! style="width:270px;" | Description
|-
! align="left" | EasyTAG
| GPL
| [http://easytag.sourceforge.net/ here]
| align="left" | GTK+ Tagging utility
|- style="background-color: #eeeeee;"
! align="left" | Ex Falso
| Free??
| [http://www.sacredchao.net/quodlibet here]
| align="left" | GTK+ Tagging utility
|}

=Encoders, Decoders, Etc.=

All basic tools needed to make use of the audio formats supported here.

==[[MP3]]==

* [[LAME]] encoder/decoder: [http://www.rarewares.org/mp3.html download pre-compiled binaries here]. Also check the [[Lame Compiles|Latest recommended version]] page.
* [[MP3Gain]], a replaygain-like utility: [http://mp3gain.sourceforge.net/download.php download here]

==[[Ogg Vorbis]]==

Currently, all recommended Ogg Vorbis utilities are available at the [http://www.rarewares.org/ogg.html Rarewares Ogg Vorbis page]. The following tools are important:

* '''OggEnc2''': A command-line Ogg Vorbis encoder that can be used with most CD rippers.

* '''OggDec''': Command-line decoder.

* '''[[OggDropXPd]]''': An easy to use, drag'n'drop encoder/decoder with support for automatic tagging, renaming and playlist creation on encoding.

* ''Encoding DLLs'': For encoding within CDex or WinLame.

* '''VorbisGain''': The [[Replaygain]] utility for Ogg Vorbis.

In addition, the [[Lancer]] suite — a highly SSE-optimized suite of utilities and libraries — are available at [http://homepage3.nifty.com/blacksword/ this page] ''(in Japanese)''. See [[Lancer#Platform-specific Builds|this section]] for information about the different builds.

==Musepack ([[MPC]])==

* MPC Encoder (mppenc): [http://www.saunalahti.fi/~cse/mpc/encoders/mppenc-windows-1.14.zip 1.14 Beta] / [http://www.saunalahti.fi/~cse/mpc/encoders/mppenc-windows-1.15r.zip 1.15r Alpha] (Both these versions are safe to use.)

* MPC Decoder (mppdec): [http://www.saunalahti.fi/~cse/mppdec.zip Download latest version]

* [[Replaygain]] utility: [http://www.saunalahti.fi/~cse/replaygain.zip Download latest version]

==[[FLAC]]==

* CoolEdit / Adobe Audition Filter supporting FLAC: [http://www.vuplayer.com/other.php download here]
* Various FLAC-related utilities (incl. ReplayGain utility): [http://flac.sourceforge.net/download.html FLAC's SourceForge Download page]

==Transcoders==
''Note: Although these tools may convert from one encoding to another, please remember that [[transcoding]] to any [[lossy]] encoding will result in a degraded quality.''
* BeSweet: http://besweet.notrace.dk/
* dBpowerAMP Music Converter (dMC): http://www.dbpoweramp.com/dmc.htm
* MediaCoder: http://www.rarewares.org/mediacoder/
* WinLAME: http://winlame.sourceforge.net/

=Drivers=

==ASPI==
* Ahead Nero ASPI Driver: [http://www.nero.com/nero6/eng/ASPI_Driver.html official website]
* Adaptec Windows ASPI Package: [http://www.adaptec.com/worldwide/support/suppdetail.jsp?sess=no&prodkey=ASPI-4.70 official website]
* ASPI4all [http://www.3a.net/main.php?id=20 "official" website]
* FrogAspi [http://www.frogaspi.org/ official website]
* VOB ASAPI Driver 1.3: [http://www.rarewares.org/files/ASAPI.exe download]

== Sound ==
* ALSA Project [http://www.alsa-project.org/ official website]
* kX Project [http://kxproject.lugosoft.com/ official website]
* ZonaISIS [http://www.hispasonic.com/zonaisis/index.htm unofficial]
* I have a dream ... [http://members.aol.com/cridi/ unofficial]

=Links=

* [http://www.reactos.org/wiki/index.php/Untested_%28open_source%29_software_list Open source softwares @ ReactOS wiki]
* [http://www.rarewares.org/ RareWares]

Other hardware

2006-07-05T05:49:47Z

Reglib: /* Headphones */ more stubbage

{{stub}}

== Bluetooth (A2DP) ==
Advanced Audio Distribution Profile (A2DP)
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=32634 forums]
*[http://en.wikipedia.org/wiki/A2DP#Bluetooth_profiles wikipedia]

Supports the codecs: Sub Band Codec (SBC)

Optionally supports: MPEG-1,2 Audio, MPEG-2,4 AAC and ATRAC,

With the bitrate limited by the bluetooth link

=== Sub Band Codec ===
* Sampling Frequency - 16000, 32000, 44100, 48000 (some are optional, see references)
* Channel Mode - mono, dual channel, stereo, joint stereo

The bitrate used for CD quality audio is 229 kbps and 328 kbps for middle and high quality, respectively.

Reference: [https://www.bluetooth.org/foundry/adopters/document/A2DP_Spec_V1_0/en/ BLUETOOTH Advanced Audio Distribution Profile 1.0]

== Headphones ==
Some Styles (smallest to largest)
* In the ear - outputs directly into the ear canal
* Earbuds - sits in the outer ear
* Supra-aural - sits on the ear
* circumaural - completely cover the ear

Terminology used for comparing headphones
* Noise Cancelling
** active
** passive

* Frequency response - The range of frequencies the headphones can reproduce

* Impedance - Doesn't mean much by itself, but in general, impedence should be matched across a system.

* SPL@1kHz, 1V rms - [http://en.wikipedia.org/wiki/Sound_pressure_level#SPL_in_audio_equipment Sound Pressure Level]. How efficient the unit converts electrical energy to sound energy.

* Neodymium - The magnet of choice for high end headphones.
Popular Headphones
* Sub $30
* Sub $100
* $100 - $300
* $300+

Other hardware

2006-07-04T17:27:00Z

Reglib: /* Headphones */ SPL definiton more accurate

{{stub}}

== Bluetooth (A2DP) ==
Advanced Audio Distribution Profile (A2DP)
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=32634 forums]
*[http://en.wikipedia.org/wiki/A2DP#Bluetooth_profiles wikipedia]

Supports the codecs: Sub Band Codec (SBC)

Optionally supports: MPEG-1,2 Audio, MPEG-2,4 AAC and ATRAC,

With the bitrate limited by the bluetooth link

=== Sub Band Codec ===
* Sampling Frequency - 16000, 32000, 44100, 48000 (some are optional, see references)
* Channel Mode - mono, dual channel, stereo, joint stereo

The bitrate used for CD quality audio is 229 kbps and 328 kbps for middle and high quality, respectively.

Reference: [https://www.bluetooth.org/foundry/adopters/document/A2DP_Spec_V1_0/en/ BLUETOOTH Advanced Audio Distribution Profile 1.0]

== Headphones ==
Terminology used for comparing headphones

* Frequency response - The range of frequencies the headphones can reproduce

* Impedance - Doesn't mean much by itself, but in general, impedence should be matched across a system.

* SPL@1kHz, 1V rms - [http://en.wikipedia.org/wiki/Sound_pressure_level#SPL_in_audio_equipment Sound Pressure Level]. How efficient the unit converts electrical energy to sound energy.

* Neodymium - The magnet of choice for high end headphones.

Other hardware

2006-07-04T17:14:13Z

Reglib: Headphones, A2DP

{{stub}}

== Bluetooth (A2DP) ==
Advanced Audio Distribution Profile (A2DP)
*[http://www.hydrogenaudio.org/forums/index.php?showtopic=32634 forums]
*[http://en.wikipedia.org/wiki/A2DP#Bluetooth_profiles wikipedia]

Supports the codecs: Sub Band Codec (SBC)

Optionally supports: MPEG-1,2 Audio, MPEG-2,4 AAC and ATRAC,

With the bitrate limited by the bluetooth link

=== Sub Band Codec ===
* Sampling Frequency - 16000, 32000, 44100, 48000 (some are optional, see references)
* Channel Mode - mono, dual channel, stereo, joint stereo

The bitrate used for CD quality audio is 229 kbps and 328 kbps for middle and high quality, respectively.

Reference: [https://www.bluetooth.org/foundry/adopters/document/A2DP_Spec_V1_0/en/ BLUETOOTH Advanced Audio Distribution Profile 1.0]

== Headphones ==
Terminology used for comparing headphones

* Frequency response - The range of frequencies the headphones can reproduce

* Impedance - Doesn't mean much by itself, but in general, impedence should be matched across a system.

* SPL@1kHz, 1V rms - How "loud" the unit is at 1 volt input (rms not peak-to-peak).

* Neodymium - The magnet of choice for high end headphones.

Foobar2000:Components

2006-07-01T15:23:20Z

Reglib: /* Columns UI */ foo_uie_tabs

=Components for Foobar2000 v0.9.x=
This page contains most Foobar2000 v0.9.x components available at time of last update. Descriptions where available. More information on these plugins can be found by searching the [http://www.hydrogenaudio.org/forums/index.php?showforum=28 foobar2000 forums].

Much of the information here came from [http://www.hydrogenaudio.org/forums/index.php?showtopic=42730&st=0 this thread] which may be more up to date, and also shows a list of components not yet updated from earlier versions of foobar2000.

==Columns UI==
[http://music.morbo.org/components.php Columns UI] is a very popular alternate interface for foobar2000 based on a columns and panel layout. It has a separated wiki that is located [http://music.morbo.org/wiki/columns_ui:columns_ui here].

Columns UI has its own plugin system and these plugins extend the user interface:
* [http://cherans.bol.ucla.edu/fooplugins.html Album Art Panel (foo_uie_albumart)] ([[Foobar2000:0.9 Album Art Panel (foo_uie_albumart)|''more info'']]) Panel to display album art.
* [http://tmp.reharmonize.net/foobar/ Album Art Panel for matroska (foo_uie_albumart_mka)] Albumart mod to read matroska covers.
* [http://music.morbo.org/components.php Album List Panel (foo_uie_albumlist)] Displays the database in a treeview using customizable sorting methods (by genre, artist, directory, etc.)
* [http://ku.myftp.org/goods/ Explorer Panel (foo_uie_explorer)] Displays a treeview of selected disks/folders.
* [http://foobar.s53.xrea.com/up/ Lyrics Panel (foo_uie_lyrics_panel)] Display lyrics stored in file tags.
* [http://wiki.bowron.us/index.php/Foobar2000 Music Browser (foo_browser)] Panels for Browsing Library, Similar to iTunes.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44703 Playlist Dropdown (foo_uie_playlists_dropdown)] Displays the playlist in a dropdown menu.
* [http://wiki.bowron.us/index.php/Foobar2000#foo_playlist_tree Playlist Tree (foo_playlist_tree)] Tree based media library with many available customizations.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44865 ProjectM Visualisation Panel (foo_uie_vis_projectM)] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44012 Quicksearch Panel (foo_uie_quicksearch)] Search toolbar that sends results to a playlist.
* [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=46106&view=findpost&p=407833 Tabs(foo_uie_tabs)] Tabs allows you to break Pauli's Exclusion principle by placing multiple panels in the same position at the same time.
* [http://stephan.kochen.nl/proj/foobar2000.html Track Info Panel (foo_uie_trackinfo)] ([[Foobar2000:0.9 Track Info Panel (foo_uie_trackinfo)|''more info'']]) Uses TAGZ to display information about a selected track.

==DSP==
* [http://www.andrewlabs.com/downloads/downloads.php ATSurround Processor (foo_dsp_atsurround)] ([[Foobar2000:0.9 ATSurround Processor (foo_dsp_atsurround)|''more info'']]) Reproduces surround sound information present in many stereo audio material and more.
* [http://bs2b.sourceforge.net/ BS2D (foo_dsp_bs2p)] ([[Foobar2000:0.9 BS2D (foo_dsp_bs2p)|''more info'']]) Improves headphone listening of regular hi-fi stereo records.
* [http://www.skipyrich.com/foobar/foo_channel_mixer.ptml Channel Mixer (foo_channel_mixer)] ([[Foobar2000:0.9 Channel Mixer (foo_channel_mixer)|''more info'']]) Up/down mix to/from 1-6 channels
* [http://stephan.kochen.nl/proj/foobar2000.html#continuator Continuator (foo_dsp_continuator)] ([[Foobar2000:0.9 Continuator (foo_dsp_continuator)|''more info'']]) Allows for advanced crossfading between tracks
* [http://www.foobar2000.org/components/index.html Convolve (foo_convolve)] ([[Foobar2000:0.9 Convolve (foo_convolve)|''more info'']]) Takes impulse response and does a fast convolution of the sound data with that impulse response.
* [http://www.naivesoftware.com/software.html Crossfeed (foo_dsp_crossfeed)] Filters the music to help reduce fatigue caused by listening to music with headphones
* [http://pelit.koillismaa.fi/plugins/dsp.php#132 Dolby Headphone Wrapper (foo_dsp_dolbyhp)] ([[Foobar2000:0.9 Dolby Headphone Wrapper (foo_dsp_dolbyhp)|''more info'']]) Dolby Headphone engine DLL.
* [http://www.stud.uni-karlsruhe.de/~uybc/foo_dsp_delta.zip LPCM <--> Delta-PCM Converter (foo_dsp_delta)] Noise sharpening filter
* [http://www.oss3d.com/index.html OSS/3D (foo_dsp_oss3ddsp)] Audio enhancement (SHAREWARE)
* [http://www.acc.umu.se/~zao/foobar2000/#foo_dsp_silence Post-track Silence (foo_dsp_silence)] Inserts a configurable amount of silence after each track to help external devices like MiniDisc players to sync track changes.
* [http://otachan.com/foo_dsp_ssrc.html SSRC (foo_dsp_ssrc)] ([[Foobar2000:0.9 SSRC (foo_dsp_ssrc)|''more info'']]) Sample rate converter.
* [http://www.skipyrich.com/foobar/foo_dsp_tube.ptml Tube Sound (foo_dsp_tube)] ([[Foobar2000:0.9 Tube Sound (foo_dsp_tube)|''more info'']]) Emulate tube sound.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=22057&view=findpost&p=374256 VLevel (foo_dsp_vlevel)] ([[Foobar2000:0.9 VLevel (foo_dsp_vlevel)|''more info'']]) Dynamic compressor which amplifies the quiet parts of music.
* [http://xover.sourceforge.net/ XOver (foo_dsp_xover)] ([[Foobar2000:0.9 XOver (foo_dsp_xover)|''more info'']]) Implements this digital crossover to achieve active multi-amplification.

==Input==
===Audio===
* [http://kode54.foobar2000.org/ AC3 Decoder (foo_ac3)] Decodes Dolby Digital lossy audio compression technologies format ([[AC3]]).
* [http://dl.matroska.org/downloads/foobar2000/ AC3 Packet Decoder (foo_packet_decoder_ac3)] Needed for [[AC3]] in [[Matroska]].
* [http://www.foobar2000.com/components/index.html ALAC Decoder (foo_input_alac)] Apple Lossless ([[ALAC]]) decoder (has known stability issues: random crashes during decoding).
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44963 DTS Decoder (foo_dts)] Decodes Digital Theater Systems ([[DTS]]) audio format.
* [http://tmp.reharmonize.net/foobar/ Matroska Plugin (unofficial) (foo_input_matroska)] Decodes [[Matroska]] audio container format.
* [http://kode54.foobar2000.org/ MIDI Synthesizer Host (foo_midi)]
* [http://www.foobar2000.com/components/index.html Monkey's Audio Decoder (foo_input_monkey)] Decodes Monkey's Audio ([[APE]]) audio format (this component has known unresolved stability issues with 0.9)
* [http://www.losslessaudio.org/ OptimFROG Lossless Audio Decoder (foo_input_ofr)] Decodes both the Lossless ([[OptimFROG|OFR]]) and DualStream (OFS) audio format.
* [http://foosion.foobar2000.org/0.9/ Shorten Decoder (foo_input_shorten)] Decodes Shorten ([[SHN]]) audio format.
* [http://tmp.reharmonize.net/foobar/ TTA Audio Decoder (unofficial) (foo_input_tta)] Decodes True Audio ([[TTA]]) audio format.

===Game Sound===
* [http://kode54.foobar2000.org/ ADPCM Decoder (foo_adpcm)] Plays GameCube ADPCM audio data and some. (DSP, ADP, GCM, HPS, STM, AST, etc.)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43766 Another Slight Atari Player (foo_asap)] [http://asap.sourceforge.net/ ASAP] is a player/converter of Atari 8-bit music for modern computers. It provides high-quality, identical to the popular Atari800 emulator, emulation of the POKEY sound chip and the 6502 processor.
* [http://kode54.foobar2000.org/ DUMB Module Decoder (foo_dumb)] Plays your favorite module files, and then some. (MOD, S3M, XM, IT, 669, PTM, PSM, MTM, UMX)
* [http://shexec32.serveftp.net/products.aspx?id=foo_game Game Audio Decoder (foo_game)] Plays Westwood's audio (AUD), Sierra's sounds (SFX/AUD), Core design's cd audio (cdaudio.WAD), Funcom's music (ISS), Rome Total War's IDX (.IDX/DAT), Timegate's format (RWD), EA's Pathfinder audio (MUS) and Ben Gerard's music (SC68).
* [http://kode54.foobar2000.org/ Game Emu Player (foo_gep)] Plays several emulation formats. (GBS, NSF, SPC, GYM, HES, VGM)
* [http://kode54.foobar2000.org/ Lunar 2 PCM Decoder (foo_lunar2)] Plays audio files found on the original Lunar: Eternal Blue CD (RP*.PCM).
* [http://shexec32.serveftp.net/products.aspx?id=foo_m1 M1 Decoder (foo_m1)] ([[Foobar2000:0.9 M1 (foo_m1)|More info]]) Plays arcade/pinball game sound.
* [http://kode54.foobar2000.org/ PSF Decoder (foo_psf)] Plays PlayStation Sound Format (PSF) files.
* [http://kode54.foobar2000.org/ SID Player 2 (foo_sid)] Sound chip of Commodore's CBM-II, Commodore 64 and Commodore 128 home computers.

==Output==
* [http://www.foobar2000.com/components/index.html ASIO Output (foo_out_asio)] Adds ASIO output support.
* [http://www.foobar2000.com/components/index.html Kernel Streaming Output (foo_out_ks)] Allows bit-exact playback bypassing Windows kernel mixer.

==Visualisation==
* [http://stephan.kochen.nl/proj/foobar2000.html#projectM ProjectM Visualisation (foo_vis_projectM)] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.

==Other==
===Library tools===
* [http://www.foobar2000.com/components/index.html Audio CD Writer (foo_burninate)] CD burning support (requires Nero to be installed on your system.)
* [http://www.foobar2000.com/components/index.html Autoplaylist Manager (foo_autoplaylist)] Presents a Media Library query in a dynamically-generated playlist (under development).
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44656 Bin Pack (foo_binpack)] Creates playlists from a list with a maximum length.
* [http://tmp.reharmonize.net/foobar/ Cuesheet Creator (foo_cuesheet_creator)] Cuesheet creator.
* [http://wiki.bowron.us/index.php/Foobar2000#foo_cwb_hooks Cwbowron's Title formating (foo_cwb_hooks)] ([[Foobar2000:0.9 CwBowron's Title formating (foo_cwb_hooks)|''more info'']]) Special playlist title formating.
* [http://foosion.foobar2000.org/0.9/ Database Search (foo_dbsearch)] ([[Foobar2000:0.9 Database Search (foo_dbsearch)|''more info'']]) Database search.
* [http://foosion.foobar2000.org/0.9/ Freedb Tagger (foo_freedb2)] Freedb tagger.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43012 History (foo_history)] Very basic song history.
* [http://foosion.foobar2000.org/0.9/ Live Show Tagger (foo_tradersfriend)] ([[Foobar2000:0.9 Live Show Tagger (foo_tradersfriend)|''more info'']]) Live show tagger.
* [http://eludevisibility.org/music/ MeowDB (foo_meowdb)] ([[Foobar2000:0.9 MeowDB (foo_meowdb)|''more info'']]) Takes the Media Library and outputs the results to a form and uploads it to your server using the cURL library.
* [http://foosion.foobar2000.org/0.9/ Metadata Cache Statistics (foo_metadbstats)] Provides statistics about memory allocation size of playlist and media library tags.
* [http://www.foobar2000.com/components/index.html Play Count (official) (foo_playcount)] ([[Foobar2000:0.9 Play Count (official) (foo_playcount)|''more info'']]) Collects statistics about tracks from your Media Library being played.
* [http://stephan.kochen.nl/proj/foobar2000.html#playcount Play Count (foo_playcount)] ([[Foobar2000:0.9 Play Count (foo_playcount)|''more info'']]) Keeps track of the amount of times, the last time, and the first time a track has been played.
* [http://foosion.foobar2000.org/0.9/ Playback Queue Viewer (foo_pqview)] Playback queue viewer.
* [http://www.skipyrich.com/foobar/foo_playlist_bind.ptml Playlist Bind (foo_playlist_bind)] Synchronize playlist with contents of specific directory.
* [http://otachan.com/foo_playlistclear.html Playlist Clear (foo_playlistclear)] All playlists are cleared at startup.
* [http://foosion.foobar2000.org/0.9/ Playlist Manager (foo_playlist_manager)] Playlist manager.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43522 Playlist Name Enhenced (foo_playlist_name_enhanced)] ([[Foobar2000:0.9 Playlist Name Enhenced (foo_playlist_name_enhanced)|''more info'']]) Appends automatically playlist info ("items / length") to all playlist names.
* [http://foosion.foobar2000.org/0.9/ Playlist Tools (foo_utils)] ([[Foobar2000:0.9 Playlist Tools (foo_utils)|''more info'']]) Provides various general commands.
* [http://foosion.foobar2000.org/0.9/ Randomized Playlist Entry (foo_random)] Randomized playlist entry.
* [http://gro.clinux.org/frs/?group_id=737&release_id=1095 Special File Info Box (foo_infobox)] ([[Foobar2000:0.9 Special File Info Box (foo_infobox)|''more info'']]) A replacement of the built-in file info box.

===Lyrics===
* [http://gasazip.com/bbs/download.php?bo_table=down&wr_id=62&no=2 Gasazip Lyrics (foo_gasazip)] Search for lyrics and displays it in external window.
* [http://lyrics.mirkforce.net/ LyricsDB (foo_lyricsdb)] ([[Foobar2000:0.9 LyricsDB (foo_lyricsdb)|''more info'']]) Search lyrics basing on song's artist title and sometimes album.
* [http://www.crintsoft.com/minilyrics.htm Mini Lyrics (foo_ui_minilyrics)] ([[Foobar2000:0.9 Mini Lyrics (foo_ui_minilyrics)|''more info'']]) Lyrics viewer for synchronizing and displaying lyrics of the currently playing song.

===Notifier===
* [http://pelit.koillismaa.fi/plugins/general.php#40 AMIP Wrapper (foo_amipwrapper)] Complete now-playing plug-in for mIRC, PIRCH, Klient, Bersirc, other IRC and Mail clients, supporting full player control from mIRC, playlist search, clipboard integration, HTTP, dynamic image signatures, etc.
* [http://stephan.kochen.nl/proj/foobar2000.html#msn MSN Now Playing (alt) (foo_msnalt)] ([[Foobar2000:0.9 MSN Now Playing (alt) (foo_msnalt)|''more info'']]) Show the current song as "Now Playing" in MSN and MS Live messenger.
* [http://kode54.foobar2000.org/ On-Screen Display (foo_osd)] ([[Foobar2000:0.9 On-Screen Display (foo_osd)|''more info'']]) On screen display of track information and volume bar.
* [http://kode54.foobar2000.org/ On-Screen Display GDI+ (foo_osd_gdiplus)] ([[Foobar2000:0.9 On-Screen Display (foo_osd)|''more info'']]) Same as foo_osd but uses GDI+ for osd drawing.
* [http://www.maroonspoon.com/foo_prettypop/ Pretty Popup (foo_prettypop)] ([[Foobar2000:0.9 Pretty Popup (foo_prettypop)|''more info'']]) Display a moderately sized popup of song information when a new song plays.

===Online database===
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44320&st=0 Audioscrobbler (foo_audioscrobbler)] Audioscrobbler will send the name of every song you play on your computer to Last.fm. This effortlessly populates your profile to play radio you like and make personalized recommendations.
* [http://foosion.foobar2000.org/0.9/ Foosic Music Database (foo_sic)] Sends track information to the [http://www.foosic.org/ foosic online database]. You can currently view your top artist, album and track statistics with foosic. Now support FooID fingerprints.

===Online radio===
* [http://www.maroonspoon.com/foo_xm/ XM Radio Online Player (foo_xm)] Allow you to listen to XM Radio channels over the Internet by using XM Radio Online.

===Remote control===
* [http://pelit.koillismaa.fi/plugins/general.php#138 Advanced Controls (foo_advancedcontrols)] ([[Foobar2000:0.9 Advanced Controls (foo_advancedcontrols)|''more info'']]) Control all the playback functions from icons in the Taskbar Notification Area (play, pause, next, previous, open)
* [http://foosion.foobar2000.org/0.9/ COM Automation Server (foo_comserver)] Allows controlling foobar2000 through COM Automation
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=38114 Control Server (foo_controlserver)] Acts as a server to control Foobar2000. Connect with a telnet client and control it using ASCII commands.
* [http://otachan.com/foo_ddecontrol.html DDE Control (foo_ddecontrol)] Control foobar remotelly with DDE interprocess communication (interface in japanese only).
* [http://foobar.daychanged.com/ HTTP Writer (foo_write_http)] It's TCP/IP server that listens on a specified port for incoming requests such as play, stop, etc.
* [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=19252&view=findpost&p=391028 WinLIRC Client (foo_lirc)] ([[Foobar2000:0.9 WinLIRC Client (foo_lirc)|''more info'']]) Control Foobar from a remote control.

===Misc===
* [http://www.foobar2000.com/components/index.html Binary Comparator (foo_bitcompare)] Performs binary comparison between two or more tracks and reports differences.
* [http://foosion.foobar2000.org/0.9/#channelusage Channel Usage Visualisation (foo_vis_channelusage)] Channel Usage Visualisation.
* [http://foosion.foobar2000.org/0.9/ Common Services (foo_common)] Common services.
* [http://www.foobar2000.com/components/index.html Decoding Speed Test (foo_benchmark)] ([[Foobar2000:0.9 Decoding Speed Test (foo_benchmark)|''more info'']]) Measures decoding speed of audio files.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=37204 Fullscreen (foo_fullscreen)] Enable fullscreen mode.
* [http://kode54.foobar2000.org/ Pause On Lock (foo_lock)] Pauses/unpauses foobar2000 on workstation lock/unlock.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42736&hl=foo_sendtodevice Send To Device (foo_sendtodevice)] Add "Send to Device" feature.
* [http://foosion.foobar2000.org/0.9/ Shell Link Resolver (foo_lnk)] Shell link resolver.
* [http://stephan.kochen.nl/proj/foobar2000.html#notaskbar Taskbar Remover (foo_notaskbar)] Hides Foobar2000 from the taskbar, even when the window is normally visible.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42941 Winamp API Emulator (foo_winamp_spam)] Designed to create a fake Winamp 1.x window which will act as a wrapper between applications written to use the Winamp API and foobar2000.

=Links=
* [http://www.foobar2000.org/components/index.html Official components site]
* [http://pelit.koillismaa.fi/plugins/ Official third-party components site]
* [http://music.morbo.org/components.php musicmusic's components] including Columns UI
* [http://stephan.kochen.nl/proj/foobar2000.html Several popular components ported to 0.9]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=21105 Most Sought-After Plugins] (forum thread, foobar v0.8.3 only)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI thread]: first post contains links to many Columns UI panel extensions

[[Category: foobar2000]]

Foobar2000 Talk:Title Formatting Reference

2006-06-21T01:04:23Z

Reglib: synced to the main page

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %codec%
| Defined as ''$codec()''.
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifequal(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is equal to ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th (0,1,2 and so on) tag called ''name''.

Example: ''$meta(artist,1)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Other information ===
This is an expansion of names for $info(name). Check the "Other info" box of '''Properties...''' for the exact same information. Don't expect all of these to work for every track
{| border=1 cellspacing=0 cellpadding=3
! ''name'' !! What ''$info(name)'' or ''%__name%'' returns !! CODEC
|-
| bitrate || Returns the bitrate of the track. Eg: 271 || ''all''
|-
| bitrate_nominal || 192 || Vorbis
|-
| bitspersample || Eg: 16 || FLAC
|-
| codec || Returns the codec. Eg: Monkey's Audio, MP3, FLAC || ''all''
|-
| codec_profile || Possible Values: Normal,Fast || APE
|-
| enc_delay || Has to do with accurate length. Eg: 576 || MP3
|-
| enc_padding || Has to do with accurate length. Eg: 1536 || MP3
|-
| encoding || Possible values: lossy or lossless || ''all''
|-
| extrainfo
| Possible values: VBR
// CBR,VBR detection
$if2($info(extrainfo),CBR)
| MP3
|-
| channels || Possible values: 1, 2 || ''all''
|-
| cue_embedded || Returns '''yes''' or '''no''' || APE, FLAC
|-
| flags || Eg: 0 or 22 || APE
|-
| samplerate || 44100 || ''all''
|-
| MD5 || Contains an MD5 hash || APE
|-
| mp3_accurate_length || Returns yes or no || MP3
|-
| mp3_stereo_mode || stereo, joint stereo || MP3
|-
| tagtype || Returns a <nowiki>"|" delimited list of tags on the track. Eg: id3v2|id3v1|apev2</nowiki> || APE, MP3
|-
| tool || the encoder used to create the file. Eg: reference libFLAC 1.1.0 20030126 || FLAC, Vorbis
|-
| version || similar to '''tool''', the version of Monkey's Audio that encoded || APE
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000:ID3 Tag Mapping

2006-06-13T15:30:24Z

Reglib: fuuuuuusssssssed sentence fragments - ha!

This page lists all ID3v2.4 tag frames natively supported by foobar2000 as of version 0.9.0. The 'Field Name' column indicates the name to be used in the foobar2000 'Properties' or 'Masstagger' window. The 'ID3v2.4 Frame' column indicates in which ID3v2.4 frame the value will be stored.

Note that foobar2000 0.9 does not ''write'' ID3v2.3 tags; the ID3v2.3 Frame column indicates how foobar2000 ''reads'' this version of the standard.

{| class="wikitable"
|+Native ID3 Frames
|-
! Field Name1 !! ID3v2.3 Frame !! ID3v2.4 Frame !! Description !! Comments
|-
| ALBUM || TALB || TALB || Album/Movie/Show title ||
|-
| ARTIST || TPE1 || TPE1 || Lead performer(s)/Soloist(s) ||
|-
| ARTIST WEBPAGE URL || WOAR || WOAR || Official artist/performer webpage ||
|-
| BAND || TPE2 || TPE2 || Band/orchestra/accompaniment ||
|-
| BPM || TBPM || TBPM || BPM (beats per minute) ||
|-
| COMMENT || COMM || COMM || Comments ||
|-
| COMMERCIAL INFORMATION URL || WCOM || WCOM || Commercial information ||
|-
| COMPOSER || TCOM || TCOM || Composer ||
|-
| CONDUCTOR || TPE3 || TPE3 || Conductor/performer refinement ||
|-
| CONTENT GROUP || TIT1 || TIT1 || Content group description ||
|-
| COPYRIGHT || TCOP || TCOP || Copyright message ||
|-
| DATE || || TDRC || Recording time || The TDRC frame is officially to be used for the ''recording time'', TDRL is for the ''release time'' but TDRC is generally used by most programs.
|-
| DATE || TYER || || Year ||
|-
| DISCNUMBER || TPOS || TPOS || Part of a set ||
|-
| ENCODED BY || TENC || TENC || Encoded by ||
|-
| ENCODING SETTINGS || TSSE || TSSE || Software/Hardware and settings used for encoding ||
|-
| FILE WEBPAGE URL || WOAF || WOAF || Official audio file webpage ||
|-
| GENRE || TCON || TCON || Content type ||
|-
| INTERNET RADIO WEBPAGE URL || WORS || WORS || Official Internet radio station homepage ||
|-
| ISRC || TSRC || TSRC || ISRC (international standard recording code) ||
|-
| ORIGINAL ALBUM || TOAL || TOAL || Original album/movie/show title ||
|-
| ORIGINAL ARTIST || TOPE || TOPE || Original artist(s)/performer(s) ||
|-
| ORIGINAL RELEASE DATE || || TDOR || Original release time ||
|-
| ORIGINAL RELEASE DATE || TORY || || Original release year ||
|-
| OWNER || TOWN || TOWN || File owner/licensee ||
|-
| PAYMEMT URL || WPAY || WPAY || Payment ||
|-
| PUBLISHER || TPUB || TPUB || Publisher ||
|-
| PUBLISHER URL || WPUB || WPUB || Publishers official webpage ||
|-
| RADIO STATION || TRSN || TRSN || Internet radio station name ||
|-
| REMIXED BY || TPE4 || TPE4 || Interpreted, remixed, or otherwise modified by ||
|-
| SOURCE WEBPAGE URL || WOAS || WOAS || Official audio source webpage ||
|-
| SUBTITLE || TIT3 || TIT3 || Subtitle/Description refinement ||
|-
| TITLE || TIT2 || TIT2 || Title/songname/content description ||
|-
| TRACKNUMBER || TRCK || TRCK || Track number/Position in set ||
|-
| TOTALDISCS || TPOS || TPOS || Part of a set || Stored in the same frame with DISCNUMBER, separated by '/': e.g. '1/2'. Stored in TXXX if DISCNUMBER does not exist.
|-
| TOTALTRACKS || TRCK || TRCK || Total tracks || Stored in the same frame with TRACKNUMBER, separated by '/': e.g. '4/9'. Stored in TXXX if TRACKNUMBER doesn't exist.
|-
| UNSYNCED LYRICS || USLT || USLT || Unsynchronised lyric/text transcription ||
|-
| WRITER || TEXT || TEXT || Lyricist/Text writer ||
|}

:Notes:
:# All non-native supported field names will be stored in the TXXX (User defined text information) frame except for field names starting with "WWW" which will be stored in WXXX (User defined URL link frame) frames.

=References=
* [http://www.id3.org/id3v2.4.0-frames.txt ID3v2.4.0 Native Frames]
* [http://www.id3.org/id3v2.3.0.txt ID3v2.3.0 Informal standard]

Talk:Download page

2006-06-06T22:36:10Z

Reglib: /* pretty tables */

== pretty tables ==
Looking at the recent changes here, it would be nice to be able to get into the style.css for the wiki to make it easier to make pretty tables.
--[[User:Reglib|Reglib]] 04:57, 1 June 2006 (CDT)

I'm not sure but I think you can do that at [[MediaWiki:Monobook.css]].

[[User:Jan|Jan]] 05:20, 1 June 2006 (CDT)

Currently all the CSS pages are protected. Templates are another option, but being really lazy, CSS can be simpler if you put in the initial work. I'll try template-only formatting for a few weeks, and if I think CSS is needed I'll come a hollerin'

some links for me to look at later: [http://en.wikipedia.org/wiki/Template_talk:Prettytable] [http://meta.wikimedia.org/wiki/Help:Tables#Style_templates]
[[MediaWiki:Common.css]]

--[[User:Reglib|Reglib]] 11:54, 1 June 2006 (CDT)

Templates are an excellent choice. I think for the timg being though, it would just be easier to add CSS2 tags instead. Templates would keep things more organized, despite the fact though.

--[[User:HotshotGG|HotshotGG]] 20:40, 1 June 2006 (CDT)

'''HotshotGG''', please keep the outer border ala the tables in [[Recommended Ogg Vorbis]]. Outer borders prevent table runins making them currently rather confusing and all mixed-up IMO.
Also... next time you make extensive editing, why not edit the whole page at once instead of section by section (1) I got a headache looking at the history :P (2) Jan still has not put spacing before section/subsection heads so the sections all run together :(

--[[User:Pepoluan|pepoluan]] 13:59, 5 June 2006 (CDT)

Disregard my previous comments. The dotted lines look ugly. I changed to 2px solid line. But the color looks... um, unappetizing now. Edit all page, and replace every occurence of #ffdead with something better (using notepad or similar).

A thought: Should we maintain same coloring for all page, or vary it like in the [[Listening Tests]] page?

--[[User:Pepoluan|pepoluan]] 15:14, 5 June 2006 (CDT)

Some bureaucracy before some real work... what nomenclature should we use for table formatting templates? It must be short, because they'll be used frequently, but still descriptive. Template:<prefix><family>[-variant] so... stuff like Template:TFpretty, Template:TFpretty-head

--[[User:Reglib|Reglib]] 17:36, 6 June 2006 (CDT)

== merge the linux download page? ==

Now that the Download Page is detailed into Windows and Mac OS/X parts (and also PocketPC part), do you think we ought to merge the Download Page for Linux here? --[[User:Pepoluan|pepoluan]] 16:29, 6 June 2006 (CDT)

Yes I think so.
[[User:Jan|Jan]] 16:58, 6 June 2006 (CDT)

User:Reglib

2006-06-05T09:12:10Z

Reglib: /* Foobar2000 Wishlist */ foo_uie_quicksearch

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

That's based on the Navigator fcs for Columns UI. some changes I've made are:
* updating the general layout
* uses official playback component
* condensed play count/time column
* dimmed zero-padding
* entries with missing metadata are hilighted

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Foobar2000 Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* Less obtrusive warning window
* infinite loop detection/termination
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.
* WinAMP style media library search [update] foo_uie_quicksearch is good stuff!
* one-click genre assigner (it's possible now, i'm just too busy to do it). should maintain a list of recent and popular genres, and display in dynamically generated cloud.

Talk:Download page

2006-06-01T16:54:44Z

Reglib: css vs templates

User:Reglib

2006-06-01T10:01:47Z

Reglib: /* Wishlist */ further dreaming

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

That's based on the Navigator fcs for Columns UI. some changes I've made are:
* updating the general layout
* uses official playback component
* condensed play count/time column
* dimmed zero-padding
* entries with missing metadata are hilighted

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Foobar2000 Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* Less obtrusive warning window
* infinite loop detection/termination
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.
* WinAMP style media library search [update] there's a new panel component that's close
* one-click genre assigner (it's possible now, i'm just too busy to do it). should maintain a list of recent and popular genres, and display in dynamically generated cloud.

Talk:Download page

2006-06-01T09:57:18Z

Reglib: observation on the recent edits

Choosing the best codec

2006-05-29T07:38:40Z

Reglib: /* Why no simple answer? */ "to be" usage

A common question is "which format is best for me?", or "which should I use, this or that?". While these are important decisions we have all had to make at some point, there is usually no simple answer that can be given to new users.

==Why no simple answer?==

There are several factors that you must first consider, my needs aren't the same as yours, maybe we want to do different things with our music, or we have a different amount of disk space to use.

Common considerations are:
* Do you want the option of using a portable player now?
* Would no playback support other than on your PC be a problem in the future?
* Do you need to use a popular format?
* How much space do you want to use for you music?
* How much music do you want to store?
* Are you simply interested in quality?
* ''How good is your hearing''?

The last question is '''the''' most important. Why? I have poor hearing, so something that sounds good to me could well be annoying to you. Only you have your ears, so only you know what sounds good to you.

We can however make general recommendations based on test results from the entire community - for example:

; [[Lossy]] formats:
* [[MP3]] has the most widespread acceptance among the general population and in hardware players
* [[MPC]] was considered in the past as the best format for high bitrates (> 175kb/s)
* [[Ogg Vorbis]] and [[AAC]] HE are thought to perform better than others at low bitrates (< 128kb/s)
* There are other lossy formats at the [[lossy|lossy page]].

; [[Lossless]] formats:
Lossless compression is the ''only'' way to retain all the original quality and lose no information.
* [[FLAC]] is considered the most widely supported format
* [[LA]] and [[OptimFrog]] is considered to be the tightest compressors
* [[WavPack]] and OptimFrog support hybrid modes, i.e. combination of lossy (for smaller files, albeit not as small as lossy formats) and lossless.
* For a list of lossless formats and their pro's and con's see the [[lossless|lossless page]].

==How can I choose for myself?==

* Listen and see, use [[ABX]]. Be aware that your tolerance can change if you train your ability to hear [[artifact]]s.
* Read the pages for the different formats and see their pro's and con's.

Talk:Other hardware

2006-05-26T22:55:23Z

Reglib: description of page

This page has been sitting around for a long time unused. I figure it's a good place to keep stubs for future articles on the HA Knowledgebase.

Other hardware

2006-05-26T22:54:25Z

Reglib: bluetooth a2dp

User:Reglib

2006-05-26T21:26:55Z

Reglib: /* Wishlist */

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

That's based on the Navigator fcs for Columns UI. some changes I've made are:
* updating the general layout
* uses official playback component
* condensed play count/time column
* dimmed zero-padding
* entries with missing metadata are hilighted

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* Less obtrusive warning window
* infinite loop detection/termination
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.
* WinAMP style media library search
* one-click genre assigner (it's possible now, i'm just too busy to do it)

User:Reglib

2006-05-26T16:19:49Z

Reglib: /* Wishlist */

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

That's based on the Navigator fcs for Columns UI. some changes I've made are:
* updating the general layout
* uses official playback component
* condensed play count/time column
* dimmed zero-padding
* entries with missing metadata are hilighted

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* Less obtrusive warning window
* infinite loop detection/termination
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.
* WinAMP style media library search

Download page

2006-05-26T16:13:57Z

Reglib: /* Tagging Utilities */ added MP3 Book Helper

All programs mentioned anywhere in the wiki can be downloaded here.

'''Note:''' Linux downloads are [[Download page Linux|listed here]].

=CD Rippers=

{| border="1" cellpadding="1" cellspacing="1" style="text-align:center"
|- style="background:#ffdead"
! style="width:200px;" | Name
! style="width:100px;" | License
! style="width:120px;" | Download Site
|-
! align="left" | [[CDex]]
| GPL
| [http://cdexos.sourceforge.net/ here]
|-
! align="left" | [[dBpowerAMP]]
| GPL
| [http://www.dbpoweramp.com/ here]
|-
! align="left" | DeepRipper
| GPL
| [http://www.deepburner.com/ here]
|-
! align="left" | [[EAC]]
| Free
| [http://www.exactaudiocopy.de/ here]
|}

=CD Writers=

{| border="1" cellpadding="1" cellspacing="1" style="text-align:center"
|- style="background:#ffdead"
! style="width:200px;" | Name
! style="width:80px;" | Unicode
! style="width:100px;" | License
! style="width:120px;" | Download Site
|-
! align="left" | BurnAtOnce
| N
| Free
| [http://www.burnatonce.com/ here]
|-
! align="left" | Burrrn (CDA only)
| N
| Free
| [http://www.burrrn.net/ here]
|-
! align="left" | CDBurnerXP Pro
| ?
| Free
| [http://www.cdburnerxp.se/ here]
|-
! align="left" | DeepBurner Free
| N
| Free
| [http://www.deepburner.com/ here]
|-
! align="left" | DeepBurner Pro
| ?
| Shareware
| [http://www.deepburner.com/ here]
|-
! align="left" | Express Burn
| N
| Free
| [http://nch.com.au/burn/index.html here]
|-
! align="left" | Express Burn Plus
| ?
| Shareware
| [http://nch.com.au/burn/index.html here]
|-
! align="left" | FireStarter FX
| ?
| Shareware
| [http://www.projectomega.org/subcat.php?lg=en&php=products_firestarter here]
|-
! align="left" | Nero
| N
| Shareware
| [http://www.nero.com/ here]
|-
! align="left" | SilentNight Micro-CD Burner
| N
| Free
| [http://www.silentnight2004.com/Download.html here]
|-
! align="left" | Small CD Writer
| N
| Free
| [http://tinyurl.com/6xm97 here]
|}

=Multimedia Players=

===Windows Players===
{| border="1" cellpadding="1" cellspacing="1" style="text-align:center"
|- style="background:#ffdead"
! style="width:150px;" | Name
! style="width:180px;" | Price
! style="width:120px;" | Download Site
! style="width:200px;" | Notes
|-
! align="left" | [[Foobar2000]]
| Free
| [http://www.foobar2000.org/ here]
| align="left" | Very customizable & powerful
|-
! align="left" | [[MediaMonkey]]
| Free, Gold Version 19.95 USD
| [http://www.mediamonkey.com/ here]
| align="left" | Supports Winamp plugins
|-
! align="left" | MusikCube
| Free
| [http://www.musikcube.com/ here]
| align="left" |
|-
! align="left" | VUplayer
| Free
| [http://www.vuplayer.com/ here]
| align="left" | Site also provides useful plugins for various apps
|-
! align="left" | [[Winamp]]
| Free, Pro Version 19.95 USD
| [http://www.winamp.com/ here]
| align="left" |
|-
! align="left" | wxMusik
| Free
| [http://musik.berlios.de/ here]
| align="left" |
|}

===PocketPC Players===
''These players may not play all your media files. Check their websites for the format support.''
* GSPlayer: http://hp.vector.co.jp/authors/VA032810/
* MortPlayer: http://www.sto-helit.de/
* TCPMP: http://tcpmp.corecodec.org/about

=Encoders, Decoders, Etc.=

All basic tools needed to make use of the audio formats supported here.

==[[MP3]]==

* [[LAME]] encoder/decoder: [http://www.rarewares.org/mp3.html download pre-compiled binaries here]. Also check the [[Lame Compiles|Latest recommended version]] page.
* [[MP3Gain]], a replaygain-like utility: [http://mp3gain.sourceforge.net/download.php download here]

==[[Ogg Vorbis]]==

Currently, all recommended Ogg Vorbis utilities are available at the [http://www.rarewares.org/ogg.html Rarewares Ogg Vorbis page]. The following tools are important:

* OggEnc2
: A command-line Ogg Vorbis encoder that can be used with most CD rippers.

* OggDec
: Command-line decoder.

* [[OggDropXPd]]
: A (very cute-looking) drag'n'drop encoder/decoder with support for automatic tagging, renaming and playlist creation on encoding.

* Encoding DLLs
: DLLs that can be used for encoding within CDex or WinLame.

* VorbisGain
: The [[Replaygain]] utility for Ogg Vorbis.

In addition, the [[Lancer]] suite is a highly SSE-optimized utilities and libraries are available at [http://homepage3.nifty.com/blacksword/ this page] ''(in Japanese)''.

==Musepack ([[MPC]])==

* MPC Encoder (mppenc): [http://www.saunalahti.fi/~cse/mpc/encoders/mppenc-windows-1.14.zip 1.14 Beta] / [http://www.saunalahti.fi/~cse/mpc/encoders/mppenc-windows-1.15r.zip 1.15r Alpha] (Both these versions are safe to use.)

* MPC Decoder (mppdec): [http://www.saunalahti.fi/~cse/mppdec.zip Download latest version]

* [[Replaygain]] utility: [http://www.saunalahti.fi/~cse/replaygain.zip Download latest version]

==[[FLAC]]==

* CoolEdit / Adobe Audition Filter supporting FLAC: [http://www.vuplayer.com/other.php download here]
* Various FLAC-related utilities (incl. ReplayGain utility): [http://flac.sourceforge.net/download.html FLAC's SourceForge Download page]

==Transcoders==
''Note: Although these tools may convert from one encoding to another, please remember that [[transcoding]] to any [[lossy]] encoding will result in a degraded quality.''
* BeSweet: http://besweet.notrace.dk/
* dBpowerAMP Music Converter (dMC): http://www.dbpoweramp.com/dmc.htm
* MediaCoder: http://www.rarewares.org/mediacoder/
* WinLAME: http://winlame.sourceforge.net/

=Drivers =

== ASPI ==
* Ahead Nero ASPI Driver: [http://www.nero.com/nero6/eng/ASPI_Driver.html official website]
* Adaptec Windows ASPI Package: [http://www.adaptec.com/worldwide/support/suppdetail.jsp?sess=no&prodkey=ASPI-4.70 official website]
* ASPI4all [http://www.3a.net/main.php?id=20 "official" website]
* FrogAspi [http://www.frogaspi.org/ official website]
* VOB ASAPI Driver 1.3: [http://www.rarewares.org/files/ASAPI.exe download]

== Sound ==
* kX Project [http://kxproject.lugosoft.com/ official website]
* ZonaISIS [http://www.hispasonic.com/zonaisis/index.htm unofficial]
* I have a dream ... [http://members.aol.com/cridi/ unofficial]

=Tagging Utilities=

{| border="1" cellpadding="1" cellspacing="1" style="text-align:center"
|- style="background:#ffdead"
! style="width:150px;" | Name
! style="width:200px;" | Price
! style="width:110px;" | Download Site
! style="width:270px;" | Remark
|-
! align="left" | Abander TagControl
| 23 USD, 30D Trial
| [http://www.softartstudio.com/tagcontrol/ here]
|
|-
! align="left" | AudioShell
| Free
| [http://www.softpointer.com/AudioShell.htm here]
| align="left" | Integrates with Windows Explorer
|-
! align="left" | Magic MP3 Tagger
| 12.50 EUR, unlimited Trial
| [http://www.magic-tagger.com here]
| align="left" | Optimized for automatic music identification
|-
! align="left" | [[MediaMonkey]]
| Free, Gold Version 19.95 USD
| [http://www.mediamonkey.com/ here]
| align="left" | Also a Media Player & Library
|-
! align="left" | MP3 Book Helper
| Free
| [http://mp3bookhelper.sourceforge.net/ here]
| align="left" | Tags [[ID3v1]], ID3v2.3, and Vorbis comments. Features: FreeDB, unicode, guessing and matching, and supporting PAR, SFV, SV, and NFO generation.
|-
! align="left" | Mp3tag
| Free
| [http://www.mp3tag.de/ here]
| align="left" | Tags all files supporting [[ID3]], [[APEv2]], and Vorbis comments, not only MP3s
|-
! align="left" | Mp3/Tag Studio
| 19 USD, Unlimited Trial w/ Banner or Limited Trial w/o
| [http://www.magnusbrading.com/mp3ts/ here]
| align="left" | Supports ID3v1 & v2 '''only'''. Powerful matching and fancy filters
|-
! align="left" | Tag
| Free
| [http://sbooth.org/Tag/ here]
| align="left" | For Mac OS X
|-
! align="left" | [[Tag.exe]]
| Free
| [http://www.synthetic-soul.co.uk/tag/ here]
| align="left" | Command-line universal tagger for Windows
|-
! align="left" | Tag & Rename
| 29.95 USD, 30D Trial
| [http://www.softpointer.com/tr.htm here]
|
|-
! align="left" | TagScanner
| Free/Donate
| [http://xdev.narod.ru/tagscan_e.htm here]
|
|-
! align="left" | The GodFather
| Card/Donate
| [http://users.otenet.gr/~jtcliper/tgf/ here]
|
|}

=Links=

* [http://www.reactos.org/wiki/index.php/Untested_%28open_source%29_software_list Open source softwares @ ReactOS wiki]
* [http://www.rarewares.org/ RareWares]

Foobar2000:Components/Album Art Panel (foo uie albumart)

2006-05-21T09:11:48Z

Reglib: /* Link */ forum link to gfngfgf's version

[[Image:Albumartpannel.PNG|thumb]]

=Description=
Album Art Panel is a component for foobar2000 and Columns UI that displays album art in a panel. When configured, it can display any image you would like to associate with a track.

==Features==
*Configurable sources list allows cycling of multiple images for a single track
*Allows TAGZ and wildcards to specify image file location
*Minimum height setting to assist with layouts
*Configurable resizing of album art to fit panel size
*Sliding and fading transitions between album art
*Configurable actions when panel is left-clicked, double-clicked, and middle-clicked.
*Can display album art for either the currently playing track or the currently selected track

==Reading Embedded Album Art==

Album Art Panel does not support reading album art which has been embedded as a tag (for example, as an ID3v2 tag in an MP3).

=Sources List=
The sources list allows you to use [[Foobar2000:Titleformat_Reference|titleformatting scripts]] to specify exactly where Album Art Panel will look for image files. In order to learn how to use the sources list, let's look at an example:

$replace(%_path%,%_filename_ext%,)folder.jpg
-$replace(%_path%,%_filename_ext%,)*
-components\default.png
C:\Music\Arts\%artist% %album%*
-components\default.png

The sources list is organized into groups, based on which lines have a '-' in front of them. Each line that does not start with a '-' is the beginning of a new source group. A line which starts with '-' is part of the same source group as the line above it. In the example above, there are two source groups. The first source group consists of the first three lines and the second group consists of the last two lines.

The wildcard '*' can be used in place of one or any number of characters and '?' can be used in place of any single character. For instance, the second line of the example above tells Album Art Panel to look for any file it can display in the same directory as the track. Album Art Panel will display the first image which matches the pattern. Characters in tags that are not allowed in filenames will be replaced with the '?' wildcard.

''(Note: The "match:" prefix is obsolete. Since version 0.160, the "match:" prefix is ignored, and "-match:" is treated like "-". The wildcards '*' and '?' can be used in any source string.)''

The "Next Source" action (by default, left-clicking on the panel) will cycle forward through the source groups. Similarily, the "Previous Source" action will cycle backwards through the source groups.

Album Art Panel will first look for an image at the location indicated in the first line of a source group. If the image indicated by the first line cannot be found, Album Art Panel will look at subsequent lines within the same source group and display the first image which can be found. If no image within a source group can be found, Album Art Panel will try to display the next source group instead. If none of the source groups can be found, the display will be blank.

=Link=
* [http://cherans.bol.ucla.edu/fooplugins.html Website and Download]
* [http://eolindel.free.fr/foobar0.9/albumart.shtml Unofficial User Manual]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=39924 Discussion Thread] [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=39924&view=findpost&p=387294 (Current version)] [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=39924&view=findpost&p=394387 (Even newer current version)]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=34341 No-Cover Image Thread]

[[Category: Columns UI]]

Foobar2000 Talk:Title Formatting Reference

2006-05-20T20:28:09Z

Reglib: /* Other information */ minor additions

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %codec%
| Defined as ''$codec()''.
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Other information ===
This is an expansion of names for $info(name). Check the "Other info" box of '''Properties...''' for the exact same information. Don't expect all of these to work for every track
{| border=1 cellspacing=0 cellpadding=3
! ''name'' !! What ''$info(name)'' or ''%__name%'' returns !! CODEC
|-
| bitrate || Returns the bitrate of the track. Eg: 271 || ''all''
|-
| bitrate_nominal || 192 || Vorbis
|-
| bitspersample || Eg: 16 || FLAC
|-
| codec || Returns the codec. Eg: Monkey's Audio, MP3, FLAC || ''all''
|-
| codec_profile || Possible Values: Normal,Fast || APE
|-
| enc_delay || Has to do with accurate length. Eg: 576 || MP3
|-
| enc_padding || Has to do with accurate length. Eg: 1536 || MP3
|-
| encoding || Possible values: lossy or lossless || ''all''
|-
| extrainfo
| Possible values: VBR
// CBR,VBR detection
$if2($info(extrainfo),CBR)
| MP3
|-
| channels || Possible values: 1, 2 || ''all''
|-
| cue_embedded || Returns '''yes''' or '''no''' || APE, FLAC
|-
| flags || Eg: 0 or 22 || APE
|-
| samplerate || 44100 || ''all''
|-
| MD5 || Contains an MD5 hash || APE
|-
| mp3_accurate_length || Returns yes or no || MP3
|-
| mp3_stereo_mode || stereo, joint stereo || MP3
|-
| tagtype || Returns a <nowiki>"|" delimited list of tags on the track. Eg: id3v2|id3v1|apev2</nowiki> || APE, MP3
|-
| tool || the encoder used to create the file. Eg: reference libFLAC 1.1.0 20030126 || FLAC, Vorbis
|-
| version || similar to '''tool''', the version of Monkey's Audio that encoded || APE
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000 Talk:Title Formatting Reference

2006-05-20T08:11:44Z

Reglib: /* Other information */

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %codec%
| Defined as ''$codec()''.
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Other information ===
This is an expansion of names for $info(name). Check the "Other info" box of '''Properties...''' for the exact same information. Don't expect all of these to work for every track
{| border=1 cellspacing=0 cellpadding=3
! ''name'' !! What ''$info(name)'' returns !! CODEC
|-
| bitrate || Returns the bitrate of the track. Eg: 271 || ''all''
|-
| bitrate_nominal || 192 || Vorbis
|-
| bitspersample || Eg: 16 || FLAC
|-
| codec || Returns the codec. Eg: Monkey's Audio, MP3, FLAC || ''all''
|-
| codec_profile || Possible Values: Normal,Fast || APE
|-
| enc_delay || Has to do with accurate length. Eg: 576 || MP3
|-
| enc_padding || Has to do with accurate length. Eg: 1536 || MP3
|-
| encoding || Possible values: lossy or lossless || ''all''
|-
| extrainfo || Possible values: VBR || MP3
|-
| channels || Possible values: 1, 2 || ''all''
|-
| cue_embedded || Returns '''yes''' or '''no''' || APE, FLAC
|-
| flags || Eg: 0 or 22 || APE
|-
| samplerate || 44100 || ''all''
|-
| MD5 || Contains an MD5 hash || APE
|-
| mp3_accurate_length || Returns yes or no || MP3
|-
| mp3_stereo_mode || stereo, joint stereo || MP3
|-
| tagtype || Returns a <nowiki>"|" delimited list of tags on the track. Eg: id3v2|id3v1|apev2</nowiki> || APE, MP3
|-
| tool || the encoder used to create the file. Eg: reference libFLAC 1.1.0 20030126 || FLAC, Vorbis
|-
| version || similar to '''tool''', the version of Monkey's Audio that encoded || APE
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000 Talk:Title Formatting Reference

2006-05-20T08:04:36Z

Reglib: /* Other information */ added more stuff

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %codec%
| Defined as ''$codec()''.
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Other information ===
This is an expansion of names for $info(name). Check the "Other info" box of '''Properties...''' for the exact same information. Don't expect all of these to work for every track
{| border=1 cellspacing=0 cellpadding=3
! ''name''
! What ''$info(name)'' returns
! CODEC
|-
! bitrate
| Returns the bitrate of the track. Eg: 271
| ''all''
|-
! bitrate_nominal
| 192
| Vorbis
|-
! bitspersample
| Eg: 16
| FLAC
|-
! codec
| Returns the codec. Eg: Monkey's Audio, MP3, FLAC
| ''all''
|-
| codec_profile || Possible Values: Normal,Fast || APE
|-
! enc_delay
| Has to do with accurate length. Eg: 576
| MP3
|-
! enc_padding
| Has to do with accurate length. Eg: 1536
| MP3
|-
! encoding
| Possible values: lossy or lossless
| ''all''
|-
! channels
| Possible values: 1, 2, ...
| ''all''
|-
! cue_embedded
| Returns '''yes''' or '''no'''
| APE, FLAC
|-
| flags || Eg: 0 or 22 || APE
|-
| samplerate || 44100 || ''all''
|-
| MD5 || Contains an MD5 hash || APE
|-
| mp3_accurate_length || Returns yes or no || MP3
|-
| mp3_stereo_mode || stereo, joint stereo || MP3
|-
! tagtype
| Returns a <nowiki>"|" delimited list of tags on the track. Eg: id3v2|id3v1|apev2</nowiki>
| APE, MP3
|-
| tool || the encoder used to create the file. Eg: reference libFLAC 1.1.0 20030126 || FLAC, Vorbis
|-
| version || similar to '''tool''', the version of Monkey's Audio that encoded || APE
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000 Talk:Title Formatting Reference

2006-05-20T07:52:27Z

Reglib: added Other info section

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %codec%
| Defined as ''$codec()''.
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Other information ===
This is an expansion of names for $info(name). Check the "Other info" box of '''Properties...''' for the exact same information. Don't expect all of these to work for every track
{| border=1 cellspacing=0 cellpadding=3
! name
! Returns value of technical information field called ''name''.
! CODEC
|-
! bitrate
| Returns the bitrate of the track. Eg: 128 271 320
| ''all''
|-
! bitrate_nominal
| 192
| Vorbis
|-
! bitspersample
| Eg: 16
| FLAC
|-
! codec
| Returns the codec. Eg: MP3, FLAC
| ''all''
|-
! encoding
| Possible values: lossy or lossless
| ''all''
|-
! channels
| Possible values: 1, 2, ...
|-
! cue_embedded
| Returns '''yes''' or '''no'''
| FLAC
|-
! samplerate
| 44100
|-
! mp3_stereo_mode
| stereo
| MP3
|-
! tagtype
| Returns a "|" delimited list of tags on the track. Eg: id3v2|id3v1|apev2
| MP3
|-
! tool
| the encoder used to create the file. Eg: reference libFLAC 1.1.0 20030126
| FLAC, Vorbis
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000 Talk:Title Formatting Reference

2006-05-20T07:28:18Z

Reglib: /* Technical information */ alphabetical orderized

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %codec%
| Defined as ''$codec()''.
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

User:Reglib

2006-05-20T06:39:32Z

Reglib: /* Wishlist */

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

That's based on the Navigator fcs for Columns UI. some changes I've made are:
* updating the general layout
* uses official playback component
* condensed play count/time column
* dimmed zero-padding
* entries with missing metadata are hilighted

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* Less obtrusive warning window
* infinite loop detection/termination
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.

Foobar2000 Talk:0.9 Continuator (foo dsp continuator)

2006-05-20T02:39:00Z

Reglib: CONTINUATOR-tag syntax

What is the syntax for CONTINUATOR metadata?

Something like this:
Tag Name: CONTINUATOR
<pre>
tag value | description
----------------------------------|-----------------------------------------------------
overlap | uses default preference-settings
overlap,threshold | uses default fade-lengths
overlap,threshold,fadelen | sets fadelength for both
| fadeout and fadein - both will have the same value
overlap,threshold,fadeout,fadein |
|
crossfade | uses default preference-settings
crossfade,fadelen | sets fadelength for both fadeout
| and fadein - both will have the same value
crossfade,fadeout,fadein |
|
gapkill | alias for "overlap,60"
|
off | disable continuator for this trackchange
</pre>
* threshold is in decibels (dB)
* all fade lengths are in milliseconds (ms)
http://www.hydrogenaudio.org/forums/index.php?act=ST&f=33&t=18703&hl=continuator-tag&view=findpost&p=381454

<pre>
tag value | description
---------------|------------------------------------------------------------------
overlap[,n] | track overlapping dependant on volume,
| optional parameter n: threshold, rms drop in dB (range 0-100)
|
crossfade[,t] | track crossfading,
| optional parameter t: time in ms (range 0-'Maximum overlap length')
|
off | do nothing
</pre>
http://www.hydrogenaudio.org/forums/index.php?act=ST&f=33&t=18703&hl=continuator-tag&view=findpost&p=304514

can anyone confirm that it still works?

and I assume if you have songs, A, B, C, and this tag were on song B, the action would occur on the B->C transition

--[[User:Reglib|Reglib]] 21:39, 19 May 2006 (CDT)

Foobar2000 Talk:Foobar2000

2006-05-20T02:23:07Z

Reglib:

<<snip>> Removed long dead conversations from 2005 Use '''history''' to view --[[User:Reglib|Reglib]] 21:23, 19 May 2006 (CDT)
----
You do realize that somebody responsible for hydrogenaudio is blocking entire ISP's IP-address ranges? It makes your software (foobar2000) look kind of raunchy at best. I stopped looking further right there, when I was pointed to your forum on "hydrogenaudio.org" it said that I could not view that.
Apparently this wiki is not blocking the IP-ranges, but that's besides the point.
What I also dislike about the foobar2000 'official' page, is that it is way too anonymous and scary. WHO created it? Is it a human being, a company? Is there a contact or about page anywhere to look at? If it is on that hydrogen domain, we can't see it. Just so you know. I wouldn't put my info in their hands for a second if I were you. [[User:Kjhgkjg|Kjhgkjg]] 18:10, 3 February 2006 (CST)
----
I'm thinking about reorganizing this page to be friendier for people looking to learn more about Foobar2000 while maintaining it as quick reference for veterans.
* Pretty colors, probably using tables, to further delineate sections
* Using keywords people are more used to such as: download, screenshots, support
* Pictures that don't mean anything but look pretty

I hope you all like pink and unicorns! j/k

--[[User:Reglib|Reglib]] 21:23, 19 May 2006 (CDT)

User:Reglib

2006-05-19T22:34:42Z

Reglib: /* My Foobar2000 */

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

That's based on the Navigator fcs for Columns UI. some changes I've made are:
* updating the general layout
* uses official playback component
* condensed play count/time column
* dimmed zero-padding
* entries with missing metadata are hilighted

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.

Foobar2000 Talk:Title Formatting Reference

2006-05-19T22:28:35Z

Reglib: /* Now playing info */ fixed stuff

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
%_time_elapsed%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as [hours:]minutes:seconds
|-
! %length_ex%
| Returns the length of the track formatted as [hours:]minutes:seconds.milliseconds
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000 Talk:Title Formatting Reference

2006-05-19T19:28:49Z

Reglib: /* Playlist info */ %_playlist_number% is not zero padded

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)
:The answer is "no", klang, but this question belongs in the forum. -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)
:It's a reference, not a tutorial, but table-formatting sounds intriguing. ;) -- [[User:Canar|Canar]] 23:37, 15 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
%_time_elapsed%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as hours, minutes, and seconds.
|-
! %length_ex%
| Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.
|-
! %_playlist_number%
| Returns a the playlist index of specified item with no padding. The first item is at index 1.
|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000:Components

2006-05-17T10:02:08Z

Reglib: /* Input */ added

=Components for Foobar2000 v0.9.x=
This page contains most Foobar2000 v0.9.x components available at time of last update. Descriptions where available. More information on these plugins can be found by searching the [http://www.hydrogenaudio.org/forums/index.php?showforum=28 foobar2000 forums].

Much of the information here came from [http://www.hydrogenaudio.org/forums/index.php?showtopic=42730&st=0 this thread] which may be more up to date, and also shows a list of components not yet updated from earlier versions of foobar2000.

==Columns UI==
[http://music.morbo.org/components.php Columns UI] is a very popular alternate interface for foobar2000 based on a columns and panel layout. It has a separated wiki that is located [http://music.morbo.org/wiki/columns_ui:columns_ui here].

Columns UI has its own plugin system and these plugins extend the user interface:
* [http://stephan.kochen.nl/proj/foobar2000.html Album Art Panel (foo_uie_albumart)] ([[Foobar2000:0.9 Album Art Panel (foo_uie_albumart)|''more info'']]) Panel to display album art
* [http://tmp.reharmonize.net/foobar/ Album Art Panel for matroska (foo_uie_albumart_mka)] Albumart mod to read matroska covers.
* [http://music.morbo.org/components.php Album List Panel (foo_uie_albumlist)] Displays the database in a treeview using customizable sorting methods (by genre, artist, directory, ..)
* [http://ku.myftp.org/goods/ Explorer Panel (foo_uie_explorer)] Displays a treeview of selected disks/folders.
* [http://foobar.s53.xrea.com/up/ Lyrics Panel (foo_uie_lyrics_panel)] Display lyrics stored in file tags.
* [http://wiki.bowron.us/index.php/Foobar2000 Music Browser (foo_browser)] Panels for Browsing Library, Similar to iTunes
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44703 Playlist Dropdown (foo_uie_playlists_dropdown)] Displays the playlist in a dropdown menu.
* [http://wiki.bowron.us/index.php/Foobar2000#foo_playlist_tree Playlist Tree (foo_playlist_tree)] Tree based media library with many available customizations.
* [http://stephan.kochen.nl/proj/foobar2000.html Track Info Panel (foo_uie_trackinfo)] ([[Foobar2000:0.9 Track Info Panel (foo_uie_trackinfo)|''more info'']]) Uses TAGZ to display information about a selected track

==DSP==
* [http://www.andrewlabs.com/downloads/downloads.php ATSurround Processor (foo_dsp_atsurround)] ([[Foobar2000:0.9 ATSurround Processor (foo_dsp_atsurround)|''more info'']]) Reproduces surround sound information present in many stereo audio material and more.
* [http://bs2b.sourceforge.net/ BS2D (foo_dsp_bs2p)] ([[Foobar2000:0.9 BS2D (foo_dsp_bs2p)|''more info'']]) Improves headphone listening of regular hi-fi stereo records.
* [http://www.skipyrich.com/foobar/foo_channel_mixer.ptml Channel Mixer (foo_channel_mixer)] ([[Foobar2000:0.9 Channel Mixer (foo_channel_mixer)|''more info'']]) Up/down mix to/from 1-6 channels
* [http://stephan.kochen.nl/proj/foobar2000.html#continuator Continuator (foo_dsp_continuator)] ([[Foobar2000:0.9 Continuator (foo_dsp_continuator)|''more info'']]) Allows for advanced crossfading between tracks
* [http://www.foobar2000.org/components/index.html Convolve (foo_convolve)] ([[Foobar2000:0.9 Convolve (foo_convolve)|''more info'']]) Takes impulse response and does a fast convolution of the sound data with that impulse response.
* [http://www.naivesoftware.com/software.html Crossfeed (foo_dsp_crossfeed)] Filters the music to help reduce fatigue caused by listening to music with headphones
* [http://pelit.koillismaa.fi/plugins/dsp.php#132 Dolby Headphone Wrapper (foo_dsp_dolbyhp)] ([[Foobar2000:0.9 Dolby Headphone Wrapper (foo_dsp_dolbyhp)|''more info'']]) Dolby Headphone engine DLL.
* [http://www.stud.uni-karlsruhe.de/~uybc/foo_dsp_delta.zip LPCM <--> Delta-PCM Converter (foo_dsp_delta)] Noise sharpening filter
* [http://www.oss3d.com/index.html OSS/3D (foo_dsp_oss3ddsp)] Audio enhancement (SHAREWARE)
* [http://www.acc.umu.se/~zao/foobar2000/#foo_dsp_silence Post-track Silence (foo_dsp_silence)] Inserts a configurable amount of silence after each track to help external devices like MiniDisc players to sync track changes.
* [http://otachan.com/foo_dsp_ssrc.html SSRC (foo_dsp_ssrc)] ([[Foobar2000:0.9 SSRC (foo_dsp_ssrc)|''more info'']]) Sample rate converter.
* [http://www.skipyrich.com/foobar/foo_dsp_tube.ptml Tube Sound (foo_dsp_tube)] ([[Foobar2000:0.9 Tube Sound (foo_dsp_tube)|''more info'']]) Emulate tube sound.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=22057&view=findpost&p=374256 VLevel (foo_dsp_vlevel)] ([[Foobar2000:0.9 VLevel (foo_dsp_vlevel)|''more info'']]) Dynamic compressor which amplifies the quiet parts of music.
* [http://xover.sourceforge.net/ XOver (foo_dsp_xover)] ([[Foobar2000:0.9 XOver (foo_dsp_xover)|''more info'']]) Implements this digital crossover to achieve active multi-amplification.

==Input==
* [http://kode54.foobar2000.org/ AC3 Decoder (foo_ac3)] Plays Dolby Digital lossy audio compression technologies format.
* [http://dl.matroska.org/downloads/foobar2000/ AC3 Packet Decoder (foo_packet_decoder_ac3)] Needed for [[AC3]] in [[Matroska]].
* [http://kode54.foobar2000.org/ ADPCM Decoder (foo_adpcm)] Plays GameCube ADPCM audio data and some. (DSP, ADP, GCM, HPS, STM, AST...)
* [http://www.foobar2000.com/components/index.html ALAC Decoder (foo_input_alac)] Apple Lossless (ALAC) decoder (has known stability issues: random crashes during decoding).
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43766 Another Slight Atari Player (foo_asap)] [http://asap.sourceforge.net/ ASAP] is a player/converter of Atari 8-bit music for modern computers. It provides high-quality, identical to the popular Atari800 emulator, emulation of the POKEY sound chip and the 6502 processor.
* [http://kode54.foobar2000.org/ DUMB Module Decoder (foo_dumb)] Plays your favorite module files, and then some. (MOD, S3M, XM, IT, 669, PTM, PSM, MTM, UMX)
* [http://shexec32.serveftp.net/products.aspx?id=foo_game Game Audio Decoder (foo_game)] Plays Westwood's audio (.aud), Sierra's sounds (.sfx/.aud), Core design's cd audio (cdaudio.wad), Funcom's music (.iss), Rome Total War's IDX (.idx/.dat), Timegate's format (.rwd), EA's Pathfinder audio (.mus) and Ben Gerard's music (.sc68).
* [http://kode54.foobar2000.org/ Game Emu Player (foo_gep)] Plays several emulation formats. (GBS, NSF, SPC, GYM, HES, VGM)
* [http://kode54.foobar2000.org/ Lunar 2 PCM Decoder (foo_lunar2)] Plays the RP*.PCM files found on the original Lunar: Eternal Blue CD.
* [http://tmp.reharmonize.net/foobar/ Matroska Plugin (unofficial) (foo_input_matroska)] [[Matroska]] decoder.
* [http://shexec32.serveftp.net/products.aspx?id=foo_m1 M1 Decoder (foo_m1)] ([[Foobar2000:0.9 M1 (foo_m1)|More info]]) Plays arcade/pinball game sound.
* [http://kode54.foobar2000.org/ MIDI Synthesizer Host (foo_midi)]
* [http://www.foobar2000.com/components/index.html Monkey's Audio Decoder (foo_input_monkey)] [[Monkey's Audio]] (APE) decoder (this component has known unresolved stability issues with 0.9)
* [http://kode54.foobar2000.org/ PSF Decoder (foo_psf)] Plays PSF files.
* [http://kode54.foobar2000.org/ SID Player 2 (foo_sid)] Sound chip of Commodore's CBM-II, Commodore 64 and Commodore 128 home computers.
* [http://foosion.foobar2000.org/0.9/ Shorten Decoder (foo_input_shorten)] Shorten (SHN) is a file format used to losslessly compress CD-quality audio files.
* [http://tmp.reharmonize.net/foobar/ TTA Audio Decoder (unofficial) (foo_input_tta)] [[TTA]] (True Audio) Free Lossless Audio Codec

==Output==
* [http://www.foobar2000.com/components/index.html ASIO Output (foo_out_asio)] Adds ASIO output support.
* [http://www.foobar2000.com/components/index.html Kernel Streaming Output (foo_out_ks)] Allows bit-exact playback bypassing Windows kernel mixer.

==Visualisation==
* [http://stephan.kochen.nl/proj/foobar2000.html#projectM ProjectM Visualisation (foo_vis_projectM)] Based on the ProjectM project, which is a reimplementation of Milkdrop under OpenGL.
* [http://www.rabidhamster.org/R4/ R4 Visualisation] ([[Foobar2000:R4 Visualisation|''more info'']]) Stand alone visualisation, uses "What You Hear" sound as input

==Other==
===Library tools===
* [http://www.foobar2000.com/components/index.html Audio CD Writer (foo_burninate)] CD burning support (requires Nero to be installed on your system.)
* [http://www.foobar2000.com/components/index.html Autoplaylist Manager (foo_autoplaylist)] Presents a Media Library query in a dynamically-generated playlist (under development).
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44656 Bin Pack (foo_binpack)] Creates playlists from a list with a maximum length.
* [http://tmp.reharmonize.net/foobar/ Cuesheet Creator (foo_cuesheet_creator)] Cuesheet creator.
* [http://wiki.bowron.us/index.php/Foobar2000#foo_cwb_hooks Cwbowron's Title formating (foo_cwb_hooks)] ([[Foobar2000:0.9 CwBowron's Title formating (foo_cwb_hooks)|''more info'']]) Special title formating.
* [http://foosion.foobar2000.org/0.9/ Database Search (foo_dbsearch)] ([[Foobar2000:0.9 Database Search (foo_dbsearch)|''more info'']]) Database search.
* [http://foosion.foobar2000.org/0.9/ Freedb Tagger (foo_freedb2)] Freedb tagger.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43012 History (foo_history)] Very basic song history.
* [http://foosion.foobar2000.org/0.9/ Live Show Tagger (foo_tradersfriend)] ([[Foobar2000:0.9 Live Show Tagger (foo_tradersfriend)|''more info'']]) Live show tagger.
* [http://eludevisibility.org/music/ MeowDB (foo_meowdb)] ([[Foobar2000:0.9 MeowDB (foo_meowdb)|''more info'']]) Takes the Media Library and outputs the results to a form and uploads it to your server using the cURL library.
* [http://www.foobar2000.com/components/index.html Play Count (official) (foo_playcount)] ([[Foobar2000:0.9 Play Count (official) (foo_playcount)|''more info'']]) Collects statistics about tracks from your Media Library being played.
* [http://stephan.kochen.nl/proj/foobar2000.html#playcount Play Count (foo_playcount)] ([[Foobar2000:0.9 Play Count (foo_playcount)|''more info'']]) Keeps track of the amount of times, the last time, and the first time a track has been played.
* [http://foosion.foobar2000.org/0.9/ Playback Queue Viewer (foo_pqview)] Playback queue viewer.
* [http://www.skipyrich.com/foobar/foo_playlist_bind.ptml Playlist Bind (foo_playlist_bind)] Synchronize playlist with contents of specific directory.
* [http://otachan.com/foo_playlistclear.html Playlist Clear (foo_playlistclear)] All playlists are cleared at startup.
* [http://foosion.foobar2000.org/0.9/ Playlist Manager (foo_playlist_manager)] Playlist manager.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43522 Playlist Name Enhenced (foo_playlist_name_enhanced)] ([[Foobar2000:0.9 Playlist Name Enhenced (foo_playlist_name_enhanced)|''more info'']]) Appends automatically playlist info ("items / length") to all playlist names.
* [http://foosion.foobar2000.org/0.9/ Playlist Tools (foo_utils)] ([[Foobar2000:0.9 Playlist Tools (foo_utils)|''more info'']]) Provides various general commands.
* [http://foosion.foobar2000.org/0.9/ Randomized Playlist Entry (foo_random)] Randomized playlist entry.
* [http://gro.clinux.org/frs/?group_id=737&release_id=1095 Special File Info Box (foo_infobox)] ([[Foobar2000:0.9 Special File Info Box (foo_infobox)|''more info'']]) A replacement of the built-in file info box.

===Notifier===
* [http://pelit.koillismaa.fi/plugins/general.php#40 AMIP Wrapper (foo_amipwrapper)] Complete now-playing plug-in for mIRC, PIRCH, Klient, Bersirc, other IRC and Mail clients, supporting full player control from mIRC, playlist search, clipboard integration, HTTP, dynamic image signatures, etc.
* [http://stephan.kochen.nl/proj/foobar2000.html#msn MSN Now Playing (alt) (foo_msnalt)] ([[Foobar2000:0.9 MSN Now Playing (alt) (foo_msnalt)|''more info'']]) Show the current song as "Now Playing" in MSN and MS Live messenger.
* [http://kode54.foobar2000.org/ On-Screen Display (foo_osd)] ([[Foobar2000:0.9 On-Screen Display (foo_osd)|''more info'']]) On screen display of track information and volume bar.
* [http://kode54.foobar2000.org/ On-Screen Display GDI+ (foo_osd_gdiplus)] ([[Foobar2000:0.9 On-Screen Display (foo_osd)|''more info'']]) Same as foo_osd but uses GDI+ for osd drawing.
* [http://www.maroonspoon.com/foo_prettypop/ Pretty Popup (foo_prettypop)] ([[Foobar2000:0.9 Pretty Popup (foo_prettypop)|''more info'']]) Display a moderately sized popup of song information when a new song plays.

===Online database===
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=44320&st=0 Audioscrobbler (foo_audioscrobbler)] Audioscrobbler will send the name of every song you play on your computer to Last.fm. This effortlessly populates your profile to play radio you like and make personalized recommendations.
* [http://foosion.foobar2000.org/0.9/ Foosic Music Database (foo_sic)] Sends track information to the [http://www.foosic.org/ foosic online database]. You can currently view your top artist, album and track statistics with foosic.

===Remote control===
* [http://pelit.koillismaa.fi/plugins/general.php#138 Advanced Controls (foo_advancedcontrols)] ([[Foobar2000:0.9 Advanced Controls (foo_advancedcontrols)|''more info'']]) Control all the playback functions from icons in the Taskbar Notification Area (play, pause, next, previous, open)
* [http://foosion.foobar2000.org/0.9/ COM Automation Server (foo_comserver)] Allows controlling foobar2000 through COM Automation
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=38114 Control Server (foo_controlserver)] Acts as a server to control Foobar2000. Connect with a telnet client and control it using ASCII commands.
* [http://otachan.com/foo_ddecontrol.html DDE Control (foo_ddecontrol)] Control foobar remotelly with DDE interprocess communication (interface in japanese only).
* [http://foobar.daychanged.com/ HTTP Writer (foo_write_http)] It's TCP/IP server that listens on a specified port for incoming requests such as play, stop, etc.
* [http://www.hydrogenaudio.org/forums/index.php?s=&showtopic=19252&view=findpost&p=391028 WinLIRC Client (foo_lirc)] ([[Foobar2000:0.9 WinLIRC Client (foo_lirc)|''more info'']]) Control Foobar from a remote control.

===Misc===
* [http://www.foobar2000.com/components/index.html Binary Comparator (foo_bitcompare)] Performs binary comparison between two or more tracks and reports differences.
* [http://foosion.foobar2000.org/0.9/#channelusage Channel Usage Visualisation (foo_vis_channelusage)] Channel Usage Visualisation.
* [http://foosion.foobar2000.org/0.9/ Common Services (foo_common)] Common services.
* [http://www.foobar2000.com/components/index.html Decoding Speed Test (foo_benchmark)] ([[Foobar2000:0.9 Decoding Speed Test (foo_benchmark)|''more info'']]) Measures decoding speed of audio files.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=37204 Fullscreen (foo_fullscreen)] Enable fullscreen mode.
* [http://lyrics.mirkforce.net/ LyricsDB (foo_lyricsdb)] ([[Foobar2000:0.9 LyricsDB (foo_lyricsdb)|''more info'']]) Search lyrics basing on song's artist title and sometimes album.
* [http://www.crintsoft.com/minilyrics.htm Mini Lyrics (foo_ui_minilyrics)] ([[Foobar2000:0.9 Mini Lyrics (foo_ui_minilyrics)|''more info'']]) Lyrics viewer for synchronizing and displaying lyrics of the currently playing song.
* [http://kode54.foobar2000.org/ Pause On Lock (foo_lock)] Pauses/unpauses foobar2000 on workstation lock/unlock.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42736&hl=foo_sendtodevice Send To Device (foo_sendtodevice)] Add "Send to Device" feature.
* [http://foosion.foobar2000.org/0.9/ Shell Link Resolver (foo_lnk)] Shell link resolver.
* [http://stephan.kochen.nl/proj/foobar2000.html#notaskbar Taskbar Button Remover (foo_notaskbar)] Hides Foobar2000 from the taskbar, even when the window is normally visible.
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=42941 Winamp API Emulator (foo_winamp_spam)] Designed to create a fake Winamp 1.x window which will act as a wrapper between applications written to use the Winamp API and foobar2000.
* [http://www.maroonspoon.com/foo_xm/ XM Radio Online Player (foo_xm)] Allow you to listen to XM Radio channels over the Internet by using XM Radio Online.

=Links=
* [http://www.foobar2000.org/components/index.html Official components site]
* [http://pelit.koillismaa.fi/plugins/ Official third-party components site]
* [http://music.morbo.org/components.php musicmusic's components] including Columns UI
* [http://stephan.kochen.nl/proj/foobar2000.html Several popular components ported to 0.9]
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=21105 Most Sought-After Plugins] (forum thread, foobar v0.8.3 only)
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=28647 Columns UI thread]: first post contains links to many Columns UI panel extensions

[[Category: foobar2000]]

User:Reglib

2006-05-16T09:41:54Z

Reglib: /* Wishlist */ formatting, old style playback follows cursor

Hi.
I used to be an electrical engineer, focusing on solid state crap, but now I'm in the movie business. I focus on a lot of aspects, but I ironically stay away from sound (I just give that stuff to friends). I do have knowledge from signal processing courses and the field, but I just don't enjoy it as much as video.

Apart from a maintaining a personal wiki, I contribute to the Unofficial Konfabulator (yahoo! widget engine) wiki.

I'm fairly new to Foobar2000. I like to keep things simple.

== My Foobar2000 ==
[http://img163.imageshack.us/my.php?image=myfb2k3ek.jpg http://img163.imageshack.us/img163/2756/myfb2k3ek.th.jpg] Low Compression

=== Global Hotkeys: ===
* masstagger rating scripts Ctrl+1 through Ctrl+5
* mm keys mapped, except mm(stop) -> activate/hide
* pause = activate pretty pop(fast)
* CTRL+` = open folder

ColumnsUI based on Navigator. Switched from an old Azreal. Unfortunately I keep modifying it, so upgrading will be difficult. My current IDE (HTML-Kit) oddly doesn't support unicode. So I'll probably find another and use syntax hilighting.

I maintain two foobar2000 setups. one '''stable''' and the other *gasp* '''unstable'''.

=== Wishlist ===
* toggle buttons in toolbar could indicate state (Follow Cursor, Follow Playback, Stop after Current, etc.)
* One-click RePlay Gain
* ability to count the number of selected items
** 2006-05-15 20h57 norz: you can see that in the properties box, or you could write a lua script (with foo_lua) that would output the number in the console, when invoked (eg: via a keyboard shortcut), but I guess, you'd like to see it in the status bar next to the total playing time... don't know how to do that, sorry.
** yeah... in the status bar, right next to selected total time is what i'm thinking - [[User:Reglib|Reglib]] 04:41, 16 May 2006 (CDT)
* 0.9beta style "playback follows cursor" for when nothing is selected. Here's the situation, I have an autoplaylist that contains only unrated songs and playback mode to random. If ''playback follows cursor'' is enabled, after i rate a song, foobar *thinks* the Nth track is still selected, and plays it next.

Talk:Bitrate

2006-05-16T01:09:00Z

Reglib: possible references

I wasn't sure about some of the facts presented in the article so here's some relavent Wikipedia links:
* http://en.wikipedia.org/wiki/Binary_prefix#Specific_units_of_IEC_60027-2_A.2
* http://en.wikipedia.org/wiki/Bit_rate

Also, I'm not sure how technical this article should be. I'm thinking about the blurb about baud rate. I learned it as a symbol rate, but then we'd have to define what a symbol is. Personally I'd just remove it.
--[[User:Reglib|Reglib]] 20:09, 15 May 2006 (CDT)

User:Reglib

2006-05-15T09:17:06Z

Reglib: /* My Foobar2000 */

Foobar2000:Title Formatting Reference

2006-05-15T08:49:16Z

Reglib: /* Related articles */

This article contains information about built-in titleformatting functions and field references with special meaning. References to documentation about fields and function which can only be used in specific components or which are provided by specific components can be found at the end of this article.

A field reference is a field name enclosed in percent signs, for example ''%artist%''. A function call starts with a dollar sign, followed by the function name and the parameter list. A parameter list can either be empty - denoted as ''()'' - or contain one or more parameters separated by commata, for example ''$abbr(%artist%)''. Note that there must be no whitespace between the dollar sign and the function name, or the function name and the opening parenthesis of the parameter list.

Please see [[Foobar2000:Titleformat_Introduction|Titleformat Introduction]] for a presentation of titleformat syntax in general.

= Field remappings =

Some of the fields accessible through ''%name%'' are remapped to other values to make writing titleformat scripts more convenient.

== Metadata ==

=== %album artist% ===
Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.

=== %album% ===
Defined as ''$if3($meta(album),$meta(venue))''.

=== %artist% ===
Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.

=== %disc% ===
Returns the discnumber. The discnumber is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.

This is equivalent to the %discnumber% remapping.

=== %discnumber% ===
Returns the discnumber. The discnumber is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.

This is equivalent to the %disc% remapping.

=== %track artist% ===
Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.

=== %title% ===
Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.

=== %track% ===
Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.

This is equivalent to the %tracknumber% remapping.

=== %tracknumber% ===
Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.

This is equivalent to the %track% remapping.

== Technical information ==

=== %bitrate% ===
Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.

=== %channels% ===
Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".

=== %filesize% ===
Defined as ''%_filesize%''. Returns the filesize in bytes.

=== %samplerate% ===
Defined as ''$info(samplerate)''. Returns the samplerate in Hz.

=== %codec% ===
Defined as ''$codec()''.

== Special fields ==

=== %playlist_number% ===
Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns the position of the track as index into the playlist. The first track has index 1. The index is padded from the left with zeroes to the same number of digits as the last track.

= Control flow =

The functions in this section can be used to conditionally execute statements.

=== [...] (conditional section) ===

Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''artist'' would return "?".

=== $if(cond,then) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.

=== $if(cond,then,else) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.

=== $if2(a,else) ===

Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.

=== $if3(a1,a2,...,aN,else) ===

Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifgreater(n1,n2,then,else) ===

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $iflonger(s1,s2,then,else) ===

Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $select(n,a1,...,aN) ===

If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.

= Arithmetic functions =

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0

=== $add(a,b) ===

Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.

=== $div(a,b) ===

Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.

=== $greater(a,b) ===

Returns true, if ''a'' is greater than ''b'', otherwise false.

=== $max(a,b) ===

Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.

=== $min(a,b) ===

Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.

=== $mod(a,b) ===

Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.

=== $mul(a,b) ===

Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.

=== $muldiv(a,b,c) ===

Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.

=== $rand() ===

Generates a random number in the range from 0 to 232-1.

=== $sub(a,b) ===

Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.

= Boolean functions =

The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.

=== $and(...) ===

Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.

=== $or(...) ===

Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.

=== $not(x) ===

Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.

=== $xor(...) ===

Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.

= Color functions =

=== $blend(color1,color2,part,total) ===

Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.

=== $hsl() ===

Resets the text color to the default color.

=== $hsl(h,s,l) ===

Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.

=== $hsl(h1,s1,l1,h2,s2,l2) ===

Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.

=== $rgb() ===

Resets the text color to the default color.

=== $rgb(r,g,b) ===

Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.

=== $rgb(r1,g1,b1,r2,g2,b2) ===

Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.

=== $transition(string,color1,color2) ===

Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.

= Now playing info =
The following functions and fields are usable for scripts used with the currently playing item, for example the status bar, the main window title and the copy command script.

== Special fields ==

=== %playback_time% ===
Returns the elapsed time formatted as [HH:]MM:SS.

=== %playback_time_seconds% ===
Returns elapsed time in seconds.
Old version: <code>%_time_elapsed%</code>

=== %playback_time_remaining% ===
Returns remaining time until track ends, formatted as [HH:]MM:SS.
Old version: <code>%_time_remaining%</code>

=== %playback_time_remaining_seconds% ===
Returns remaining time in seconds.
Old version: <code>%_time_remaining_seconds%</code>

=== %length% ===
Returns the length of the track formatted as hours, minutes, and seconds.
Old version: <code>%_time_total%</code>

=== %length_ex% ===
Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.

=== %length_seconds% ===
Returns the length of the track in seconds.
Old version: <code>%_time_total_seconds%</code>

=== %length_seconds_fp% ===
Returns the length of the track in seconds as floating point number.

=== %length_samples% ===
Returns the length of the track in samples.

= Playlist info =
The following functions and fields are usable for playlist scripts such as masstagger.

== Special fields ==

=== %isplaying% ===

Returns "1" if file is currently playing and empty string otherwise.

The old version <code>%_isplaying%</code> still works.

=== %ispaused% ===

Returns "1" if playback is paused, empty string otherwise.

The old version <code>%_ispaused%</code> still works.

=== %list_index% ===

Returns a zero-padded playlist index of specified item. The first item is at index 1.

Also see [[Foobar2000:Titleformat Reference#%playlist_number%|%playlist_number%]].

The old version <code>%_playlist_number%</code> still works.

=== %list_total% ===

Returns number of items in the playlist.

The old version <code>%_playlist_total%</code> still works.

=== %playlist_name% ===

Returns the name of the playlist containing the specified item.

The old version <code>%_playlist_name%</code> still works.

= String functions =

The functions in this section can be used to manipulate character strings.

=== $abbr(x) ===

Returns abbreviation of ''x''.

=== $abbr(x,len) ===

Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.

=== $ansi(x) ===

Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.

=== $ascii(x) ===

Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.

=== $caps(x) ===

Converts first letter in every word of x to uppercase, and all other letters to lowercase.

=== $caps2(x) ===

Converts first letter in every word of x to uppercase, and leaves all other letters as they are.

=== $char(x) ===

Inserts Unicode character with code ''x''.

=== $crc32(a) ===

Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)

=== $crlf() ===

Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.

=== $cut(a,len) ===

Returns first ''len'' characters on the left of ''a''.

=== $directory(x) ===

Extracts directory name from the file path ''x''.

=== $directory(x,n) ===

Extracts directory name from the file path ''x''; goes up by ''n'' levels.

=== $ext(x) ===

Extracts file extension from ''x'' which must be a file name or path.

=== $filename(x) ===

Extracts file name from full path.

=== $fix_eol(x) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.

=== $fix_eol(x,indicator) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.

=== $hex(n) ===

Formats the integer number ''n'' in hexadecimal notation.

=== $hex(n,len) ===

Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $insert(a,b,n) ===

Inserts ''b'' into ''a'' after ''n'' characters.

=== $left(a,len) ===

Returns the first ''len'' characters from the left of ''a''.

=== $len(a) ===

Returns length of string ''a'' in characters.

=== $len2(a) ===

Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).

=== $longer(a,b) ===

Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.

=== $lower(a) ===

Converts ''a'' to lowercase.

=== $longest(a,...) ===

Returns the longest of its arguments. Can be used with an arbitrary number of strings.

=== $num(n,len) ===

Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $pad(x,len) ===

Pads ''x'' from the left with spaces to ''len'' characters.

=== $pad_right(x,y) ===

Pads ''x'' from the right with spaces to ''len'' characters.

=== $pad(x,len,char) ===

Pads ''x'' from the left with ''char'' to ''len'' characters.

=== $pad_right(x,len,char) ===

Pads ''x'' from the right with ''char'' to ''len'' characters.

=== $padcut(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.

=== $padcut_right(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.

=== $progress(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.

=== $progress2(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.

=== $repeat(a,n) ===

Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.

=== $replace(a,b,c) ===

Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"

=== $right(a,len) ===

Returns the first ''len'' characters from the right of ''a''.

=== $roman(n) ===

Formats the integer number ''n'' in roman notation.

=== $rot13() ===

Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".

=== $shortest ===

Returns the shortest of its arguments. Can be used with an arbitrary number of strings.

=== $strchr(s,c) ===

Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1

=== $strrchr(s,c) ===

Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4

=== $strstr(s1,s2) ===

Finds first occurence of string ''s2'' in string ''s1''.

=== $strcmp(s1,s2) ===

Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.

=== $stricmp(s1,s2) ===

Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.

=== $substr(s,m,n) ===

Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.

=== $trim(s) ===

Removes leading and trailing spaces from string ''s''.

=== $tab() ===

Inserts one tabulator character.

=== $tab(n) ===

Inserts ''n'' tabulator characters.

=== $upper(s) ===

Converts string ''s'' to uppercase.

= Track info =

The functions and fields in this section can be used to access information about tracks.

== Metadata ==

=== $meta(name) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"

=== $meta(name,n) ===
Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"

=== $meta_sep(name,sep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"

=== $meta_sep(name,sep,lastsep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"

=== $meta_test(...) ===
Returns ''1'', if all given tags exist, ''undefined'' otherwise.

Example: ''$meta_test(artist,title)'' -> true

=== $meta_num(name) ===
Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3

=== $tracknumber() ===
Returns the tracknumber padded to 2 digits with zeroes.

=== $tracknumber(n) ===
Returns the tracknumber padded to ''n'' digits with zeros.

== Technical information ==

=== $info(name) ===
Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2

=== $codec() ===
Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"

=== $channels() ===
Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"

=== %__replaygain_album_gain% ===
Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.

=== %__replaygain_album_peak% ===
Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.

=== %__replaygain_track_gain% ===
Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.

=== %__replaygain_track_peak% ===
Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.

== Special fields ==

=== $extra(name) ===
Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
==== %filename% ====
Returns the filename without directory and extension.
==== %filename_ext% ====
Returns the filename with extension, but without the directory.
==== %directoryname% ====
Returns the name of the parent directory only, not the complete path.
==== %lastmodified% ====
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
==== %path% ====
Returns the path.
==== %path_raw% ====
Returns the path as URL including the protocol scheme.
==== %subsong% ====
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
==== $extra(foobar2000_version) ====
Returns a string representing the version of foobar2000.

= Variable operations =

Variables can be used to store strings and number. They cannot store truth values. They are best used to store intermediate results that you need multiple times. Variable names are not case-sensitive.

For example:
{| border="0" cellspacing="0" cellpadding="2"
! code
! output
|-
|<pre>$put(foo,bar)$char(10)
$get(foo)$char(10)
$get(Foo)$char(10)
$puts(foo,2000)$char(10)
$get(foo)$char(10)</pre>
| style="background-color:#EEF" |<pre>bar
bar
bar

2000</pre>
|}
=== $get(name) ===

Returns the value that was last stored in the variable ''name'', if the variable was not defined (yet), it returns nothing. The truth value returned by ''$get'' indicates if the variable ''name'' was defined

=== $put(name,value) ===

Stores ''value'' in the variable ''name'' and returns ''value'' unaltered

=== $puts(name,value) ===

Stores ''value'' in the variable ''name'' and returns nothing

= Component-provided fields and functions on tracks =

This section lists components that provide additional fields and functions that are useable in the context of any track.

== Playback statistics ==

* [http://www.foobar2000.org/beta/components.html Playback statistics homepage]
* [[Foobar2000:Titleformat Playback Statistics|Playback statistics titleformat reference]]

= Component-specific fields and functions =

This section lists components that provide additional fields and functions that are only useable in the context of the particular component.

== Album list ==

The official album list component supports creating multiple tree entries using special commands.

* [http://www.foobar2000.org/ Album list homepage]
* [[Foobar2000:Titleformat Album List|Album list titleformat reference]]

== Columns UI ==

* [http://music.morbo.org/wiki/columns_ui:manual Columns UI homepage]
* [http://music.morbo.org/wiki/columns_ui:config:global_variables Global variables reference]
* [http://music.morbo.org/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://music.morbo.org/wiki/columns_ui:config:playlist_switcher_titleformatting Playlist switcher reference]

= Additional Reading =

* [[Foobar2000:Titleformat_Introduction|Introduction to titleformat scripts]]
* '''titleformat_help.html''' in your Foobar2000 directory (ie C:\Program Files\foobar2000\titleformat_help.html) file:///C:/Program%20Files/foobar2000/titleformat_help.html

User:Reglib

2006-05-15T08:32:02Z

Reglib: added screencap of my foob

Foobar2000:Foobar2000

2006-05-15T07:33:06Z

Reglib: /* Specific Guides */ added "Increasing Performance" page / more formal wording / consistency

==Introduction==

Foobar2000 is a freeware audio player, and more. It can not only play, it can also make a library, transcode files, rip CDs, ... the list goes on and on. A very powerful tool.

Check it out to explore its full power.

==Features==

* Open component architecture allowing third-party developers to extend functionality of the player
* Full Unicode support on Windows NT
* ReplayGain support
* Low memory footprint, efficient handling of really large playlists
* Advanced file info processing capabilities (generic file info box and masstagger)
* Highly customizable playlist display
* Customizable keyboard shortcuts
* Gapless playback
* Multiple playlists
* Music library
* Streaming Support
* Freeware

==Audio Formats Supported==

Native Support ("out-of-the-box"):
* [[MP3]], [[Ogg Vorbis]], [[MP2]], [[AAC]], [[WAV]], [[AIFF]], [[Musepack]], [[VOC]], [[SND]]

Supported through plug-ins:
* [[TTA]], [[FLAC]], [[Monkey's Audio]], [[WavPack]], [[Speex]], [[Mod]], [[SPC]], [[TFMX]], [[Shorten]], [[OptimFROG]], [[LPAC]], [[WMA]], [[AC3]], [[PSF]], [[NSF]], [[XID]], [[XA]], [[Matroska]]

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.

Foobar2000 has been coded exclusively for the Windows platform with an English interface. The author does not intend to provide alternate language versions nor alternate platform versions. However, several people have had success running foobar2000 on x86 Linux systems by using [http://www.winehq.org/ Wine], although the Columns UI plugin is known to be problematic.

==Using foobar2000==
* [[foobar2000:components 0.8|foobar2000 0.8.x Components]]
* [[foobar2000:components 0.9|foobar2000 0.9.x Components]]
* [[foobar2000:Directories|foobar2000 Directories]]
* [[foobar2000:FAQ|foobar2000 FAQ]]
* [[foobar2000:Encouraged Tag Standards|foobar2000 Encouraged Tag Standards]]
* [[foobar2000:Tips & Tricks|foobar2000 Tips & Tricks]]

===General Guides===

* [[foobar2000:Newbie User Guide|Newbie User Guide]]
* [[foobar2000:Intermediate User Guide|Intermediate User Guide]]
* [[foobar2000:Advanced User Guide|Advanced User Guide]]

===Specific Guides===

* [[foobar2000:Preferences|Preferences Dialog]]
* [[foobar2000:Titleformat Introduction|Introduction to titleformat scripts]]
* [[foobar2000:Titleformat Reference|Titleformat Reference]] - Quick-Reference for fields and functions
* [[foobar2000:Masstaggers User Guide|Masstagger]]
* [[foobar2000:Commandline Guide|Commandline Usage]]
* [[foobar2000:Increasing Performance|Increasing Performance]] - Tips

The following articles contain outdated information that does not apply to Foobar2000 v0.9:
* [[foobar2000:Tagz|Tagz (Simple Syntax)]]
* [[foobar2000:Tagscript|Tagscript (Script-like Syntax)]]

===External Guides===

* [http://eolindel.free.fr/foobar0.9/accueil.shtml Bachi-Bouzouk's guide] about 0.9.X version
* [http://foobar2000.audiohq.de/ Frank Bicking's German-language guide]
* [http://www.dizwell.com/html/foobar.htm Howard Rogers' Beginners' Configuration Guide]
* [http://shsc.info/foobar2000#titelanker2 SH/SC New user guide]
* [http://www.techspot.com/tweaks/foobar/ TechSpot's "complete guide to Foobar 2000"]
* [http://eolindel.free.fr/foobar/ Bachi-Bouzouk's guide] about 0.8.3 version

==Important Links==

===Official Site===

* [http://www.foobar2000.org foobar2000.org: Homepage]
* [http://www.foobar2000.org foobar2000.org: Download]
* [http://www.foobar2000.org/requirements.html foobar2000.org: Requirements]

===Community===

* [http://www.hydrogenaudio.org/forums/index.php?showforum=28 Official foobar2000 forum]
* [http://www.fforum.ru/index.php?showforum=59 Russian-language forum]
* [http://www.foobar.prv.pl/ Polish-language forum]
* [http://foobar2000.fo.funpic.de/ German Support Forum]

===Appearance===

* [[Foobar2000:Preferences:Columns UI/Appearance|Appearance]] Guides to customizing the look of your Foobar2000
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=43077 Foobar Gallery 0.9]: screenshot thread
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=30988 Foobar Gallery 0.8]: 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.hydrogenaudio.org/forums/index.php?showtopic=30281 foo_ui_gfx (alpha)]: skin support for foobar 0.8.x
* [http://tagz.brother-john.net/ Brother John's Foobar2000 Scripting Tutorial]

==Thanks==

picmixer: ReplayGain tutorial

[[Category: foobar2000]]

Foobar2000 Talk:Title Formatting Reference

2006-05-15T04:56:58Z

Reglib: /* Metadata */

is there a way to change the field remappings? for instance, i want to make use of the MB-supplied ORIGYEAR field when possible for the %DATE% field.. --[[User:Herr klang|Herr klang]] 15:33, 12 Jun 2005 (CDT)

IMO, this page is too complicated and too long. Suggest a table formatted version. See titleformat_help.html in your foobar program directory. Perhaps this page should exist as an expanded version to be consistent? --[[User:Reglib|Reglib]] 02:01, 3 May 2006 (CDT)

= Generic Fields =
== Metadata ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %album artist%
| Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.
|-
! %album%
| Defined as ''$if3($meta(album),$meta(venue))''.
|-
! %artist%
| Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.
|-
! %disc%
%discnumber%
| Returns the disc number. The disc number is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.
|-
! %subsong%
|
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
|-
! %title%
| Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.
|-
! %track artist%
| Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.
|-
! %track%
%tracknumber%
| Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.
|}

== Technical information ==
{| border=1 cellspacing=0 cellpadding=2 style=""
! %bitrate%
| Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.
|-
! %channels%
| Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".
|-
! %filesize%
| Defined as ''%_filesize%''. Returns the filesize in bytes.
|-
! %samplerate%
| Defined as ''$info(samplerate)''. Returns the samplerate in Hz.
|-
! %codec%
| Defined as ''$codec()''.
|}

= Context-specific fields =
== Now playing info ==
The following functions and fields are only usable for scripts used with the currently playing item, ie: the status bar, the main window title, and the copy command script.

{| border=1 cellspacing=0 cellpadding=2
! %playback_time%
| Returns the elapsed time formatted as [HH:]MM:SS.
|-
! %playback_time_seconds%
%_time_elapsed%
| Returns elapsed time in seconds.
|-
! %playback_time_remaining%
%_time_remaining%
| Returns remaining time until track ends, formatted as [HH:]MM:SS.
|-
! %playback_time_remaining_seconds%
%_time_remaining_seconds%
| Returns remaining time in seconds.
|-
! %length%
%_time_total%
| Returns the length of the track formatted as hours, minutes, and seconds.
|-
! %length_ex%
| Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.
|-
! %length_seconds%
%_time_total_seconds%
| Returns the length of the track in seconds.
|-
! %length_seconds_fp%
| Returns the length of the track in seconds as floating point number.
|-
! %length_samples%
| Returns the length of the track in samples.
|}

== Playlist info ==
The following functions and fields are usable for playlist scripts such as masstagger.
{| border=1 cellspacing=0 cellpadding=2
! %isplaying%
%_isplaying%
| Returns "1" if file is currently playing and empty string otherwise.
|-
! %ispaused%
%_ispaused%
| Returns "1" if playback is paused, empty string otherwise.
|-
! %list_index%
%playlist_number%
%_playlist_number%
| Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns a zero-padded playlist index of specified item. The first item is at index 1.

|-
! %list_total%
%_playlist_total%
| Returns number of items in the playlist.
|-
! %playlist_name%
%_playlist_name%
| Returns the name of the playlist containing the specified item.
|}

= Functions =
== Control flow ==
The functions in this section can be used to conditionally execute statements.
{| border=1 cellspacing=0 cellpadding=2 style=""
! [...]
| Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''%artist%'' would return "?".
|-
! $if(cond,then)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.
|-
! $if(cond,then,else)
| If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.
|-
! $if2(a,else)
| Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.
|-
! $if3(a1,a2,...,aN,else)
| Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $ifgreater(n1,n2,then,else)
| Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $iflonger(s1,s2,then,else)
| Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.
|-
! $select(n,a1,...,aN)
| If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.
|}

== Arithmetic functions ==

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0
{| border=1 cellspacing=0 cellpadding=2
! $add(a,b)
| Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.
|-
! $div(a,b)
| Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.
|-
! $greater(a,b)
| Returns true, if ''a'' is greater than ''b'', otherwise false.
|-
! $max(a,b)
| Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.
|-
! $min(a,b)
| Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.
|-
! $mod(a,b)
| Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.
|-
! $mul(a,b)
| Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.
|-
! $muldiv(a,b,c)
| Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.
|-
! $rand()
| Generates a random number in the range from 0 to 232-1.
|-
! $sub(a,b)
| Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.
|}

== Boolean functions ==
The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.
{| border=1 cellspacing=0 cellpadding=2
! $and(...)
| Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.
|-
! $or(...)
| Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.
|-
! $not(x)
| Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.
|-
! $xor(...)
| Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.
|}

== Color functions ==
{| border=1 cellspacing=0 cellpadding=2
!$blend(color1,color2,part,total)
| Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.
|-
! $hsl()
| Resets the text color to the default color.
|-
! $hsl(h,s,l)
| Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.
|-
! $hsl(h1,s1,l1,h2,s2,l2)
| Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.
|-
! $rgb()
| Resets the text color to the default color.
|-
! $rgb(r,g,b)
| Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.
|-
! $rgb(r1,g1,b1,r2,g2,b2)
| Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.
|-
! $transition(string,color1,color2)
|Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.
|}

== String functions ==

The functions in this section can be used to manipulate character strings.
{| border=1 cellspacing=0 cellpadding=2
! $abbr(x)
| Returns abbreviation of ''x''.
|-
! $abbr(x,len)
| Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.
|-
! $ansi(x)
| Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.
|-
! $ascii(x)
| Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.
|-
! $caps(x)
| Converts first letter in every word of x to uppercase, and all other letters to lowercase.
|-
! $caps2(x)
| Converts first letter in every word of x to uppercase, and leaves all other letters as they are.
|-
! $char(x)
| Inserts Unicode character with code ''x''.
|-
! $crc32(a)
| Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)
|-
! $crlf()
| Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.
|-
! $cut(a,len)
| Returns first ''len'' characters on the left of ''a''.
|-
! $directory(x)
| Extracts directory name from the file path ''x''.
|-
! $directory(x,n)
| Extracts directory name from the file path ''x''; goes up by ''n'' levels.
|-
! $ext(x)
| Extracts file extension from ''x'' which must be a file name or path.
|-
! $filename(x)
| Extracts file name from full path.
|-
! $fix_eol(x)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.
|-
! $fix_eol(x,indicator)
| If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.
|-
! $hex(n)
| Formats the integer number ''n'' in hexadecimal notation.
|-
! $hex(n,len)
| Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $insert(a,b,n)
| Inserts ''b'' into ''a'' after ''n'' characters.
|-
! $left(a,len)
| Returns the first ''len'' characters from the left of ''a''.
|-
! $len(a)
| Returns length of string ''a'' in characters.
|-
! $len2(a)
| Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).
|-
! $longer(a,b)
| Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.
|-
! $lower(a)
| Converts ''a'' to lowercase.
|-
! $longest(a,...)
| Returns the longest of its arguments. Can be used with an arbitrary number of strings.
|-
! $num(n,len)
| Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.
|-
! $pad(x,len)
| Pads ''x'' from the left with spaces to ''len'' characters.
|-
! $pad_right(x,y)
| Pads ''x'' from the right with spaces to ''len'' characters.
|-
! $pad(x,len,char)
| Pads ''x'' from the left with ''char'' to ''len'' characters.
|-
! $pad_right(x,len,char)
| Pads ''x'' from the right with ''char'' to ''len'' characters.
|-
! $padcut(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.
|-
! $padcut_right(x,len)
| Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.
|-
! $progress(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.
|-
! $progress2(pos,range,len,a,b)
| Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.
|-
! $repeat(a,n)
| Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.
|-
! $replace(a,b,c)
| Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"
|-
! $right(a,len)
| Returns the first ''len'' characters from the right of ''a''.
|-
! $roman(n)
| Formats the integer number ''n'' in roman notation.
|-
! $rot13()
| Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".
|-
! $shortest
| Returns the shortest of its arguments. Can be used with an arbitrary number of strings.
|-
! $strchr(s,c)
| Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1
|-
! $strrchr(s,c)
| Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4
|-
! $strstr(s1,s2)
| Finds first occurence of string ''s2'' in string ''s1''.
|-
! $strcmp(s1,s2)
| Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.
|-
! $stricmp(s1,s2)
| Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.
|-
! $substr(s,m,n)
| Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.
|-
! $trim(s)
| Removes leading and trailing spaces from string ''s''.
|-
! $tab()
| Inserts one tabulator character.
|-
! $tab(n)
| Inserts ''n'' tabulator characters.
|-
! $upper(s)
| Converts string ''s'' to uppercase.
|}

== Track info ==

The functions and fields in this section can be used to access information about tracks.

=== Metadata ===
{| border=1 cellspacing=0 cellpadding=2
! $meta(name)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"
|-
! $meta(name,n)
| Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"
|-
! $meta_sep(name,sep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"
|-
! $meta_sep(name,sep,lastsep)
| Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"
|-
! $meta_test(...)
| Returns 1, if all given tags exist, undefined otherwise.

Example: ''$meta_test(artist,title)'' -> true
|-
! $meta_num(name)
| Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3
|-
! $tracknumber()
| Returns the tracknumber padded to 2 digits with zeroes.
|-
! $tracknumber(n)
| Returns the tracknumber padded to ''n'' digits with zeros.
|}

=== Technical information ===
{| border=1 cellspacing=0 cellpadding=2
! $info(name)
| Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2
|-
! $codec()
| Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"
|-
! $channels()
| Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"
|-
! %__replaygain_album_gain%
| Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.
|-
! %__replaygain_album_peak%
| Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.
|-
! %__replaygain_track_gain%
| Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.
|-
! %__replaygain_track_peak%
| Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.
|}

=== Special fields ===
{| border=1 cellspacing=0 cellpadding=2
! $extra(name)
| Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
|-
! %filename%
|
Returns the filename without directory and extension.
|-
! %filename_ext%
|
Returns the filename with extension, but without the directory.
|-
! %directoryname%
|
Returns the name of the parent directory only, not the complete path.
|-
! %lastmodified%
|
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
|-
! %path%
|
Returns the path.
|-
! %path_raw%
|
Returns the path as URL including the protocol scheme.
|-
! $extra(foobar2000_version)
|
Returns a string representing the version of foobar2000.
|}

Foobar2000:Title Formatting Reference

2006-05-15T04:55:52Z

Reglib: /* $meta_test(...) */

This article contains information about built-in titleformatting functions and field references with special meaning. References to documentation about fields and function which can only be used in specific components or which are provided by specific components can be found at the end of this article.

A field reference is a field name enclosed in percent signs, for example ''%artist%''. A function call starts with a dollar sign, followed by the function name and the parameter list. A parameter list can either be empty - denoted as ''()'' - or contain one or more parameters separated by commata, for example ''$abbr(%artist%)''. Note that there must be no whitespace between the dollar sign and the function name, or the function name and the opening parenthesis of the parameter list.

Please see [[Foobar2000:Titleformat_Introduction|Titleformat Introduction]] for a presentation of titleformat syntax in general.

= Field remappings =

Some of the fields accessible through ''%name%'' are remapped to other values to make writing titleformat scripts more convenient.

== Metadata ==

=== %album artist% ===
Defined as ''$if3($meta(album artist),$meta(artist),$meta(composer),$meta(performer))''.

=== %album% ===
Defined as ''$if3($meta(album),$meta(venue))''.

=== %artist% ===
Defined as ''$if3($meta(artist),$meta(album artist),$meta(composer),$meta(performer))''.

=== %disc% ===
Returns the discnumber. The discnumber is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.

This is equivalent to the %discnumber% remapping.

=== %discnumber% ===
Returns the discnumber. The discnumber is taken from the discnumber tag; if that does not exist, it is taken from the disc tag. If neither exist, the field is undefined.

This is equivalent to the %disc% remapping.

=== %track artist% ===
Defined as ''$meta(artist)'', if ''$meta(album artist)'' is different than ''$meta(artist)'', otherwise this field is empty.

=== %title% ===
Defined as ''$if2($meta(title),%_filename%)''. Returns the ''title'' tag if available, otherwise it returns the filename excluding the extension.

=== %track% ===
Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.

This is equivalent to the %tracknumber% remapping.

=== %tracknumber% ===
Returns the tracknumber padded to two digits from the left with zeroes. The tracknumber is taken from the tracknumber tag; if that does not exist, it is taken from the track tag. If neither exist, this field is undefined.

This is equivalent to the %track% remapping.

== Technical information ==

=== %bitrate% ===
Defined as ''$if2($info(bitrate_dynamic),$info(bitrate))''. Returns the current bitrate, if available, otherwise it returns the average bitrate. If neither is available, nothing is returned.

=== %channels% ===
Defined as ''$channels()''. Returns the number of channels in text form; returns "mono" and "stereo" instead of "1" and "2".

=== %filesize% ===
Defined as ''%_filesize%''. Returns the filesize in bytes.

=== %samplerate% ===
Defined as ''$info(samplerate)''. Returns the samplerate in Hz.

=== %codec% ===
Defined as ''$codec()''.

== Special fields ==

=== %playlist_number% ===
Defined as ''$num(%_playlist_number%,$len(%_playlist_total%))''. Returns the position of the track as index into the playlist. The first track has index 1. The index is padded from the left with zeroes to the same number of digits as the last track.

= Control flow =

The functions in this section can be used to conditionally execute statements.

=== [...] (conditional section) ===

Evaluates the expression between ''['' and '']''. If it has the truth value ''true'', its string value and the truth value ''true'' are returned. Otherwise an empty string and ''false'' are returned.

Example: ''[%artist%]'' returns the value of the artist tag, if it exists. Otherwise it returns nothing, when ''artist'' would return "?".

=== $if(cond,then) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, ''false'' is returned.

=== $if(cond,then,else) ===

If ''cond'' evaluates to ''true'', the ''then'' part is evaluated and its value returned. Otherwise, the ''else'' part is evaluated and its value returned.

=== $if2(a,else) ===

Like ''$if(a,a,else)'' except that ''a'' is only evaluated once.

=== $if3(a1,a2,...,aN,else) ===

Evaluates arguments ''a1'' ... ''aN'', until one is found that evaluates to ''true''. If that happens, its value is returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $ifgreater(n1,n2,then,else) ===

Compares the integer numbers ''n1'' and ''n2'', if ''n1'' is greater than ''n2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $iflonger(s1,s2,then,else) ===

Compares the length of the strings ''s1'' and ''s2'', if ''s1'' is longer than ''s2'', the ''then'' part is evaluated and its value returned. Otherwise the ''else'' part is evaluated and its value returned.

=== $select(n,a1,...,aN) ===

If the value of ''n'' is between 1 and N, ''an'' is evaluated and its value returned. Otherwise ''false'' is returned.

= Arithmetic functions =

The functions in this section can be used to perform arithmetic on integer numbers. A string will be automatically converted to a number and vice versa. The conversion to a number uses the longest prefix of the string, that can be interpreted as number. Leading whitespace is ignored.

Example: "c3po" -> 0, " -12" -> -12, but "- 12" -> 0

=== $add(a,b) ===

Adds ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$add(a,b,...)'' is the same as ''$add($add(a,b),...)''.

=== $div(a,b) ===

Divides ''a'' through ''b''. If ''b'' evaluates to zero, it returns ''a''.

Can be used with an arbitrary number of arguments. ''$div(a,b,...)'' is the same as ''$div($div(a,b),...)''.

=== $greater(a,b) ===

Returns true, if ''a'' is greater than ''b'', otherwise false.

=== $max(a,b) ===

Returns the maximum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$max(a,b,...)'' is the same as ''$max($max(a,b),...)''.

=== $min(a,b) ===

Returns the minimum of ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$min(a,b,...)'' is the same as ''$min($min(a,b),...)''.

=== $mod(a,b) ===

Computes the remainder of dividing ''a'' through ''b''. The result has the same sign as ''a''. If ''b'' evaluates to zero, the result is ''a''.

Can be used with an arbitrary number of arguments. ''$mod(a,b,...)'' is the same as ''$mod($mod(a,b),...)''.

=== $mul(a,b) ===

Multiplies ''a'' and ''b''.

Can be used with an arbitrary number of arguments. ''$mul(a,b,...)'' is the same as ''$mul($mul(a,b),...)''.

=== $muldiv(a,b,c) ===

Multiplies ''a'' and ''b'', then divides by ''c''. The result is rounded to the nearest integer.

=== $rand() ===

Generates a random number in the range from 0 to 232-1.

=== $sub(a,b) ===

Subtracts ''b'' from ''a''.

Can be used with an arbitrary number of arguments. ''$sub(a,b,...)'' is the same as ''$sub($sub(a,b),...)''.

= Boolean functions =

The functions in this section can be used to work with truth values (''true'' and ''false''), which have no explicit representation in titleformat scripts. They do not return a string or number value. You can use them for more complex conditions with ''$if'' and related functions.

=== $and(...) ===

Logical And of an arbitrary number of arguments. Returns ''true'', if and only if all arguments evaluate to ''true''.

Special case: ''$and(x,y)'' is ''true'', if both ''x'' and ''y'' are ''true''. Otherwise it is ''false''.

=== $or(...) ===

Logical Or of an arbitrary number of arguments. Returns ''true'', if at least one argument evaluates to ''true''.

Special case: ''$or(x,y)'' is ''true'', if ''x'' or ''y'' is ''true'', or if both are ''true''. Otherwise it is ''false''.

=== $not(x) ===

Logical Not. Returns ''false'', if ''x'' is ''true'', otherwise it returns ''true''.

=== $xor(...) ===

Logical Exclusive-or of an arbitrary number of arguments. Returns ''true'', if an odd number of arguments evaluate to ''true''.

Special case: ''$xor(x,y)'' is ''true'', if one of ''x'' and ''y'' is ''true'', but not both. Otherwise it is ''false''.

= Color functions =

=== $blend(color1,color2,part,total) ===

Returns a color that is a blend between ''color1'' and ''color2''. If ''part'' is smaller than or equal to zero, ''color1'' is returned. If ''part'' is greater than or equal to ''total'', ''color2'' is returned. Otherwise a blended color is returned that is ''part'' parts ''color1'' and ''total''-''part'' parts ''color2''. The blending is performed in the RGB color space.

=== $hsl() ===

Resets the text color to the default color.

=== $hsl(h,s,l) ===

Sets the color for text in the HSL color space. ''h'', ''s'' and ''l'' are the hue, saturation, and lightness of the color for unselected text. The color for selected text is set to the inverse color.
The ranges of ''h'', ''s'', and ''l'' are from 0 to 240; the function is designed to interpret those values in the same way as the standard Windows color dialog.

=== $hsl(h1,s1,l1,h2,s2,l2) ===

Sets the color for text in the HSL color space. ''h1'', ''s1'' and ''l1'' are the hue, saturation, and lightness of the color for unselected text. ''h2'', ''s2'' and ''l2'' are the hue, saturation, and lightness of the color for selected text.

=== $rgb() ===

Resets the text color to the default color.

=== $rgb(r,g,b) ===

Sets the color for text. ''r'', ''g'' and ''b'' are the red, green and blue component of the color for unselected text. The color for selected text is set to the inverse color.

=== $rgb(r1,g1,b1,r2,g2,b2) ===

Sets the color for text. ''r1'', ''g1'' and ''b1'' are the red, green and blue component of the color for unselected text. ''r2'', ''g2'' and ''b2'' are the red, green and blue component of the color for selected text.

=== $transition(string,color1,color2) ===

Inserts color codes into ''string'', so that the first character has ''color1'', the last character has ''color2'', and intermediate characters have blended colors. The blending is performed in the RGB color space. Note that color codes are additional characters that will also be counted by string manipulation functions. For example, if you need to truncate a string, you should do this before applying ''$transition''.

= Now playing info =
The following functions and fields are usable for scripts used with the currently playing item, for example the status bar, the main window title and the copy command script.

== Special fields ==

=== %playback_time% ===
Returns the elapsed time formatted as [HH:]MM:SS.

=== %playback_time_seconds% ===
Returns elapsed time in seconds.
Old version: <code>%_time_elapsed%</code>

=== %playback_time_remaining% ===
Returns remaining time until track ends, formatted as [HH:]MM:SS.
Old version: <code>%_time_remaining%</code>

=== %playback_time_remaining_seconds% ===
Returns remaining time in seconds.
Old version: <code>%_time_remaining_seconds%</code>

=== %length% ===
Returns the length of the track formatted as hours, minutes, and seconds.
Old version: <code>%_time_total%</code>

=== %length_ex% ===
Returns the length of the track formatted as hours, minutes, seconds, and milliseconds.

=== %length_seconds% ===
Returns the length of the track in seconds.
Old version: <code>%_time_total_seconds%</code>

=== %length_seconds_fp% ===
Returns the length of the track in seconds as floating point number.

=== %length_samples% ===
Returns the length of the track in samples.

= Playlist info =
The following functions and fields are usable for playlist scripts such as masstagger.

== Special fields ==

=== %isplaying% ===

Returns "1" if file is currently playing and empty string otherwise.

The old version <code>%_isplaying%</code> still works.

=== %ispaused% ===

Returns "1" if playback is paused, empty string otherwise.

The old version <code>%_ispaused%</code> still works.

=== %list_index% ===

Returns a zero-padded playlist index of specified item. The first item is at index 1.

Also see [[Foobar2000:Titleformat Reference#%playlist_number%|%playlist_number%]].

The old version <code>%_playlist_number%</code> still works.

=== %list_total% ===

Returns number of items in the playlist.

The old version <code>%_playlist_total%</code> still works.

=== %playlist_name% ===

Returns the name of the playlist containing the specified item.

The old version <code>%_playlist_name%</code> still works.

= String functions =

The functions in this section can be used to manipulate character strings.

=== $abbr(x) ===

Returns abbreviation of ''x''.

=== $abbr(x,len) ===

Returns abbreviation of ''x'', if ''x'' is longer than ''len'' characters, otherwise returns ''x''.

=== $ansi(x) ===

Converts ''x'' to system codepage and back. Any characters that are not present in the system codepage will be removed / replaced. Useful for mass-renaming files to ensure compatibility with non-unicode-capable software.

=== $ascii(x) ===

Converts ''x'' to ASCII. Any characters that are not present in ASCII will be removed / replaced.

=== $caps(x) ===

Converts first letter in every word of x to uppercase, and all other letters to lowercase.

=== $caps2(x) ===

Converts first letter in every word of x to uppercase, and leaves all other letters as they are.

=== $char(x) ===

Inserts Unicode character with code ''x''.

=== $crc32(a) ===

Computes the CRC32 of the string ''a'' as a number. Intended for use in coloring scripts.

Example: $rgb($mod($crc32(%album%),256),128,128)

=== $crlf() ===

Inserts end-of-line marker (carriage return, line feed). Can be used to generate multiple lines in the output, for example for the tooltip of the system notification area ("systray") icon.

=== $cut(a,len) ===

Returns first ''len'' characters on the left of ''a''.

=== $directory(x) ===

Extracts directory name from the file path ''x''.

=== $directory(x,n) ===

Extracts directory name from the file path ''x''; goes up by ''n'' levels.

=== $ext(x) ===

Extracts file extension from ''x'' which must be a file name or path.

=== $filename(x) ===

Extracts file name from full path.

=== $fix_eol(x) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by " (...)". Otherwise ''x'' is returned unaltered.

=== $fix_eol(x,indicator) ===

If ''x'' contains an end-of-line marker (CR-LF), the end-of-line marker and all text to the right of it is replaced by ''indicator''. Otherwise ''x'' is returned unaltered.

=== $hex(n) ===

Formats the integer number ''n'' in hexadecimal notation.

=== $hex(n,len) ===

Formats the integer number ''n'' in hexadecimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $insert(a,b,n) ===

Inserts ''b'' into ''a'' after ''n'' characters.

=== $left(a,len) ===

Returns the first ''len'' characters from the left of ''a''.

=== $len(a) ===

Returns length of string ''a'' in characters.

=== $len2(a) ===

Returns length of string x in characters, respecting double-width character rules (double-width characters will be counted as two).

=== $longer(a,b) ===

Returns ''true'', if string ''a'' is longer than string ''b'', false otherwise.

=== $lower(a) ===

Converts ''a'' to lowercase.

=== $longest(a,...) ===

Returns the longest of its arguments. Can be used with an arbitrary number of strings.

=== $num(n,len) ===

Formats the integer number ''n'' in decimal notation with ''len'' digits. Pads with zeros from the left if necessary.

=== $pad(x,len) ===

Pads ''x'' from the left with spaces to ''len'' characters.

=== $pad_right(x,y) ===

Pads ''x'' from the right with spaces to ''len'' characters.

=== $pad(x,len,char) ===

Pads ''x'' from the left with ''char'' to ''len'' characters.

=== $pad_right(x,len,char) ===

Pads ''x'' from the right with ''char'' to ''len'' characters.

=== $padcut(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the left with spaces to ''len'' characters.

=== $padcut_right(x,len) ===

Returns first ''len'' characters from the left of ''x'', if ''x'' is longer than ''len'' characters. Otherwise pads ''x'' from the right with spaces to ''len'' characters.

=== $progress(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with.

Example:''$progress(%_time_elapsed_seconds%, %_time_total_seconds%, 20,'#','=')'' produces "====#===============", the # character is moving with playback position.

=== $progress2(pos,range,len,a,b) ===

Creates a progress bar: ''pos'' contains position, ''range'' contains range, ''len'' progress bar length in characters, ''a'' and ''b'' are characters to build progress bar with. Produces different appearance than ''$progress''.

=== $repeat(a,n) ===

Returns ''n'' copies of ''a''. Note that ''a'' is evaluated once before its value is used, so ''$repeat'' cannot be used for loops.

=== $replace(a,b,c) ===

Replaces all occurrences of string ''b'' in string ''a'' with string ''c''.

Can also be used with an arbitrary number of arguments. Note that ''$replace(a,b1,c1,b2,c2)'' is generally not the same as ''$replace($replace(a,b1,c1),b2,c2)''.

Example: ''$replace(ab,a,b,b,c)'' -> "bc", ''$replace($replace(ab,a,b),b,c)'' -> "cc"

=== $right(a,len) ===

Returns the first ''len'' characters from the right of ''a''.

=== $roman(n) ===

Formats the integer number ''n'' in roman notation.

=== $rot13() ===

Performs [http://en.wikipedia.org/wiki/ROT13 ROT13] transformation to given string.

Example: ''$rot13('foobar2000')'' -> "sbbone2000".

=== $shortest ===

Returns the shortest of its arguments. Can be used with an arbitrary number of strings.

=== $strchr(s,c) ===

Finds first occurence of character ''c'' in string ''s''.

Example: ''$strchr(abca,a)'' -> 1

=== $strrchr(s,c) ===

Finds last occurence of character ''c'' in string ''s''.

Example: ''$strrchr(abca,a)'' -> 4

=== $strstr(s1,s2) ===

Finds first occurence of string ''s2'' in string ''s1''.

=== $strcmp(s1,s2) ===

Performs a case-sensitive comparison of the strings ''s1'' and ''s2''.

=== $stricmp(s1,s2) ===

Performs a case-insensitive comparison of the strings ''s1'' and ''s2''.

=== $substr(s,m,n) ===

Returns substring of string ''s'', starting from ''m''-th character and ending at ''n''-th character.

=== $trim(s) ===

Removes leading and trailing spaces from string ''s''.

=== $tab() ===

Inserts one tabulator character.

=== $tab(n) ===

Inserts ''n'' tabulator characters.

=== $upper(s) ===

Converts string ''s'' to uppercase.

= Track info =

The functions and fields in this section can be used to access information about tracks.

== Metadata ==

=== $meta(name) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ", " as separator.

Example: ''$meta(artist)'' -> "He, She, It"

=== $meta(name,n) ===
Returns value of ''n''-th tag called ''name''.

Example: ''$meta(artist,2)'' -> "She"

=== $meta_sep(name,sep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator.

Example: ''$meta_sep(artist,' + ')'' -> "He + She + It"

=== $meta_sep(name,sep,lastsep) ===
Returns value of tag called ''name''. If multiple values of that tag exist, they are concatenated with ''sep'' as separator between all but the last two values which are concatenated with ''lastsep''.

Example: ''$metasep(artist,', ',', and ')'' -> "He, She, and It"

=== $meta_test(...) ===
Returns ''1'', if all given tags exist, ''undefined'' otherwise.

Example: ''$meta_test(artist,title)'' -> true

=== $meta_num(name) ===
Returns the number of values for the tag called ''name''.

Example: ''$meta_num(artist)'' -> 3

=== $tracknumber() ===
Returns the tracknumber padded to 2 digits with zeroes.

=== $tracknumber(n) ===
Returns the tracknumber padded to ''n'' digits with zeros.

== Technical information ==

=== $info(name) ===
Returns value of technical information field called ''name''.

Example: ''$info(channels)'' -> 2

=== $codec() ===
Returns codec of track. If no codec field is present, it the uses file extension.

Example: ''$codec()'' -> "WavPack"

=== $channels() ===
Returns number of channels in text format.

Example: ''$channels()'' -> "stereo"

=== %__replaygain_album_gain% ===
Returns ReplayGain album gain value. //Not available through// ''$info(replaygain_album_gain)''.

=== %__replaygain_album_peak% ===
Returns ReplayGain album peak value. //Not available through// ''$info(replaygain_album_peak)''.

=== %__replaygain_track_gain% ===
Returns ReplayGain track gain value. //Not available through// ''$info(replaygain_track_gain)''.

=== %__replaygain_track_peak% ===
Returns ReplayGain track peak value. //Not available through// ''$info(replaygain_track_peak)''.

== Special fields ==

=== $extra(name) ===
Returns the value of the special field called ''name''. These fields can also be accessed as ''%_name%''; note the additional underscore. This syntax is from an older version of Foobar2000 {{Foobar2000v08}}. The following fields can be used normally.
==== %filename% ====
Returns the filename without directory and extension.
==== %filename_ext% ====
Returns the filename with extension, but without the directory.
==== %directoryname% ====
Returns the name of the parent directory only, not the complete path.
==== %lastmodified% ====
Returns the date and time the file was last modified. Eg: ''2005-12-22 00:04:10''
==== %path% ====
Returns the path.
==== %path_raw% ====
Returns the path as URL including the protocol scheme.
==== %subsong% ====
Returns the subsong index. The subsong index is used to distuingish multiple tracks in a single file, for example for cue sheets, tracker modules and various container formats.
==== $extra(foobar2000_version) ====
Returns a string representing the version of foobar2000.

= Variable operations =

Variables can be used to store strings and number. They cannot store truth values. They are best used to store intermediate results that you need multiple times. Variable names are not case-sensitive.

For example:
{| border="0" cellspacing="0" cellpadding="2"
! code
! output
|-
|<pre>$put(foo,bar)$char(10)
$get(foo)$char(10)
$get(Foo)$char(10)
$puts(foo,2000)$char(10)
$get(foo)$char(10)</pre>
| style="background-color:#EEF" |<pre>bar
bar
bar

2000</pre>
|}
=== $get(name) ===

Returns the value that was last stored in the variable ''name'', if the variable was not defined (yet), it returns nothing. The truth value returned by ''$get'' indicates if the variable ''name'' was defined

=== $put(name,value) ===

Stores ''value'' in the variable ''name'' and returns ''value'' unaltered

=== $puts(name,value) ===

Stores ''value'' in the variable ''name'' and returns nothing

= Component-provided fields and functions on tracks =

This section lists components that provide additional fields and functions that are useable in the context of any track.

== Playback statistics ==

* [http://www.foobar2000.org/beta/components.html Playback statistics homepage]
* [[Foobar2000:Titleformat Playback Statistics|Playback statistics titleformat reference]]

= Component-specific fields and functions =

This section lists components that provide additional fields and functions that are only useable in the context of the particular component.

== Album list ==

The official album list component supports creating multiple tree entries using special commands.

* [http://www.foobar2000.org/ Album list homepage]
* [[Foobar2000:Titleformat Album List|Album list titleformat reference]]

== Columns UI ==

* [http://music.morbo.org/wiki/columns_ui:manual Columns UI homepage]
* [http://music.morbo.org/wiki/columns_ui:config:global_variables Global variables reference]
* [http://music.morbo.org/wiki/columns_ui:config:colour_string Playlist colors reference]
* [http://music.morbo.org/wiki/columns_ui:config:playlist_switcher_titleformatting Playlist switcher reference]

= Related articles =

* [[Foobar2000:Titleformat_Introduction|Introduction to titleformat scripts]]