Skip to content

aranish-uk/Noct

Repository files navigation

🌙 Noct

Noct is a minimalist, aesthetic study clock designed to help you focus with your favorite Spotify music. It features a clean, distraction-free interface with deep Spotify integration.

Noct Screenshot Note: Replace with actual screenshot if available

✨ Features

  • 🕒 Minimalist Clock: A clean, elegant display of time to keep you on track.
  • 🎵 Spotify Integration: Full control over your Spotify playback directly from the app.
  • 👁️ Focus Mode: One-click to hide almost everything and let the music and time be your only companions.
  • ✦ Surprise Me: Let Noct pick a personalized mix from your library for those "what do I listen to?" moments.
  • 🔄 Playlist Hot-swapping: Easily paste any Spotify playlist URL to change the vibe instantly.
  • ❓ Help Overlay: Quick access to information and instructions.

🚀 Getting Started

Prerequisites

  • Spotify Premium: Required for the Web Playback SDK to function.
  • Node.js: Version 18 or higher.

Installation

  1. Clone the repository:

    git clone https://github.com/aranish-uk/Noct.git
    cd Noct
  2. Install dependencies:

    npm install
  3. Setup Environment Variables: Create a .env file in the root directory and add your Spotify Client ID:

    VITE_SPOTIFY_CLIENT_ID=your_spotify_client_id_here

    You can get a Client ID from the Spotify Developer Dashboard.

  4. Run the development server:

    npm run dev

🛠️ Tech Stack

  • React: Frontend framework.
  • Vite: Fast build tool and dev server.
  • Spotify Web Playback SDK: High-level integration for playback.
  • Vanilla CSS: Custom, premium styling without bloat.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with ❤️ for focused minds.

About

A focus-first study timer built in Next.js, with Spotify control + a Surprise Me button for instant vibes.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors