{"id":20236879,"url":"https://github.com/th3-z/fb2k-miniplayer","last_synced_at":"2025-07-06T02:33:56.979Z","repository":{"id":119771694,"uuid":"210410894","full_name":"th3-z/fb2k-miniplayer","owner":"th3-z","description":":notes: A tiny Foobar 2000 controller that can sit above fullscreen applications — features current track, album artwork, volume and playback control","archived":false,"fork":false,"pushed_at":"2021-07-30T22:32:55.000Z","size":128,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T16:52:13.373Z","etag":null,"topics":["foobar2000","miniprogram","music-player"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/th3-z.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-23T17:13:04.000Z","updated_at":"2025-02-15T17:13:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c24fce7-e773-453f-949f-07b6ba85712a","html_url":"https://github.com/th3-z/fb2k-miniplayer","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th3-z%2Ffb2k-miniplayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th3-z%2Ffb2k-miniplayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th3-z%2Ffb2k-miniplayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/th3-z%2Ffb2k-miniplayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/th3-z","download_url":"https://codeload.github.com/th3-z/fb2k-miniplayer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248279684,"owners_count":21077408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["foobar2000","miniprogram","music-player"],"created_at":"2024-11-14T08:23:40.155Z","updated_at":"2025-04-10T19:11:23.179Z","avatar_url":"https://github.com/th3-z.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Foobar Miniplayer\n\n[![Downloads](https://img.shields.io/github/downloads/th3-z/fb2k-mini-player/total.svg)](https://img.shields.io/github/downloads/th3-z/fb2k-mini-player/total.svg)\n[![GitHub license](https://img.shields.io/github/license/th3-z/fb2k-mini-player)](https://github.com/th3-z/fb2k-mini-player/blob/master/LICENSE)\n\nA tiny Foobar 2000 controller for Windows that can sit above other applications\nin borderless-fullscreen mode.\n\n## Features\n\n* Distraction-free operation, a mere 187x40 pixels with optional transparency\n* Maintains top-most focus, visible when using other applications including borderless-fullscreen games\n* Album artwork display\n* Common Foobar 2000 controls\n* Customisable colours\n\n## Downloads\n\nThe most recent release is `0.1.0`. A binary is provided on the releases page.\n\n[Release 0.1.0](https://github.com/th3-z/fb2k-mini-player/releases/tag/0.1.0)\n\n## User guide\n\n### Installation\n\n1. **Close Foobar 2000 before installing the COM automation plugin**.\n2. Install the Foobar 2000\n   [COM automation plugin](https://hydrogenaud.io/index.php/topic,39946.0.html).\n2. Launch Foobar 2000.\n3. Extract the latest release zip.\n4. Run the executable `FoobarMiniplayer.exe`.\n\n### Usage\n\nPlease refer to this diagram and the bullet points.\n\n![Diagram of player](https://github.com/th3-z/fb2k-miniplayer/raw/master/.github/diagram.png)\n\n0. Current album artwork. Left-click to **focus Foobar 2000**, right-click to **close Foobar Miniplayer**.\n1. Shuffle button. Left-click to select a **random track**, this does not affect your playlist order.\n2. Previous track button. Left-click to play the **previous track** in the playlist.\n3. Play/Pause button. Left-click to **toggle playing/paused** state.\n4. Next track button. Left-click to skip to the **next track** in the playlist.\n5. Volume slider. Scroll or drag the bar to adjust the **volume**.\n6. Current artist/song marquee.\n\n* Holding middle mouse and dragging **moves the player**, the chosen position will be recalled at startup.\n* Ctrl + C copies the current track information to your clipboard.\n\n### Settings\n\nFoobar 2000 Mini-Player can be configured by editting the file `config.conf`.\nRestart the program to apply your changes. The configuration options are of the\nform `option=value`. The following options are available.\n\n#### `col_bg`\n\nThe player's background colour. Must be hex notation with a leading `#`. A [colour picker](https://duckduckgo.com/?q=colour+picker) can help you find the hex notation for your desired colour. e.g. `col_bg=#1b1b1b`\n\n#### `col_fg`\n\nThe colour used for the player's buttons and text. Must be hex notation with a leading `#`. e.g. `col_fg=#ef810b`\n\n#### `alpha` \n\nThe player's transparency level, where `1.0` is opaque and `0.0` is completely transparent e.g. `alpha=0.8`\n\n#### `prefer_external`\n\nSetting this value to `1` will prefer external over internal album artwork when both exist. e.g. `prefer_external=1`\n\n#### `position`\n\nThe on-screen location of the player upon launch. e.g. `position=400,600`.\n\n## Development\n\n### Requirements\n\nThe following need to be installed before running the program from source.\n\n* [Python3](https://www.python.org/downloads/)\n* [Git](https://git-scm.com/downloads)\n* [Foobar 2000](https://www.foobar2000.org/download)\n* Foobar 2000 [COM automation plugin](https://hydrogenaud.io/index.php/topic,39946.0.html)\n  (*close Foobar 2000 before running the installer*)\n\n### Running\n\n`command` denotes commands to be ran in git-bash.\n\n1. Launch git-bash\n2. Get the source code  -\n   `git clone https://github.com/th3-z/fb2k-mini-player.git`\n3. `cd fb2k-mini-player`\n4. Install the Python requirements `pip install -r requirements.tx`\n5. Launch Foobar 2000\n6. Run `python FoobarMiniplayer.py`\n\n### Building\n\nAfter a successfully running the program it can be build with the command\n`python setup.py build`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fth3-z%2Ffb2k-miniplayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fth3-z%2Ffb2k-miniplayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fth3-z%2Ffb2k-miniplayer/lists"}