Skip to content

Repository files navigation

Rivone 🎵

Private. Floating. Instant.

Rivone is an experimental music player engineered for the Edge. It redefines personal music streaming by combining the privacy of Telegram with the performance of Cloudflare's global network.

Screenshot_20251228_183816 Screenshot_20251228_183830 Screenshot_20251228_183842

💡 The Concept

Most music players are clunky and privacy-invasive. Rivone is different:

  • Floating UI: A glassmorphism-inspired interface that floats above your workflow.
  • Instant Sync: Wirelessly syncs your personal library in seconds.
  • Edge Powered: Zero-latency streaming from the nearest server location globally.

🚀 Deployment (Cloudflare Pages)

This project is optimized for Cloudflare Pages with Edge Runtime.

Prerequisites

  1. Cloudflare Account: Required for Pages and KV.
  2. Telegram Bot: Required for file synchronization.

Environment Variables

Set the following in your Cloudflare Pages Dashboard:

  • PROJECT_PASSWORD: Secure access code for the player.
  • BOT_TOKEN: Telegram Bot API Token.

KV Namespace

  1. Create a KV Namespace named rivone in Cloudflare.
  2. Bind it to your Pages project with the variable name: RIVONE_KV.

Build Settings

  • Framework Preset: Next.js
  • Build Command: npm run pages:build
  • Output Directory: .vercel/output/static
  • Compatibility Flags: nodejs_compat

🛠️ Built With

🔒 Security

  • Zero-Trust API: All API routes strictly verify authentication cookies.
  • Middleware Shield: Unauthorized users are instantly redirected from UI pages.
  • HttpOnly Cookies: Prevents client-side script access to credentials.

⚠️ Intellectual Property Notice

Copyright © 2025 Ashmit Kumar. All Rights Reserved.

This software is proprietary and closed-source.

The code, design, and architecture contained in this repository are the intellectual property of Ashmit Kumar. Unauthorized copying, reverse engineering, distribution, or commercial use is strictly prohibited.

🌐 Connect


Designed & Engineered by Ashmit Kumar.

About

RIVONE is a private music streaming web app built with Next.js, using Telegram as a secure backend storage. Features access-key based authentication, server-side audio streaming, and a clean Spotify-like listening experience — fully private, zero-cost, and self-hosted.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages