<div align="center"> <img src=".docs/assets/logo.png?raw=1" alt="MiniFy logo" width="140" height="140"> <h1>MiniFy</h1> <p>Spotify mini player for desktop built with Tauri + React, paired with a Next.js landing site.</p> <p> <a href="https://minify.skeptic.run"><strong>🌐 Website</strong></a> · <a href="https://minify-docs.skeptic.run"><strong>📚 Documentation</strong></a> · <a href="https://github.com/ModioStudio/MiniFy/releases/latest"><strong>⬇️ Download</strong></a> </p> <p> <a href="https://github.com/ModioStudio/MiniFy/issues/new?labels=bug">Report Bug</a> · <a href="https://github.com/ModioStudio/MiniFy/issues/new?labels=enhancement">Request Feature</a> · <a href="https://github.com/orgs/ModioStudio/projects/2">Project Board</a> · <a href="https://discord.gg/haNyuz2zQ5">Discord</a> </p> <div> <img src="https://img.shields.io/badge/TypeScript-5.8-3178C6?logo=typescript&logoColor=white" alt="TypeScript 5.8" /> <img src="https://img.shields.io/badge/React-19-61DAFB?logo=react&logoColor=white" alt="React 19" /> <img src="https://img.shields.io/badge/Tauri-2-FFC131?logo=tauri&logoColor=black" alt="Tauri 2" /> <img src="https://img.shields.io/badge/Vite-7-646CFF?logo=vite&logoColor=white" alt="Vite 7" /> <img src="https://img.shields.io/badge/Next.js-15-000000?logo=nextdotjs&logoColor=white" alt="Next.js 15" /> <img src="https://img.shields.io/badge/Tailwind_CSS-4-06B6D4?logo=tailwindcss&logoColor=white" alt="Tailwind CSS 4" /> <img src="https://img.shields.io/badge/Spotify%20API-Now%20Playing-1DB954?logo=spotify&logoColor=white" alt="Spotify API" /> <img src="https://img.shields.io/badge/Vercel%20AI%20SDK-Multi%20Provider-000000?logo=vercel&logoColor=white" alt="Vercel AI SDK" /> <img src="https://img.shields.io/badge/Turborepo-2-000000?logo=turbo&logoColor=white" alt="Turborepo 2" /> <img src="https://img.shields.io/badge/pnpm-9-F69220?logo=pnpm&logoColor=white" alt="pnpm 9" /> <img src="https://img.shields.io/badge/Rust-Tauri%20core-000000?logo=rust&logoColor=white" alt="Rust" /> </div> </div>

Overview
Features
Screenshots
Architecture
Getting Started
Scripts
Tech Stack
Security Details
Links
License

Overview

MiniFy is a lightweight Spotify mini player built with Tauri. It lives as a frameless desktop overlay, polls the Spotify API for the currently playing track, and gives you playback controls, themeable layouts, and native OS menus. A Next.js site lives alongside the desktop app for marketing and downloads.

Features

🎧 Core Player

Spotify OAuth flow with secure token storage and automatic refresh
Playback controls, scrubbing, and save-to-library actions
Native context menu with quick access to settings and window controls
Keyboard-friendly design with configurable shortcuts

🎨 Customization

Multiple Layouts: Three player layouts (A, B, C) optimized for different workflows
Built-in Themes: Dark, Light, Spotify Green, and more pre-built themes
Theme Studio: Create custom themes with a live JSON editor
Persistent Settings: Your preferences are saved and restored automatically

🤖 AI DJ

Multi-Provider Support: OpenAI, Anthropic, Google AI, and Groq
Music Analysis: Understands your listening patterns, top artists, and audio preferences
Natural Language Control: "Play something energetic" or "Find songs like my recent listens"
Smart Recommendations: Uses Spotify's audio features (energy, mood, tempo, danceability)

🔐 Security

Secure Keyring Storage: All credentials stored in OS-level credential manager
No Plain Text: API keys and tokens never saved to files
OAuth PKCE: Industry-standard secure authentication flow

Roadmap

Follow progress and planned milestones on the project board: ModioStudio MiniFy Roadmap

Architecture

Tauri shell hosting a Vite + React UI for the player.
Rust commands manage OAuth, secure keyring storage, and Spotify Web API calls.
All credentials (Spotify tokens, AI API keys) stored in OS-level secure keyring.
AI DJ powered by Vercel AI SDK with tool-calling for Spotify integration.
Shared settings persisted on disk; playback state is polled and cached in the renderer.
Optional Next.js 15 site for the public landing page.

Screenshots

🎵 Player Layouts

MiniFy offers multiple compact layouts to fit your workflow. Each layout is designed to be minimal yet functional.

<details> <summary><b>Layout A</b> — Horizontal compact view</summary> <div align="center"> <img src=".docs/assets/layouta.png" alt="MiniFy Layout A" width="700"> </div> </details> <details> <summary><b>Layout B</b> — Vertical card view</summary> <div align="center"> <img src=".docs/assets/layoutb.png" alt="MiniFy Layout B" width="700"> </div> </details>

🤖 AI DJ Integration

Your personal AI-powered music assistant. Connect your preferred AI provider and let it analyze your listening habits, recommend songs, and control playback through natural conversation.

<details open> <summary><b>AI DJ Chat</b> — Natural language music control</summary> <div align="center"> <img src=".docs/assets/aidj-preview-chat.png" alt="AI DJ Chat Interface" width="700"> </div> <p align="center"><i>Ask for recommendations, play songs, or analyze your music taste</i></p> </details> <details> <summary><b>AI DJ Preview</b> — Context menu access</summary> <div align="center"> <img src=".docs/assets/aidj-preview.png" alt="AI DJ Preview" width="700"> </div> </details>

Supported AI Providers:

OpenAI (GPT-4o Mini)
Anthropic (Claude 3 Haiku)
Google AI (Gemini 1.5 Flash)
Groq (Llama 3.1 8B)

⚙️ Settings & Customization

Full control over your MiniFy experience through a comprehensive settings panel.

<details open> <summary><b>Connections</b> — Music & AI Provider Management</summary> <div align="center"> <img src=".docs/assets/settings-connections.png" alt="Settings - Connections" width="700"> </div> <p align="center"><i>Connect Spotify and AI providers with secure API key storage</i></p> </details> <details> <summary><b>Appearance</b> — Layouts & Built-in Themes</summary> <div align="center"> <img src=".docs/assets/settings-appearance.png" alt="Settings - Appearance" width="700"> </div> <p align="center"><i>Choose from multiple layouts and pre-built themes</i></p> </details> <details> <summary><b>Theme Studio</b> — Create Custom Themes</summary> <div align="center"> <img src=".docs/assets/settings-theme-studio.png" alt="Settings - Theme Studio" width="700"> </div> <p align="center"><i>Design your own themes with the built-in JSON editor</i></p> </details>

Customization Features:

🎨 Multiple built-in themes (Dark, Light, Spotify Green, etc.)
🖌️ Custom theme creation via JSON
📐 Switchable player layouts
🔐 Secure credential management

Project Structure

apps/desktop: Tauri 2 desktop app using React 19, Vite 7, and Tailwind 4.
apps/www: Next.js 15 site for marketing and downloads.
packages (empty today): reserved for future shared libraries.
Root tooling: Turborepo orchestrates tasks, Biome handles lint/format, pnpm powers the workspace.

Getting Started

Prerequisites

Node.js >= 18 and pnpm 9.
Rust toolchain with the platform-specific Tauri prerequisites.
Spotify Developer application to obtain a Client ID.

Setup

Install dependencies: pnpm install
(Optional) Install Git hooks: pnpm dlx lefthook install
Have your Spotify Client ID ready; the desktop app will ask for it on first launch.

Running Locally

Desktop app: pnpm desktop:dev
- First boot asks for the Spotify Client ID, performs OAuth, and lets you pick layout/theme.
Web site: pnpm www:dev
- Starts the Next.js site (default port 3000).

Scripts

pnpm dev — run workspace dev tasks via Turborepo.
pnpm desktop:dev — launch the Tauri app in dev mode.
pnpm desktop:build — create a production desktop bundle.
pnpm desktop:clear — clear all credentials (Spotify tokens, AI keys) and settings.
pnpm www:dev — start the Next.js site.
pnpm www:build — build the Next.js site.
pnpm lint — run Biome checks across the workspace.

Tech Stack

Desktop: Tauri 2, React 19, Vite 7, Tailwind CSS 4, Spotify Web API.
AI: Vercel AI SDK with OpenAI, Anthropic, Google AI, and Groq support.
Backend bridge: Rust + Tauri commands for OAuth, secure keyring storage, and playback actions.
Web: Next.js 15 with React 19.
Tooling: Turborepo, pnpm, Biome, Lefthook.

Security Details

All sensitive credentials are stored in your operating system's secure credential manager:

| Platform | Storage | |----------|---------| | Windows | Credential Manager | | macOS | Keychain | | Linux | Secret Service |

This includes Spotify tokens and AI API keys. No credentials are stored in plain text files.

Links

| Resource | URL | |----------|-----| | 🌐 Website | minify.skeptic.run | | 📚 Documentation | minify-docs.skeptic.run | | ⬇️ Downloads | GitHub Releases | | 🐛 Issues | GitHub Issues | | �

MiniFy

Install / Use

README

Table of Contents