M2 Music - Music Streaming Platform With Laravel and Flutter App

M2 Music — Complete Self-Hosted Music Streaming Platform With Flutter Mobile App

M2 Music is a fully self-hosted, white-label music streaming platform built for artists, fans, and platform owners. Artists upload singles, EPs, albums, and beats — then earn royalties from every verified stream. Fans discover music, build playlists, follow artists, subscribe to premium plans, and stream on the web or through the included Flutter mobile app for iOS and Android. You own the data, the brand, and the revenue. No per-stream SaaS fees. No third-party AI API required.

The package is a complete ecosystem: a Laravel 13 backend with REST API, a full admin panel, separate artist and fan web dashboards, a public marketing website with a built-in player, and a Flutter 3 mobile app (iOS + Android) that connects to the same API. Install once, run everywhere — web and mobile from one platform.

What’s Included

• Laravel 13 Backend (PHP 8.2+) — REST API (Sanctum), MySQL database, queued jobs, scheduled tasks, royalty engine, subscription system, and full server-side discovery — powers both web and mobile
• Flutter Mobile App (iOS + Android) — full-featured streaming app built with Flutter 3 and Dart; background audio, synced karaoke lyrics (LRC), offline downloads (premium), in-app subscriptions, tips, playlists, community, DMs, and artist tools — connects to the Laravel API
• Admin Panel — platform dashboard, user/artist management, track & release approvals, genres, subscriptions, payouts, DMCA, ads, announcements, insights, global search, and settings
• Artist Web Dashboard — upload singles/EPs/albums/beats, track management, earnings, insights, listener map, fans list, payout requests, community, and profile
• Fan Web Dashboard — personalized home feed, browse, daily mix, charts, library, playlists, history, artist pages, community, direct messages, and subscriptions
• Public Website — homepage with discovery sections, public artist profiles, track pages, playlist pages, marketing pages, legal pages, and built-in web player with queue
• Web Installer Wizard — requirements check, database setup, migrations, seeding, and admin account creation in one guided flow
• Full HTML Documentation — installation, Laravel setup, Flutter app configuration, APK/IPA build guide, payment gateway setup, rebranding, cron jobs, and troubleshooting

Flutter Mobile App (iOS + Android)

The included Flutter mobile app is a production-ready companion to the Laravel backend. One codebase builds for both iOS and Android and shares the same REST API, user accounts, subscriptions, and content as the web platform.

• Music Streaming — play, pause, seek, queue, shuffle, repeat, and background audio (Android via just_audio_background)
• Synced Karaoke Lyrics — time-synced LRC line highlighting in the mobile player
• Offline Downloads — premium subscribers download tracks for offline listening
• In-App Payments — subscriptions and artist tips via Stripe, PayPal, Paystack, and PawaPay with server-side verification
• Discovery — home feed, charts, new releases, artist radio, search, autocomplete, and personalized recommendations
• Playlists & Library — create playlists, like tracks, save to library, and view listening history
• Social — follow artists, community feed, direct messages, notifications, and reposts
• Artist Mode — upload tracks, view earnings and insights, and request payouts from the app
• Ads — configurable ad placements for free-tier mobile listeners
• Rebrandable — change app name, colors, API URL, and icons from lib/config/app_config.dart

User Roles & Access

• Admin — full platform control via web admin panel
• Artist — upload music and manage career from web dashboard or Flutter app
• Producer / Label — dedicated registration roles with the same creator dashboard
• Fan — stream on web or Flutter app; like, follow, subscribe, playlist, message, and join the community
• Public Visitor — browse the website, play tracks, view profiles, and sign up to unlock web + mobile features

Artist Features (Web + Flutter App)

• Upload Singles, EPs, Albums & Beats — from web dashboard or Flutter app; audio (MP3, WAV, FLAC), cover art, genre, mood, BPM, lyrics, LRC file, featured artists, and release scheduling
• Track Management — edit metadata, view approval status, delete tracks, set free vs premium-only
• Scheduled Releases — future go-live date with automatic cron publishing
• Stream Royalties — earn per verified play with verified-artist and featured-track multipliers
• Earnings Dashboard — per-track breakdown, balance, pending vs paid, CSV export (web)
• Insights & Analytics — streams by day, top tracks, earnings by month, listener countries with world map (web)
• Payout Requests — withdraw via Mobile Money (PawaPay) or Bank Transfer (web + app)
• Community & DMs — post updates, receive engagement, message fans (web + app)
• Weekly Email Digest — automated streams and earnings summary

Fan Features (Web + Flutter App)

• Personalized Home Feed — quick access, made-for-you mixes, and recommendations
• Browse & Search — genre, mood, release type filters; autocomplete on mobile
• Daily Mix — up to three genre-based mixes from your taste profile
• Charts — weekly, monthly, and all-time rankings
• Library & Playlists — liked songs, followed artists, custom playlists (web + app)
• Artist Pages — follow, play, view discography, featured-artist credits, tip artists
• Community & DMs — posts, likes, comments, 1-to-1 messages with read receipts
• Subscriptions — free tier with ads or premium with ad-free, HQ audio, and offline downloads on mobile
• Notifications — follows, announcements, and activity alerts (web + app)

Public Website

• Homepage — trending, featured, new releases, popular tracks, albums, top artists, genres
• Public Profiles — artist pages, track pages, playlist pages with built-in player
• Web Player — queue, shuffle, repeat, like, seek, and autoplay
• Marketing & Legal Pages — About, Services, Contact, Privacy, Terms, DMCA, and more
• Dark / Light / Auto Theme — visitor theme toggle
• PWA-Ready — web app manifest for add-to-home-screen on mobile browsers (complements the native Flutter app)

Admin Panel

• Dashboard — KPIs, stream trends, pending approvals, top tracks
• User & Artist Management — verify, suspend, create, delete
• Content Moderation — approve/reject tracks and releases, flag content, bulk actions
• Finance — earnings overview, payout approval, CSV export, subscription plans, free-tier rules
• Marketing — announcements, ads manager (banner, video, audio preroll), InMobi/Audiomob settings
• Compliance — DMCA review queue, community moderation
• System — feature toggles, branding, SMTP, gateway tester, admin 2FA, global search

Payments & Monetization (Web + Flutter App)

• 4 Payment Gateways — Stripe, PayPal, Paystack, PawaPay (web checkout + Flutter in-app checkout)
• Subscriptions — recurring billing, plan tiers, trials, free-tier play limits
• Artist Tips — fans tip artists from web profiles or the Flutter app
• Stream Royalties — automatic per-play earnings with multipliers
• Artist Payouts — Mobile Money (PawaPay) and Bank Transfer with admin approval
• Multi-Currency & Country Matrix — per-gateway currencies and payout country controls
• Ad-Supported Free Tier — play caps with ads on web and mobile

Recommendations & Discovery — No External AI API Required

Daily Mix, Artist Radio, and Recommendations run on your server using database queries — genre matching, play history, follower graphs, and popularity scoring. No OpenAI, Gemini, Claude, or any AI API key is required. Works identically on web and Flutter app.

Music Player & Audio

• Web Player — queue, shuffle, repeat, like, seek, autoplay
• Flutter Mobile Player — background audio, queue, shuffle, repeat, synced LRC karaoke lyrics, offline playback (premium)
• Audio Pipeline — MP3/WAV/FLAC upload, getID3 duration extraction, optional FFmpeg transcoding to 192kbps MP3 via queued jobs

Community, Security & Compliance

• Community Feed — posts, images, likes, comments, reposts (web + app)
• Direct Messages — 1-to-1 inbox with read receipts (web + app)
• Artist Verification Badge — admin-granted with higher royalty multiplier
• DMCA Workflow — public form + admin review queue
• Track Approval — all uploads reviewed before going live on web and app
• Play Throttling — API rate limiting to reduce fake-stream abuse
• Admin Email 2FA — optional two-factor for admin login

Feature Switches (No Code Changes)

Toggle from admin: Charts, Artist Radio, Synced Lyrics, Tips, Downloads, Recommendations, History, Search, Community, DMs, and Playlists — applies to web and mobile API.

Email & SEO

• Transactional Emails — welcome, track approved/rejected, subscription, payout, and more
• Weekly Digests — automated artist and fan email summaries (cron)
• Dynamic Sitemap — auto-generated sitemap.xml
• White-Label Branding — app name, logos, colors on web; rebrandable Flutter app config

Tech Stack

• Backend: Laravel 13, PHP 8.2+, MySQL 8.0+
• Mobile App: Flutter 3.27+, Dart 3.x, just_audio, just_audio_background — iOS + Android from one codebase
• API: Laravel Sanctum REST API (shared by web dashboards and Flutter app)
• Payments: Stripe, PayPal, Paystack, PawaPay
• Audio: getID3 + optional FFmpeg
• Web: Blade, vanilla JS, Hotwire Turbo

Files Included

• Laravel backend source code (PHP, Blade, CSS, JavaScript)
• Flutter mobile app source code (Dart) — complete iOS & Android project
• Full HTML documentation — Laravel install + Flutter setup + APK/IPA build guide
• Database migrations and idempotent seeders
• Web installer wizard
• PWA manifest and app icons

Browser & Device Support

Web: Chrome, Firefox, Safari, Edge (latest). Flutter Mobile App: Android 5.0+ / iOS 13+. Server: Linux hosting, PHP 8.2+, MySQL, optional FFmpeg, cron support.

⚠ Third-Party Payment Gateway Fees — Important Disclosure

M2 Music integrates with external payment gateways on web and in the Flutter app. Each requires its own merchant account. Fees are separate from this item and deducted by the provider:

• Stripe — approx. 2.9% + $0.30 per transaction — stripe.com/pricing
• PayPal — approx. 3.49% + fixed fee — paypal.com/fees
• Paystack — 1.5% + ₦100 local / 3.9% international — paystack.com/pricing
• PawaPay — mobile money payouts — pawapay.io

All fees are approximate and subject to change. Gateway fees are not collected by this script.

Requirements

• PHP 8.2+, MySQL 8.0+, Composer, writable storage directories
• Flutter SDK 3.27+ for building the iOS and Android app
• Xcode (macOS) for iOS builds; Android Studio / SDK for Android builds
• FFmpeg optional (audio transcoding)
• Cron job support (releases, digests, queue worker, subscription expiry)