This application serves as a demonstration of modern mobile development techniques and API integration.
Orbit isn't just another music app—it's a revolution in how you experience sound. Built with passion and cutting-edge technology, Orbit delivers a premium, uninterrupted listening experience that puts your musical journey first.
- 🎵 Music-First Experience — Focused on delivering the best music experience
- 👆 Intuitive Gesture Controls — Swipe, tap, and pinch for seamless navigation
- 🌐 Multi-Source Playback — Stream from JioSaavn API or play local files
- 📱 Offline Mode — Download and listen without an internet connection
- 🌙 Dark & Light Themes — Choose your preferred viewing experience
- 🎧 Background Playback — Keep the music going while using other apps
- 🔍 Smart Search — Find songs, albums, and artists quickly
- 🔒 Privacy Focused — No unnecessary permissions or data collection
- 💽 Local Music Library — Play songs stored on your device
- 🎶 Dynamic Queue Management — Easily manage your playback queue
- 📊 Sleep Timer — Fall asleep to your favorite tunes
- 🔄 Seamless Playback — Smooth transitions between tracks
- 📡 Network Monitoring — Automatically adjusts quality based on connection
- 🎨 Customizable UI — Personalize your music experience
In a world cluttered with subscription-based streaming services and ad-interrupted experiences, Orbit stands as a beacon of what music apps should be: focused on the music, not monetization. Every design decision, every line of code, serves to enhance your connection with the artists and songs you love.
Become part of a growing community of music enthusiasts and developers! Share ideas, get help, and contribute to making Orbit even better.
Orbit leverages the power of modern technology to deliver a seamless experience:
- React Native - Cross-platform development with native performance
- React Native Track Player - Advanced audio playback capabilities
- React Native Reanimated - Buttery smooth animations and gestures
- JioSaavn API - Access to a vast library of songs and playlists
- React Navigation - Seamless screen transitions and deep linking
- Redux - Predictable state management
- React Native Vector Icons - Beautiful, consistent iconography
- React Native Gesture Handler - Intuitive gesture controls
- React Native Reanimated - High-performance animations
Transform your device into a music powerhouse in minutes:
- Node.js 18+ (LTS version recommended)
- npm 9+ or Yarn 1.22+
- React Native development environment
- For Android: Android Studio with Android SDK
- For iOS: Xcode 13+ (macOS only)
- Git for version control
-
Clone the repository
git clone https://github.com/gauravxdev/Orbit.git cd Orbit -
Install dependencies
npm install # or yarn install -
Setup environment
- Copy
.env.exampleto.envand configure your environment variables - For Android, create
android/local.propertieswith your Android SDK path:sdk.dir = /path/to/your/android/sdk
- Copy
-
Run the app
# Android npx react-native run-android # iOS (macOS only) cd ios && pod install && cd .. npx react-native run-ios
- High-quality audio streaming from multiple sources
- Background playback with media controls
- Queue management and playlist support
- Sleep timer for automatic playback stop
- Beautiful, intuitive interface with smooth animations
- Light and dark theme support
- Customizable player interface
- Gesture-based controls for easy navigation
- Smart search across songs, albums, and artists
- Discover new music by genre, mood, and popularity
- Download songs for offline listening
- Local music library integration
- Cache management for efficient storage use
- Audio quality settings
- Theme customization
- Gesture controls configuration
- Storage management
We're constantly working to improve Orbit and add new features. Here's what's coming soon:
- Enhanced offline experience with background downloads
- Cross-device sync for playlists and preferences
- Improved lyrics synchronization
- More customization options for the player UI
- Collaborative playlists
- Podcast support
- Sleep timer with fade-out effect
- More integration with music services
Have an idea for Orbit? Open an issue to suggest new features or vote on existing ones!
We welcome contributions from the community! Whether you're a developer, designer, or just passionate about music, there are many ways to contribute:
-
Report Bugs
- Check if the bug has already been reported in issues
- If not, create a new issue with detailed steps to reproduce
-
Suggest Enhancements
- Open an issue with the "enhancement" label
- Clearly describe the proposed feature and its benefits
-
Code Contributions
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the existing code style
- Write clear commit messages
- Add tests for new features
- Update documentation as needed
- Keep PRs focused on a single feature or bugfix
Orbit is open source software licensed under the MIT License. See the LICENSE file for the full text.
MIT License
Copyright (c) 2024 Gaurav Saini
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Orbit is an open-source music player application designed for educational purposes. This application is not affiliated with, endorsed by, or connected to any music streaming service or record label.
- All music, images, and other media content available through this application are the property of their respective owners.
- Orbit does not host any audio files. The app acts as a client to stream music from third-party sources.
- Users are responsible for ensuring they have the right to access and play the content through this application.
By using Orbit, you agree to:
- Use the application for personal, non-commercial purposes only
- Not redistribute or modify the content obtained through the application
- Comply with all applicable laws and regulations in your jurisdiction
Orbit respects the intellectual property rights of others. If you believe that any content in the application infringes your copyright, please contact us with the following information:
- A description of the copyrighted work that you claim has been infringed
- The URL or other specific location of the content
- Your contact information
- A statement that you have a good faith belief that the use is not authorized by the copyright owner
🎵 Created with ❤️ by Gaurav Saini 🎵
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}