Noize

<div align="center"> <img src="assets/default_artwork.png" width="120" height="120"/> <h1>Noize</h1> <p> Your ultimate groove companion – a powerful, privacy‑first YouTube Music experience. </p> <!-- Badges --> <p> <a href="https://github.com/anandssm/noize/releases/latest"> <img src="https://img.shields.io/github/v/release/anandssm/noize?style=for-the-badge" alt="Latest Release" /> </a> <a href="https://github.com/anandssm/noize/releases"> <img src="https://img.shields.io/github/downloads/anandssm/noize/total?style=for-the-badge" alt="Total Downloads" /> </a> <a href="https://github.com/anandssm/noize/blob/main/LICENSE"> <img src="https://img.shields.io/badge/License-GPLv3-blue?style=for-the-badge" alt="GPLv3" /> </a> <a href="https://github.com/anandssm/noize/actions/workflows/build-release.yml"> <img src="https://img.shields.io/github/actions/workflow/status/anandssm/noize/build-release.yml?style=for-the-badge" alt="Build Status" /> </a> </p>

Website | Download

Contact & Support:

• Email: gravityappslabin@gmail.com
• Support group: Telegram
• Updates channel: Telegram

</div>

⚠️ Work in Progress: Noize is currently under active development. Features may be incomplete, unstable, or subject to change.

🎵 About Noize

Noize is a free and open source YouTube Music client for Android, Windows, and Linux. Built with Flutter, it focuses on smooth playback, rich customization, and privacy-first local data control. iOS and macOS support is coming soon.

At a Glance

• Stream from YouTube Music, with optional JioSaavn support.
• Download tracks/playlists for offline listening.
• Use synced lyrics (YouTube Music / LRCLib / AI providers).
• Manage local music folders and file extensions.
• Enjoy built-in equalizer, sleep timer, and playback stats.

📸 Screenshots

| Light Mode | Dark Mode | |---|---| | <img src="docs/screenshots/screenshot-1.jpeg" alt="Light Mode Screenshot" width="300"/> | <img src="docs/screenshots/screenshot-2.jpeg" alt="Dark Mode Screenshot" width="300"/> |

✨ Features

Noize includes a wide set of features implemented in this repository:

Streaming & Discovery

• Stream songs, albums, artists, playlists, and videos from YouTube Music.
• Optional JioSaavn integration for alternate/high-quality source.
• Country-aware Trending feed.
• Home sections for recently played, liked songs, favorite artists, and recent playlists.

Search & Navigation

• Fast search with suggestions.
• Search history with enable/disable controls and clear actions.
• Grouped results by Songs, Albums, Artists, Playlists, and Videos.
• In-list search delegates for library and playlist/album screens.

Playback Experience

• Background playback with media session integration.
• Queue management: add to queue, play next, reorder queue, clear queue.
• Playback controls: shuffle, repeat, speed, volume.
• Video mode support for playable YouTube video content.
• Windows SMTC integration and Android media notifications.

Downloads & Offline

• Download individual songs or complete playlists.
• Concurrent download queue with progress/preparing states.
• Configurable download quality.
• Embedded metadata/artwork handling for downloaded content.
• Dedicated downloads screen for offline playback.

Local Library

• Scan local audio files and play from device storage.
• Manage included/excluded folders.
• Manage included/excluded file extensions.
• Minimum duration filters and local permission handling flow.
• Import local tracks into active playback queue.

Lyrics

• Multiple lyric providers: YouTube Music, LRCLib, AI.
• AI lyric generation via Gemini/OpenAI (API key configurable).
• Supports synchronized and plain lyrics.
• Seek to lyric lines while playback is running.
• Caching support for faster lyric access.

Playlists, Favorites & Library Data

• Create, delete, and manage custom playlists.
• Add/remove songs to playlists from option sheets.
• Liked songs and favorite artists management.
• Saved playlists/albums and created playlists sections.

Audio Controls

• Built-in equalizer screen.
• Presets and custom tuning controls.
• Streaming quality and downloading quality settings.
• Audio output selection support.

Smart Utilities

• Sleep timer with optional fade-out effect.
• Playback statistics (daily/weekly/monthly views, top artists).
• Crash log viewer with share/clear controls.
• Connectivity status handling and graceful fallback.

OTA Updates & Channels

• In-app update checking.
• Update channels (stable/beta/dev).
• Version-based update detection.
• Release notes, update progress, ETA, and install flow.

Customization & Accessibility

• Light, Dark, and System theme modes.
• Adaptive/dynamic accent color and manual accent color picker.
• Full-player background animation selection (multiple styles + static).
• Multi-language support (English, Hindi, Spanish, French, German, Russian, Ukrainian, Bengali, Japanese, Chinese, Urdu, Telugu, Tamil, Marathi).

Data & Settings Tools

• Export/import settings and app data selections.
• Granular clear actions (cache, playback stats, queues, logs, playlists, favorites, etc.).
• AI provider and key management screen.
• Language selection and general app preferences.

Sharing & Integrations

• Share song links and app links.
• Android share-intent support for incoming local files.
• Open tracks externally (YouTube / YouTube Music).

Quick tips:

• Download a song from its options menu or from a playlist menu.
• Enable AI lyrics in Settings → AI API Configuration.
• Open equalizer in Settings → Audio Settings → Equalizer.

Supported audio formats: .mp3, .aac,.m4a, .wav, .flac, .ogg.

💻 Tech Stack

Noize is built with Flutter and community packages. Core stack overview:

| Area | Libraries / Tools | Purpose | |---|---|---| | Framework | Flutter, Dart | Cross-platform app UI and business logic | | State & DI | provider, get_it, go_router | State management, dependency injection, navigation | | Audio Engine | just_audio, just_audio_background, just_audio_media_kit, audio_service, audio_session, audioplayers | Playback, background controls, media session integration | | Streaming & Video | dart_ytmusic_api, youtube_explode_dart (git fork), youtube_player_flutter, flutter_inappwebview, jiosaavn | Streaming metadata, stream extraction, embedded player, alternate source | | Downloads & Network | dio, flutter_local_notifications | Download pipeline and user notifications | | Local Media & Metadata | metadata_god, audio_metadata_reader| Local song discovery, tags/artwork extraction, output device controls | | Storage | hive_ce, shared_preferences, path_provider | App data persistence and local storage paths | | UI & Visualization | easy_localization, google_fonts, dynamic_color, palette_generator, flutter_animate, fl_chart, cached_network_image, shimmer, flutter_svg, persistent_bottom_nav_bar_v2 | Localization, visuals, animation, charts, and UI components | | Platform Integrations | receive_sharing_intent (git), smtc_windows, android_intent_plus, package_info_plus, device_info_plus, connectivity_plus, permission_handler, file_picker, terminate_restart | Intents, platform controls, permissions, file picking, restart/update helpers | | Utilities | share_plus, url_launcher, collection, crypto, synchronized, talker_flutter, audio_video_progress_bar | Sharing, links, helpers, logging, progress UI |

(See pubspec.yaml for a full list and exact versions.)

🚀 Installation

Android

1. Download the latest APK from the website.
2. Enable "Install from unknown sources" in your device settings.
3. Install the downloaded APK file.

Windows

1. Download the Windows installer from the website.
2. Run the installer and follow the on-screen instructions.
3. Launch Noize from the Start Menu.

Linux

1. Download the latest Linux build from the website.
2. Extract the archive and run the Noize executable.
3. Optionally, create a desktop entry for easy access.

iOS & macOS

iOS and macOS support is currently under development and coming soon. Stay tuned for updates!

🛠️ Development

Interested in contributing to Noize? Here's how to get started:

Prerequisites

• Flutter SDK
• Android Studio / Visual Studio Code
• For Windows development: Visual Studio with C++ development tools

Setup

1. Clone the repository:

   git clone https://github.com/anandssm/noize.git
   

2. Navigate to the project directory:

   cd noize
   

3. Install dependencies:

   flutter pub get
   

4. Run the app:

   flutter run
   

Project Structure

noize/
├── android/                     # Android build and platform code
│   └── app/                     # application module
├── build/                       # generated build artifacts (ignore)
├── docs/                        # documentation and release metadata
├── assets/
│   ├── images/                  # App images and artwork
│   └── translations/            # Localization JSON files
├── lib/
│   ├── core/                    # Shared services, providers, models, constants
│   ├── features/                # Feature‑first modules (player, search, settings, etc.)
│   ├── shared/                  # Shared widgets/components/animations
│   ├── generated/               # Generated files (hive, localization, etc.)
│   └── main.