GrayKnight - Spotify Analytics & Controller

A web application that enhances your Spotify experience with detailed listening statistics and advanced playback controls.

Features

Live Music Control

• Real-time playback controls
• Multi-device management
• Queue management
• Volume and playback mode controls

Detailed Analytics

• Track listening history
• Genre distribution analysis
• Peak listening hours
• Time-based statistics
• Artist diversity tracking

Library Management

• User Top items
• User's playlist and dialogs

Smart Features

• Offline tracking capability
• Background scrobbling
• Cross-device synchronization
• Listening pattern analysis
• 

Technical Details

Frontend

• Built with Next.js and Ts
• Responsive design with Tailwind CSS
• Clean and consitent UI.

Backend

• NestJS
• PSQL with Prisma
• Efficient caching system (almost done)
• Spotify Web API integration

Key Components

• User authentication and session management
• Real-time track scrobbling
• Artist genre caching
• Time-series data tracking
• Device state management

Setup Guide

Prerequisites

• Node.js (v16 or higher)
• PostgreSQL database

Installation Steps

1. Clone the Repository

git clone https://github.com/qeqqe/GrayKnight-Remake.git
cd GrayKnight-Remake

2. Install Dependencies

pnpm install

3. Environment Configuration

• Copy .env.example to .env in both apps/client and apps/server
• Fill in required environment variables

4. Start Development Servers

# Start Frontend (from apps/client)
cd apps/client
pnpm run dev

# Start Backend (from apps/server)
cd apps/server
pnpm run start:dev