a5fe3be9fd
Bumps the npm_and_yarn group with 1 update: [@eslint/plugin-kit](https://github.com/eslint/rewrite/tree/HEAD/packages/plugin-kit). Updates `@eslint/plugin-kit` from 0.3.3 to 0.3.4 - [Release notes](https://github.com/eslint/rewrite/releases) - [Changelog](https://github.com/eslint/rewrite/blob/main/packages/plugin-kit/CHANGELOG.md) - [Commits](https://github.com/eslint/rewrite/commits/plugin-kit-v0.3.4/packages/plugin-kit) --- updated-dependencies: - dependency-name: "@eslint/plugin-kit" dependency-version: 0.3.4 dependency-type: indirect dependency-group: npm_and_yarn ... Signed-off-by: dependabot[bot] <support@github.com>
Mice | Navidrome Client
Project based on shadcn/ui's music template.
This is a "Modern" Navidrome (or Subsonic) client built with Next.js and shadcn/ui. It creates a beautiful, responsive music streaming web application that connects to your Navidrome server, and fully able to self-host.
Features
- Real Music Streaming via Navidrome/Subsonic API
- Modern UI with shadcn/ui components
- Dynamic Album Artwork from your music library
- Favorites - Star albums, artists, and songs
- Search - Find music across your entire library
- Audio Player with queue management
- Scrobbling - Track your listening history
Preview
Quick Start
Prerequisites
- Navidrome server running
- Node.js 18+
Setup
- Clone and install the required dependencies
git clone https://github.com/sillyangel/project-still.git
cd project-still/
pnpm install
# or npm
npm install
2. Configure the Navidrome connection
First, copy the example environment file:
cp .env.example .env
Next, open the new .env file and update it with your Navidrome server credentials:
NEXT_PUBLIC_NAVIDROME_URL=http://localhost:4533
NEXT_PUBLIC_NAVIDROME_USERNAME=your_username
NEXT_PUBLIC_NAVIDROME_PASSWORD=your_password
NEXT_PUBLIC_POSTHOG_KEY=phc_XXXXXXXXXXXXXXXXXX
NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com
Tip: If you don’t have your own Navidrome server yet, you can use the public demo credentials:
NEXT_PUBLIC_NAVIDROME_URL=https://demo.navidrome.org
NEXT_PUBLIC_NAVIDROME_USERNAME=demo
NEXT_PUBLIC_NAVIDROME_PASSWORD=demo
- Run the development server
pnpm dev
# or npm
npm run dev
Open http://localhost:40625 in your browser.
Docker Deployment
For easy deployment using Docker:
Quick Docker Setup
# Run using pre-built image (app will prompt for Navidrome configuration)
docker run -p 3000:3000 sillyangel/mice:latest
# Or build locally
docker build -t mice .
docker run -p 3000:3000 mice
Docker Compose (Recommended)
# Copy environment template and configure
cp .env.docker .env
# Edit .env with your settings (optional - app can prompt)
docker-compose up -d
Pre-configured Docker Run
docker run -p 3000:3000 \
-e NEXT_PUBLIC_NAVIDROME_URL=http://your-navidrome-server:4533 \
-e NEXT_PUBLIC_NAVIDROME_USERNAME=your_username \
-e NEXT_PUBLIC_NAVIDROME_PASSWORD=your_password \
sillyangel/mice:latest
📖 For detailed Docker configuration, environment variables, troubleshooting, and advanced setups, see DOCKER.md
Tech Stack
- Frontend: Next.js 15, React 19, TypeScript
- UI: shadcn/ui, Tailwind CSS, Radix UI
- Backend: Navidrome (Subsonic API compatible)
- Audio: Web Audio API with streaming
- State: React Context for global state management
License
This project is licensed under the MIT License.
Acknowledgments
- shadcn/ui for the beautiful UI components
- Navidrome for the amazing music server
- Subsonic API for the API specification