Pico Pixel Player

Pico Pixel Player is a lightweight, self-hostable audio player with an ElysiaJS backend and SolidJS frontend. It lets you play audio files directly from your server with a clean, responsive UI.

Features

• Lightweight: Minimal dependencies, fast performance
• Easy Setup: Configure with just a .env file.
• Responsive UI: Works seamlessly on desktop and mobile
• Offline Capable: Progressive Web App (PWA) support and local caching of files
• Transcoding: Optionally transcode files at a selected bitrate to your client, so you can listen to your .flac files on the go without using up all your data
• Directory Listing: Browse and play files directly from your server

Screenshot

Setup

1. Clone the repository:

git clone <repository-url>
cd pico-pixel-player

1. Configure .env:

HOST_PORT=1234
MUSIC_ROOT=/path/to/your/music

1. Start the service:

docker-compose up  # or podman-compose up

Important Notes

• No Authentication: The app has no built-in auth. Run it behind a proxy with basic auth for security.

Non-Goals

• Metadata-Based Views: No support for filtering by genre, artist, etc. Use other projects for this.

Attributions

• Font: https://github.com/TakWolf/ark-pixel-font
• Icons: https://github.com/hackernoon/pixel-icon-library
• Logo: https://github.com/halfmage/pixelarticons