Initial project import with source, assets, and configs

Add all core source files, assets, configuration files, and platform-specific build scripts for Echo Music Desktop. Includes documentation, localization, platform assets, and setup for Windows, macOS, and Linux builds.

Author: iad1tya

BUILDING_LINUX.md

@@ -0,0 +1,119 @@
+# Building Linux Packages for Echo Music
+
+This guide explains how to build Linux distribution packages (DEB, AppImage, RPM) for Echo Music Desktop.
+
+## Platform Limitation ⚠️
+
+**Linux packages cannot be built on macOS.** The `flutter_distributor` tool requires a Linux environment to build Linux packages.
+
+## Available Package Formats
+
+The project is configured to build three Linux package formats:
+
+- **DEB** - For Debian, Ubuntu, and derivatives
+- **AppImage** - Universal Linux package (works on most distributions)
+- **RPM** - For Fedora, RHEL, CentOS, and derivatives
+
+## Option 1: Manual Build on Linux
+
+### Prerequisites
+```bash
+# Install system dependencies
+sudo apt-get update
+sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-12-dev
+
+# Install Flutter (if not already installed)
+# Follow: https://docs.flutter.dev/get-started/install/linux
+
+# Install flutter_distributor
+flutter pub global activate flutter_distributor
+```
+
+### Build All Packages
+```bash
+# Navigate to project directory
+cd /path/to/Echo-Music-Desktop
+
+# Install dependencies
+flutter pub get
+
+# Build all Linux packages
+flutter_distributor release --name dev --jobs release-dev-linux-deb,release-dev-linux-appimage,release-dev-linux-rpm
+```
+
+### Build Specific Package Type
+```bash
+# DEB only
+flutter_distributor release --name dev --jobs release-dev-linux-deb
+
+# AppImage only
+flutter_distributor release --name dev --jobs release-dev-linux-appimage
+
+# RPM only
+flutter_distributor release --name dev --jobs release-dev-linux-rpm
+```
+
+### Output Location
+Packages will be created in: `dist/1.0.0+0/`
+
+## Option 2: GitHub Actions (Recommended)
+
+A GitHub Actions workflow has been created at `.github/workflows/build-linux.yml`.
+
+### Trigger the Workflow
+
+**Method 1: Manual Trigger**
+1. Go to your GitHub repository
+2. Click "Actions" tab
+3. Select "Build Linux Packages" workflow
+4. Click "Run workflow"
+
+**Method 2: Tag-based Release**
+```bash
+# Create and push a version tag
+git tag v1.0.0
+git push origin v1.0.0
+```
+
+The workflow will automatically:
+- Build all three package types
+- Upload packages as artifacts
+- Create a GitHub Release (if triggered by tag)
+
+## Option 3: Docker
+
+Create a temporary Linux container to build packages:
+
+```bash
+# Run Ubuntu container with Flutter
+docker run -it --rm -v $(pwd):/workspace ubuntu:22.04 bash
+
+# Inside container:
+apt-get update
+apt-get install -y curl git unzip xz-utils zip libglu1-mesa clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev
+
+# Install Flutter
+git clone https://github.com/flutter/flutter.git -b stable
+export PATH="$PATH:`pwd`/flutter/bin"
+
+# Navigate and build
+cd /workspace
+flutter pub get
+flutter pub global activate flutter_distributor
+export PATH="$PATH:$HOME/.pub-cache/bin"
+flutter_distributor release --name dev
+```
+
+## Distribution
+
+Once built, distribute the packages:
+
+- **DEB**: Users install with `sudo dpkg -i Echo-*.deb`
+- **AppImage**: Users make executable and run: `chmod +x Echo-*.AppImage && ./Echo-*.AppImage`
+- **RPM**: Users install with `sudo rpm -i Echo-*.rpm`
+
+## Current Status
+
+- ✅ Configuration ready for DEB, AppImage, and RPM
+- ✅ GitHub Actions workflow created
+- ⚠️ Requires Linux environment to build

README.md

@@ -0,0 +1,114 @@
+<div align="center">
+  <img src="assets/Echo_github.png" alt="Echo Music Logo" width="140"/>
+  <h1>Echo Music Desktop</h1>
+  <p><strong>A robust, open-source music streaming client for Desktop</strong></p>
+  <p>Ad-free experience, offline capabilities, and advanced music discovery.</p>
+
+  <a href="https://github.com/iad1tya/Echo-Music/releases/latest"><img src="assets/Windows-button.png" alt="Download for Windows" width="170"/></a>
+  <a href="https://github.com/iad1tya/Echo-Music/releases/latest"><img src="assets/mac-button.png" alt="Download for Mac" width="170"/></a>
+</div>
+
+---
+
+## Overview
+
+Echo Music Desktop brings the premium music listening experience to your computer. Built with Flutter, it offers a seamless interface to stream music from YouTube Music without advertisements, along with powerful desktop-centric features.
+
+## Features
+
+*   **Ad-Free Streaming:** Enjoy uninterrupted music playback.
+*   **High Quality Audio:** Stream in the best available quality.
+*   **Offline Mode:** Download your favorite tracks and playlists for offline listening.
+*   **Lyrics Support:** Real-time synchronized lyrics with AI-powered translation.
+*   **Broad Compatibility:** Cross-platform support for Windows, macOS, and Linux.
+*   **Smart Recommendations:** Personalized song suggestions based on your listening history.
+*   **Sleep Timer:** Configure automatic playback cessation.
+
+## Installation
+
+### Windows
+1.  Download the latest installer (`.exe`) from the [Releases Page](https://github.com/iad1tya/Echo-Music/releases/latest).
+2.  Run the installer and follow the on-screen prompts.
+
+### macOS
+1.  Download the `.dmg` file from the [Releases Page](https://github.com/iad1tya/Echo-Music/releases/latest).
+2.  Open the disk image and drag "Echo Music" to your Applications folder.
+3.  *Note: If you encounter a security warning, go to System Settings > Privacy & Security and allow the application.*
+
+### Linux
+Echo Music is available as an AppImage, DEB, and RPM package.
+1.  Download the appropriate package from the [Releases Page](https://github.com/iad1tya/Echo-Music/releases/latest).
+2.  **AppImage**: Make it executable (`chmod +x Echo-Music-*.AppImage`) and run it.
+3.  **DEB/RPM**: Install using your package manager (e.g., `sudo dpkg -i package.deb`).
+
+## Build from Source
+
+To build Echo Music locally, ensure you have Flutter installed and configured for desktop development.
+
+1.  **Clone the Repository**
+    ```bash
+    git clone https://github.com/iad1tya/Echo-Music.git
+    cd Echo-Music
+    ```
+
+2.  **Enable Desktop Support**
+    Enable the platforms you intend to build for:
+    ```bash
+    flutter config --enable-windows-desktop
+    flutter config --enable-macos-desktop
+    flutter config --enable-linux-desktop
+    ```
+
+3.  **Install Dependencies**
+    ```bash
+    flutter pub get
+    ```
+
+4.  **Run the Application**
+    ```bash
+    flutter run -d [windows|macos|linux]
+    ```
+
+5.  **Build for Release**
+    ```bash
+    flutter build [windows|macos|linux]
+    ```
+
+---
+
+## Community and Support
+
+Join our community for updates, support, and discussions.
+
+<div align="center">
+  <a href="https://discord.gg/EcfV3AxH5c"><img src="assets/discord.png" width="140"/></a>
+  <a href="https://t.me/EchoMusicApp"><img src="assets/telegram.png" width="130"/></a>
+</div>
+
+### Support the Project
+
+If you find this project useful, consider supporting its development.
+
+<div align="center">
+  <a href="https://buymeacoffee.com/iad1tya"><img src="assets/bmac.png" width="140"/></a>
+  <a href="https://intradeus.github.io/http-protocol-redirector/?r=upi://pay?pa=iad1tya@upi&pn=Aditya%20Yadav&am=&tn=Thank%20You"><img src="assets/upi.svg" width="100"/></a>
+  <a href="https://www.patreon.com/cw/iad1tya"><img src="assets/patreon3.png" width="100"/></a>
+</div>
+
+### Cryptocurrency Addresses
+<div align="center">
+  <table>
+    <tr>
+      <td align="center"><strong>Bitcoin</strong><br><img src="assets/Bitcoin.jpeg" width="150"/><br><code>bc1qcvyr7eekha8uytmffcvgzf4h7xy7shqzke35fy</code></td>
+      <td align="center"><strong>Ethereum</strong><br><img src="assets/Ethereum.jpeg" width="150"/><br><code>0x51bc91022E2dCef9974D5db2A0e22d57B360e700</code></td>
+      <td align="center"><strong>Solana</strong><br><img src="assets/Solana.jpeg" width="150"/><br><code>9wjca3EQnEiqzqgy7N5iqS1JGXJiknMQv6zHgL96t94S</code></td>
+    </tr>
+  </table>
+</div>
+
+
+---
+
+<div align="center">
+    Licensed under <a href="LICENSE">GPL-3.0</a>
+</div>

analysis_options.yaml

@@ -0,0 +1,28 @@
+# This file configures the analyzer, which statically analyzes Dart code to
+# check for errors, warnings, and lints.
+#
+# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
+# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
+# invoked from the command line by running `flutter analyze`.
+
+# The following line activates a set of recommended lints for Flutter apps,
+# packages, and plugins designed to encourage good coding practices.
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  # The lint rules applied to this project can be customized in the
+  # section below to disable rules from the `package:flutter_lints/flutter.yaml`
+  # included above or to enable additional rules. A list of all available lints
+  # and their documentation is published at https://dart.dev/lints.
+  #
+  # Instead of disabling a lint rule for the entire project in the
+  # section below, it can also be suppressed for a single line of code
+  # or a specific dart file by using the `// ignore: name_of_lint` and
+  # `// ignore_for_file: name_of_lint` syntax on the line or in the file
+  # producing the lint.
+  rules:
+    # avoid_print: false  # Uncomment to disable the `avoid_print` rule
+    # prefer_single_quotes: true  # Uncomment to enable the `prefer_single_quotes` rule
+
+# Additional information about this file can be found at
+# https://dart.dev/guides/language/analysis-options