pico-pixel-player

pico-pixel-player/README.md
README.md
⎇
Raw

Pico Pixel Player icon

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

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