|
| 1 | +# MD+ Audio Player for foobar2000 |
| 2 | + |
| 3 | +Seamless loop playback support for MD+ compatible CUE sheets in foobar2000. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +- Seamless audio looping at specified loop points |
| 8 | +- Support for REM LOOP and REM NOLOOP commands |
| 9 | +- Compatible with WAV and OGG files (included because OGG is compatible with emulators such as Genesis Plus GX) |
| 10 | +- Works alongside standard CUE file handling |
| 11 | + |
| 12 | +## Installation |
| 13 | + |
| 14 | +1. Download the appropriate DLL for your foobar2000 version: |
| 15 | + - **32-bit (x86)** (v1.x): [foo_mdplus.dll (x86)](../../releases/latest/download/foo_mdplus_x86.dll) |
| 16 | + - **64-bit (x64)** (v2.x): [foo_mdplus.dll (x64)](../../releases/latest/download/foo_mdplus_x64.dll) |
| 17 | + |
| 18 | +2. Copy the DLL to your foobar2000 components folder: |
| 19 | + - Usually (for v1.x): `C:\Program Files (x86)\foobar2000\components\` |
| 20 | + - (for v2.x): `C:\Program Files\foobar2000\components\` |
| 21 | + - Or: `%APPDATA%\foobar2000\user-components\` |
| 22 | + |
| 23 | +3. Restart foobar2000 |
| 24 | + |
| 25 | +## Usage |
| 26 | + |
| 27 | +1. Rename your MD+ CUE files from `.cue` to `.mdpcue` |
| 28 | + - Example: `game_name.cue` -> `game_name.mdpcue` |
| 29 | + |
| 30 | +2. Add the `.mdpcue` file to foobar2000 |
| 31 | + |
| 32 | +3. Tracks with `REM LOOP` will loop seamlessly and indefinitely at the specified value in the CUE file |
| 33 | + - Tracks with `REM NOLOOP` play once and continue to next track |
| 34 | + |
| 35 | +## Example MD+ CUE File Format |
| 36 | + |
| 37 | +```cue |
| 38 | +FILE "01-Track.wav" WAVE |
| 39 | + TRACK 01 AUDIO |
| 40 | + INDEX 01 00:00:00 |
| 41 | + REM LOOP 12345 |
| 42 | + |
| 43 | +FILE "02-Track.wav" WAVE |
| 44 | + TRACK 02 AUDIO |
| 45 | + INDEX 01 00:00:00 |
| 46 | + REM NOLOOP |
| 47 | +``` |
| 48 | + |
| 49 | +## Building from Source |
| 50 | + |
| 51 | +### Requirements |
| 52 | +- Visual Studio 2022 |
| 53 | +- foobar2000 SDK (2025-03-07 or later) |
| 54 | + |
| 55 | +### Steps |
| 56 | +1. Clone this repository |
| 57 | +2. Download the foobar2000 SDK and extract to `foobar2000_SDK/` folder |
| 58 | +3. Open `foo_mdplus.sln` in Visual Studio |
| 59 | +4. Select platform: **x86** or **x64** |
| 60 | +5. Build -> Build Solution |
| 61 | +6. DLL will be in `Debug/` or `Release/` folder |
| 62 | + |
| 63 | +## Credits |
| 64 | + |
| 65 | +- Author: Relikk (John Sheppard) |
| 66 | +- Version: 1.0 |
| 67 | +- License: MIT License |
| 68 | + |
| 69 | +## Support |
| 70 | + |
| 71 | +For issues or feature requests, please open an issue on GitHub. |
0 commit comments