🎵 Xarin Music Player

A modern Flutter music player app. Built with Flutter, designed for simplicity, and packed with features like metadata reading, album art display, and playlist management.

---

✨ Features

• 🔐 User Authentication – Secure login with credentials saved locally.
• 📥 Automatic Downloads – Missing songs are auto-downloaded and synced with xarin_data.json.
• 🗂 Playlist Management – Create, edit, and play from custom playlists.
• 🎶 Music Player – Play, pause, and navigate between tracks.
• 🖼 Album Art & Metadata – Extracts title, artist, duration, and cover image.
• 🔄 Sync with Server – Keeps local library up to date with server data.
• 📱 Beautiful UI – Carousel slider for albums, smooth navigation, and clean design.

---

📸 Screenshots

---

🚀 Getting Started

1. Prerequisites

• Flutter SDK (3.0+ recommended)
• Android Studio / VS Code with Flutter plugin
• Device/emulator with Android 7.0+

2. Clone the Project

git clone https://github.com/your-username/xarin-music-player.git
cd xarin-music-player

3. Install Dependencies

  cupertino_icons: ^1.0.8
  web_socket_channel: ^3.0.1
  just_audio: ^0.9.42
  audio_session: ^0.1.13
  permission_handler: ^12.0.1
  audio_metadata_reader: ^1.4.2
  carousel_slider: ^5.1.1
  file_selector: ^1.0.3

flutter pub get

4. Run the App

flutter run

---

📂 Project Structure

lib/
 ├── main.dart              # Entry point
 ├── login.dart             # Login screen
 ├── register.dart          # Registeration page
 ├── profile.dart           # Credentials handling
 ├── constants.dart         # Global constants
 ├── music_player.dart      # Music player UI
 ├── HomePage.dart          # Homepage with playlists
 └── widgets/               # Reusable widgets

---

🛠 Tech Stack

• Flutter – Cross-platform UI
• Dart – Core language
• just_audio – Music playback
• audio_metadata_reader – Metadata & album art
• carousel_slider – Album carousel UI
• permission_handler – Storage access
• file_selector – File picking

---

🤝 Contributing

Contributions are welcome!
Feel free to fork the repo and submit a PR with improvements.

---

📜 License

This project is licensed under no license! enjoy and share it.

---

👨‍💻 Author

Developed with ❤️ by [Amin & Behrad]