A tiny Foobar 2000 controller for Windows that can sit above other applications in borderless-fullscreen mode.
- Distraction-free operation, a mere 187x40 pixels with optional transparency
- Maintains top-most focus, visible when using other applications including borderless-fullscreen games
- Album artwork display
- Common Foobar 2000 controls
- Customisable colours
The most recent release is 0.1.0
. A binary is provided on the releases page.
- Close Foobar 2000 before installing the COM automation plugin.
- Install the Foobar 2000 COM automation plugin.
- Launch Foobar 2000.
- Extract the latest release zip.
- Run the executable
FoobarMiniplayer.exe
.
Please refer to this diagram and the bullet points.
- Current album artwork. Left-click to focus Foobar 2000, right-click to close Foobar Miniplayer.
- Shuffle button. Left-click to select a random track, this does not affect your playlist order.
- Previous track button. Left-click to play the previous track in the playlist.
- Play/Pause button. Left-click to toggle playing/paused state.
- Next track button. Left-click to skip to the next track in the playlist.
- Volume slider. Scroll or drag the bar to adjust the volume.
- Current artist/song marquee.
- Holding middle mouse and dragging moves the player, the chosen position will be recalled at startup.
- Ctrl + C copies the current track information to your clipboard.
Foobar 2000 Mini-Player can be configured by editting the file config.conf
.
Restart the program to apply your changes. The configuration options are of the
form option=value
. The following options are available.
The player's background colour. Must be hex notation with a leading #
. A colour picker can help you find the hex notation for your desired colour. e.g. col_bg=#1b1b1b
The colour used for the player's buttons and text. Must be hex notation with a leading #
. e.g. col_fg=#ef810b
The player's transparency level, where 1.0
is opaque and 0.0
is completely transparent e.g. alpha=0.8
Setting this value to 1
will prefer external over internal album artwork when both exist. e.g. prefer_external=1
The on-screen location of the player upon launch. e.g. position=400,600
.
The following need to be installed before running the program from source.
- Python3
- Git
- Foobar 2000
- Foobar 2000 COM automation plugin (close Foobar 2000 before running the installer)
command
denotes commands to be ran in git-bash.
- Launch git-bash
- Get the source code -
git clone https://github.com/th3-z/fb2k-mini-player.git
cd fb2k-mini-player
- Install the Python requirements
pip install -r requirements.tx
- Launch Foobar 2000
- Run
python FoobarMiniplayer.py
After a successfully running the program it can be build with the command
python setup.py build
.