music-sharity

Music Sharity

[!WARNING] Currently only Android and Windows builds are officially released and supported.

iOS, macOS, Linux, and Web builds are technically functional but not actively maintained due to hardware limitations (no Mac ownership). Community contributions for these platforms are welcome!

Music Sharity is a cross-platform app that converts music links between different streaming services instantly.

Screenshots

Features

• 🎵 Convert between 5 platforms: Spotify, Deezer, Apple Music, YouTube Music, Tidal
• 📀 Supports tracks and albums
• 🔄 Fast conversion: Powered by Odesli API
• 📱 Native Android sharing: Appears in the share menu
• 🔒 Privacy-focused: No API keys, no data collection, no tracking

Installation

Android

Option 1: Google Play Store (Recommended)

[Coming soon - Link to Play Store]

Option 2: Direct APK Download

1. Go to Releases
2. Download the latest music-sharity-x.y.z.apk
3. Enable “Install from unknown sources” in Settings
4. Install the APK

Windows

1. Go to Releases
2. Download music-sharity-windows-x.y.z.zip
3. Extract and run music_sharity.exe

Other Platforms

While iOS, macOS, Linux, and Web builds can be compiled, they are not officially supported at this time due to:

• Lack of hardware for testing (no Mac)
• Limited platform-specific optimizations
• No active maintenance

Community contributions are welcome! If you have the hardware and want to help maintain these platforms, please open an issue or PR.

How to Use

Method 1: Share from Music App (Android only)

1. Open Spotify, Deezer, or any supported music app
2. Find a track or album you want to share
3. Tap the Share button
4. Select Music Sharity from the share menu
5. Choose your destination platform
6. Share the converted link!

Method 2: Manual Link Conversion

1. Open Music Sharity
2. Paste your music link in the text field
3. Click Convert
4. Select your destination platform
5. Share or copy the converted link

Supported Platforms

Platform	Status
Spotify	✅ Fully supported
Deezer	✅ Fully supported
Apple Music	✅ Fully supported
YouTube Music	✅ Fully supported
Tidal	✅ Fully supported

Technical Details

Built with:

• Flutter - Cross-platform framework
• Material Design 3 - Modern UI design
• Odesli/song.link - Universal link conversion API

Architecture:

• All conversions powered by the Odesli API
• No API keys required - fully open source friendly
• No user data collection
• No tracking or analytics

Privacy

Music Sharity does not collect or store any personal data.

• ✅ No user accounts
• ✅ No tracking
• ✅ No analytics
• ✅ No ads
• ✅ All conversions happen in real-time via Odesli

Read our Privacy Policy for details.

Build from Source

Prerequisites

• Flutter SDK (3.10+)
• Android Studio or VS Code

Setup

1. Clone the repository:

   git clone https://github.com/byteroast/music-sharity.git
   cd music-sharity
   

2. Install dependencies:

   flutter pub get
   

3. Run the app: ```bash

   Android

   flutter run

Windows

flutter run -d windows

Web (experimental)

flutter run -d chrome

4. **Build release:**
```bash
# Android APK
flutter build apk --release

# Windows
flutter build windows --release

Contributing

Contributions are welcome! Especially for:

• 🍎 iOS/macOS support (need Mac owners!)
• 🌐 Web optimization
• 🎵 New platform integrations
• 🐛 Bug fixes

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

This means:

• ✅ You can use, modify, and distribute this software
• ✅ You must keep the same license (GPL v3)
• ✅ You must disclose the source code
• ✅ Changes must be documented

Author

Sikelio (Byte Roast)

• GitHub: @sikelio

Acknowledgments

• Flutter - Amazing cross-platform framework
• Odesli - Universal music link conversion API
• All contributors and testers!

Support

If you find this project useful, please consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs
• 💡 Suggesting features
• 🤝 Contributing code

This site is open source. Improve this page.