Music Sharity

Warning

Currently only Android, Windows, Linux and Web builds are officially released and supported.

iOS and macOS 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, SoundCloud
• 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): Link

Option 2: Direct APK Download

1. Go to Releases
2. Download the latest music-sharity-x.y.z+<build>.apk
3. Enable "Install from unknown sources" in Settings
4. Install the APK

Linux

1. Go to Releases
2. Download music-sharity-x.y.z+<build>-amd64.deb or music-sharity-x.y.z-<build>-x86_64.rpm
3. Install the package
4. Run Music Sharity

Web

Warning

The web version shares a common rate limit (10 requests/minute) across all users. For heavy usage, consider installing the native app instead.

1. Go to https://music-sharity.byteroast.fr
2. Use it like this or install it as PWA (On Android devices the PWA can appear in the share fleet)

Windows

1. Go to Releases
2. Download music-sharity-x.y.z+<build>-windows-x64.msi
3. Install the program
4. Run Music Sharity

Other Platforms

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

• Lack of hardware for testing (no Mac)
• 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 or Android PWA 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
SoundCloud	Fully supported

Warning

SoundCloud limitations: Because SoundCloud does not contain all mainstream artists, converting from popular streaming platforms (Spotify, Apple Music, etc.) to SoundCloud will often fail. Converting from SoundCloud to other platforms may have better results.

Technical Details

Built with:

• Flutter - Cross-platform framework
• Material Design 3 - Modern UI design
• Odesli/song.link - Universal link conversion API
• Cloudflare Workers - Privacy-first CORS proxy (web version only)

Architecture:

• Native apps (Android, Linux, Windows): Direct API calls to Odesli (zero intermediaries)
• Web app: Privacy-first CORS proxy via Cloudflare Workers (zero logging, zero tracking)
• No API keys required - fully open source friendly
• No user data collection
• No tracking or analytics
• Proxy source code: music-sharity-proxy

Privacy infrastructure:

• Native apps: Direct API communication
• Web app: Stateless edge proxy with no data retention
• All code is open source and auditable

Note

Due to Odesli API restrictions, the application is limited to 10 requests per minute. A rate limiting mechanism is implemented to ensure smooth operation within this constraint.

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

Platform-specific requirements:

• Linux: dpkg-deb, rpmbuild, GTK3 development libraries
• Windows: WiX Toolset for MSI packaging

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:

# Android
flutter run

# Windows
flutter run -d windows

# Linux
flutter run -d linux

# Web
flutter run -d chrome

Build with Scripts

Build scripts are available in installer/ for each platform with support for release/debug targets:

Android

# Linux/macOS
./installer/android/build.sh --target release --clean true

# Windows (PowerShell)
.\installer\android\build.ps1 -Target release -Clean true

Output: dist/android/music-sharity-x.y.z+<build>.apk (+ .aab for release)

Linux

./installer/linux/build.sh --target release --clean true

Output: dist/linux/x64/music-sharity-x.y.z+<build>-amd64.deb and .rpm

Windows

.\installer\windows\build.ps1 -Target release -Clean true

Output: dist/windows/x64/music-sharity-x.y.z+<build>-windows-x64.msi

Script Options

Option	Values	Default	Description
--target / -Target	release, debug	release	Build configuration
--clean / -Clean	true, false	true	Run flutter clean before build
--help / -Help	-	-	Show help message

Note: Debug builds only create the Flutter bundle, not installer packages.

Contributing

Contributions are welcome! Especially for:

• iOS/macOS support (need Mac owners!)
• Web optimizations
• 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