b5669cf831
Bumps the dev group with 2 updates in the / directory: [eslint-config-next](https://github.com/vercel/next.js/tree/HEAD/packages/eslint-config-next) and [typescript](https://github.com/microsoft/TypeScript). Updates `eslint-config-next` from 15.4.4 to 15.4.5 - [Release notes](https://github.com/vercel/next.js/releases) - [Changelog](https://github.com/vercel/next.js/blob/canary/release.js) - [Commits](https://github.com/vercel/next.js/commits/v15.4.5/packages/eslint-config-next) Updates `typescript` from 5.8.3 to 5.9.2 - [Release notes](https://github.com/microsoft/TypeScript/releases) - [Changelog](https://github.com/microsoft/TypeScript/blob/main/azure-pipelines.release-publish.yml) - [Commits](https://github.com/microsoft/TypeScript/compare/v5.8.3...v5.9.2) --- updated-dependencies: - dependency-name: eslint-config-next dependency-version: 15.4.5 dependency-type: direct:development update-type: version-update:semver-patch dependency-group: dev - dependency-name: typescript dependency-version: 5.9.2 dependency-type: direct:development update-type: version-update:semver-minor dependency-group: dev ... 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