Skip to content

README.md

Latest commit

 

History

History
226 lines (167 loc) · 8.13 KB

README.md

File metadata and controls

226 lines (167 loc) · 8.13 KB

Apollo Logo

Apollo Apollo Cat

Apollo is a cross-platform music player for Android and iOS, featuring a clean and minimal UI, support for importing local files, light and dark themes, and a playful cat that dances to the beat while your music plays. (V2 offers UI enhancements, a mini player, a search bar, and more settings options.)

Flutter 3.13 Dart 3.3 Android Available iOS Coming Soon License: MIT

🎵 Project Vision

Apollo brings music to life on mobile devices. Its minimalist interface allows you to focus on your music while enjoying interactive features, such as:

  • Importing your local music files
  • Switching between light and dark themes
  • Watching a playful cat dance along with your beats

Apollo is free for everyone and provides a fun, immersive music experience.

✨ Download & Links

📸 Screenshots

Home Page Song Page Drawer Settings

Apollo features both light and dark themes for comfortable listening

Design Credits: Song page neumorphic UI design inspired by Mitch

🌟 Features

  • Cross-Platform: Flutter-based app for Android and iOS (iOS coming soon)
  • Local Music Support: Import and play your own music files
  • Themes: Light and dark mode for comfortable listening
  • Beat Animation: A dancing cat reacts to your music
  • Minimal UI: Intuitive, clean, and modern interface
  • Free to Use: No hidden costs

🖥️ Technology Stack

  • Framework: Flutter for cross-platform development
  • Programming Language: Dart
  • UI: Custom light and dark themes, animated widgets
  • Audio: Local file support and music playback features
  • Hosting: PythonAnywhere for web interface and APK downloads

🚀 Getting Started

Prerequisites

  • Flutter SDK 3.13+
  • Android Studio / Xcode (for iOS build)
  • Git

Installation (for development)

  1. Clone the repository:

    git clone https://github.com/Rexaintreal/Apollo.git
cd Apollo

  2. Install dependencies:

    flutter pub get

  3. Build for your platform:

    flutter run

📂 Project Structure

Apollo/
├── android/
├── ios/
├── lib/                # Dart source code
├── assets/             # Logo, screenshots, images
├── web/
├── windows/
├── macos/
├── linux/
├── pubspec.yaml
├── README.md
└── LICENSE

⚡ What’s New (v2.0)

ApolloV2 is here with exciting new updates 🎉

  • Mini Player: Control your music seamlessly while browsing the app
  • Customizable Settings: More options to personalize your listening experience
  • UI Improvements: Cleaner, smoother, and more polished design
  • Search Bar: Quickly find your favorite songs
  • Error Handling: Better stability and smoother user experience

Download APK

⚡ What’s New (v2.5)

Apollo V2.5 is here with even more fun updates 🎉

  • More Cats 🐱: Added 10+ new cats to choose from
  • Customizable Cat Settings: Adjust motion, opacity, and size of your dancing companion
  • Improved Settings Page: Cleaner and more organized options
  • Bug Fixes & Performance Improvements

📸 Screenshots (v2)

Home Page Dark Song Page Dark Drawer Dark Settings Dark

New polished UI with Mini Player & Customizable Settings in v2.0

🔮 Future Plans

  • iOS Release: Full support for Apple devices
  • Playlist Management: Create, edit, and share playlists
  • Online Streaming: Support cloud music streaming
  • More Animations: Enhanced interactive beat animations
  • Performance Optimizations: Smoother playback and transitions

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a branch: git checkout -b feature/amazing-feature
  3. Make your changes
  4. Commit: git commit -m 'Add some amazing feature'
  5. Push: git push origin feature/amazing-feature
  6. Open a Pull Request

📜 License

This project is licensed under the MIT License.

💡 You may also like...

👨‍💻 Author

Apollo was created by Saurabh Tiwari