A modern, high-performance Jellyfin music client for the PlayStation 2. With MP3 streaming, and automatic server synchronization.
The application looks for a settings.ini file in the same directory as the executable (or host: during development). This file allows you to configure your server connection without recompiling.
[Jellyfin]
SERVER_ADDRESS=192.168.1.100
SERVER_PORT=8096
SERVER_USERNAME=YourUser
SERVER_PASSWORD=YourPassword
# Token is managed automatically after the first login
SERVER_SESSION_TOKEN=....
SERVER_SESSION_USERID=...- Host: The IP address of your Jellyfin server.
- Port: Usually
8096(default). - Username/Password: Your Jellyfin credentials.
- Tokens: Leave empty for the first run; the app will authenticate and save the session token automatically to the Memory Card (
mc0:/JELLYFISH/config.bin) or update the INI.
Jellyfish uses a Dockerized PS2DEV toolchain to ensure build consistency across environments.
- Docker Desktop installed and running.
Use the provided build.bat script in the root directory:
-
Build everything:
.\build.bat all
(The first run will download the toolchain image, approx. 800MB. Subsequent builds are near-instant.)
-
Clean project:
.\build.bat clean
-
Rebuild from scratch:
.\build.bat rebuild
The output binary will be located at jellyfish.elf.
| Button | Action |
|---|---|
| D-Pad Up/Down | Navigate through lists |
| Cross (X) | Select item / Play track |
| Circle (O) | Go back / Cancel |
| L1 / R1 | (To-do) Previous / Next track |
| Start | (To-do) Toggle Player Bar visibility |
| Select | (To-do) Re-sync library |
To run Jellyfish on real hardware or PCSX2, you need the following files in your application folder:
jellyfish.elf(The main application)settings.ini(Your configuration)- Required Modules (IRX):
audsrv.irx(Audio server)smap.irx(Network driver)ps2ip.irx(TCP/IP stack)netman.irx(Network manager)
Copy all files to mc0:/APPS/Jellyfish/ and launch the ELF from there.
- MP3 Only: High-bitrate MP3s (up to 320kbps) are supported. Other formats are automatically transcoded by Jellyfin.
- Wired Connection: An Ethernet connection (Network Adapter) is highly recommended for stable streaming.
- Album Art: Currently disabled to preserve VRAM for the high-resolution font engine.
MIT License - Feel free to use and modify!