The Journey

About Beats App.

|
Current Version
v1.0.9
Latest stable release
Features Shipped
7+
And counting...
Built With
Flutter
Dart + Supabase
⚖️
Important Disclaimer
Please read before using Beats

YouTube Data API v3 — Used for search results and video metadata only

youtube_player_flutter — Community package for audio streaming (not official YouTube plugin)

This is a learning project, not for commercial use

All intellectual property rights belong to their respective owners

No monetization or copyright infringement intended

Built solely for educational & skill development purposes

Why Beats?

Four pillars that shaped this entire project — from napkin sketch to APK.

01
💡
The Vision
I'm a student, a learner
Saw music apps and thought — can I build one too?
Just had a vision to implement my skills practically
02
📚
The Learning
Learned YouTube Data API for metadata
Flutter, UI/UX, Supabase — all step by step
Every error was a new lesson
03
🚀
The Execution
Not just theory — practical was the goal
LAN jamming, trending songs, reels — challenging features
Implemented with the best of my knowledge
04
⚖️
The Ethics
Didn't want to violate anyone's intellectual property
Followed terms of service throughout
Open about API usage — transparency is key

Technology Stack

Every tool chosen with purpose. Every decision documented.

▶️

YouTube Data API v3

Search results & video metadata fetching

Data Layer
📱

Flutter + Dart

Cross-platform mobile development framework

Core App
🗄️

Supabase

Backend, realtime sync & cloud functions

Backend
📡

UDP Broadcast

Low-latency LAN jamming communication

Networking
🤖

Beatser AI

Integrated AI chatbot for music recommendations

AI Layer
🌐

HTML / CSS / JS

This landing page & web presence

Web

How Beats Came to Life

Each feature has a story — here's how they were born.

🎭
Feature 01
LAN Multi-Device Jamming

First idea — listening to music in sync with friends over a local network. Used UDP broadcast for low-latency real-time synchronization with a smart countdown system for perfect simultaneous playback.

UDP Broadcast Time Offset Compensation Host / Join Mode
🔥
Feature 02
Trending Discovery

Learned to fetch trending songs from YouTube Data API v3. Dual search system with automatic fallback and smart offline caching so you never miss a beat even without internet.

YouTube API Smart Cache Click Tracking
📱
Feature 03
Music Reels

Short video format inspired by Instagram Reels & YouTube Shorts. Implemented vertical swipe UI in Flutter — 45-second clips at random positions, 10-video smart preloading buffer.

Vertical Swipe Smart Preload Extend Vibe
💬
Feature 04
Social Connect

Real-time messaging and music card sharing via Supabase Realtime. Because music isn't just for listening — it's for sharing too. 17 messages/day fair usage limit keeps it sustainable.

Supabase Realtime Music Cards Fair Limits

How We Use YouTube

Full transparency on API usage — no hidden surprises.

youtube_data_api.json
// YouTube Data API v3 Usage
{
"purpose": "search + metadata",
"rate_limits": respected,
"tos_compliant": true,
"commercial_use": false,
"data_stored": "metadata only",
"quota_usage": "within limits"
}
player_package.json
// youtube_player_flutter Usage
{
"package": "community-built",
"official": false,
"use_case": "audio streaming",
"downloading": false,
"attribution": provided,
"distribution": "none"
}

🔮 The Roadmap

Beats is alive and evolving. Here's what's on the horizon.

📈

Keep learning, keep improving with every release

More features if the community loves it

⚖️

Always staying within legal boundaries

🌐

Maybe open-source in the future?

💬

Your feedback directly shapes Beats!

Contact & Credits

Built by one person — but inspired by many.

👨‍💻
F Developer
@fdev-looper

A student developer building real things to learn real skills. Beats is my biggest project yet — and there's more to come.

Special Thanks 🙏
Me, Myself & I — Solo developer. Every line of code, every bug, every feature. All of it. Alone. 💪
YouTube Data API Team
Flutter & Dart Community
Supabase Team
Open-source contributors everywhere
Everyone who supported this journey