TuneBridge

TuneBridge is a cross-platform music link converter and lookup service that bridges Apple Music, Spotify, and Tidal. It provides both a web interface and a Discord bot for seamless music sharing across different streaming platforms.

Features

  • 🎵 Music Link Conversion: Convert music links between Apple Music, Spotify, and Tidal
  • 🔍 Multiple Lookup Methods: Search by URL, ISRC, UPC, or title/artist
  • 🤖 Discord Bot Integration: Automatically detect and convert music links in Discord messages
  • 🌐 Web API: RESTful API endpoints for programmatic access
  • 🖥️ Web Interface: Simple browser-based UI for manual lookups
  • 🐳 Docker Support: Easy deployment with Docker containers

What It Does

TuneBridge acts as a universal translator for music streaming services. When you share a music link (song or album) from Apple Music, Spotify, or Tidal, TuneBridge automatically finds the equivalent content on the other platforms.

The application uses official APIs from all services to ensure accurate matching through standardized identifiers (ISRC for tracks, UPC for albums). When matches cannot be found via external IDs, the application performs fuzzy matching using metadata to find the equivalent content.

Configuration

Environment Variables

TuneBridge requires API credentials for at least one music provider (Apple Music, Spotify, or Tidal). Discord integration is optional.

Variable Description Required
APPLE_TEAM_ID Your Apple Developer Team ID No*
APPLE_KEY_ID Your Apple Music API Key ID No*
APPLE_KEY_PATH Path to your Apple Music private key (.p8 file) No*
SPOTIFY_CLIENT_ID Your Spotify API Client ID No*
SPOTIFY_CLIENT_SECRET Your Spotify API Client Secret No*
TIDAL_CLIENT_ID Your Tidal API Client ID No*
TIDAL_CLIENT_SECRET Your Tidal API Client Secret No*
DISCORD_TOKEN Your Discord bot token No**

* At least one complete set of music provider credentials is required (Apple Music, Spotify, or Tidal)
** Required only if using Discord integration

Optional Environment Variables

Variable Description Default
NODE_NUMBER Node number for Discord sharding 0
ALLOWED_HOSTS Allowed hosts for the web server *
DEFAULT_LOGLEVEL Default logging level Information
HOSTING_DEFAULT_LOGLEVEL ASP.NET hosting logging level Information

Obtaining API Credentials

Apple Music API Credentials

  1. Visit the Apple Developer Portal
  2. Follow the guide to Create a Media Identifier and Private Key
  3. Download your .p8 private key file
  4. Note your Team ID and Key ID

Spotify API Credentials

  1. Visit the Spotify Developer Dashboard
  2. Follow the guide to Register Your App
  3. Note your Client ID and Client Secret

Tidal API Credentials

  1. Visit the Tidal Developer Portal
  2. Create a new application to get API access
  3. Note your Client ID and Client Secret

Discord Bot Token

  1. Visit the Discord Developer Portal
  2. Follow the Getting Started Guide
  3. Create a bot and copy its token
  4. Invite the bot to your server with appropriate permissions (Read Messages, Send Messages, Embed Links, Manage Messages)

Running the Application

  1. Set your environment variables:
export APPLE_TEAM_ID="your_team_id"
export APPLE_KEY_ID="your_key_id"
export APPLE_KEY_PATH="/app/key.p8"
export SPOTIFY_CLIENT_ID="your_client_id"
export SPOTIFY_CLIENT_SECRET="your_client_secret"
export TIDAL_CLIENT_ID="your_tidal_client_id"
export TIDAL_CLIENT_SECRET="your_tidal_client_secret"
export DISCORD_TOKEN="your_bot_token"
  1. Build and run with Docker:
docker build -t tunebridge .
docker run -p 10000:10000 \
  -e APPLE_TEAM_ID \
  -e APPLE_KEY_ID \
  -e APPLE_KEY_PATH \
  -e SPOTIFY_CLIENT_ID \
  -e SPOTIFY_CLIENT_SECRET \
  -e TIDAL_CLIENT_ID \
  -e TIDAL_CLIENT_SECRET \
  -e DISCORD_TOKEN \
  -v /path/to/your/AuthKey_KEYID.p8:/app/key.p8 \
  tunebridge

Important: The APPLE_KEY_PATH environment variable must match the container mount path (/app/key.p8 in this example).

The application will be available at http://localhost:10000

Running Locally

  1. Install .NET 9.0 SDK

  2. Update appsettings.json with your credentials:

{
  "TuneBridge": {
    "NodeNumber": 0,
    "AppleTeamId": "your_team_id",
    "AppleKeyId": "your_key_id",
    "AppleKeyPath": "/path/to/AuthKey.p8",
    "SpotifyClientId": "your_client_id",
    "SpotifyClientSecret": "your_client_secret",
    "TidalClientId": "your_tidal_client_id",
    "TidalClientSecret": "your_tidal_client_secret",
    "DiscordToken": "your_bot_token"
  }
}
  1. Build and run:
dotnet build
dotnet run

The application will start on the default ASP.NET Core ports (usually 5000/5001).

API Endpoints

Web Interface

  • GET / - Web-based lookup interface

Music Lookup API

All endpoints accept POST requests with JSON payloads:

Lookup by URL (List)

POST /music/lookup/urlList
Content-Type: application/json

{
  "uri": "https://music.apple.com/us/album/..."
}

Lookup by URL (Streaming)

POST /music/lookup/url
Content-Type: application/json

{
  "uri": "https://music.apple.com/us/album/..."
}

Lookup by ISRC

POST /music/lookup/isrc
Content-Type: application/json

{
  "isrc": "USVI20000123"
}

Lookup by UPC

POST /music/lookup/upc
Content-Type: application/json

{
  "upc": "123456789012"
}

Lookup by Title/Artist

POST /music/lookup/title
Content-Type: application/json

{
  "title": "Song Name",
  "artist": "Artist Name"
}

Discord Bot Usage

Once invited to your Discord server, the bot will automatically:

  1. Monitor messages for Apple Music, Spotify, and Tidal links
  2. Look up the corresponding track/album on the other platforms
  3. Reply with an embedded message containing links to all available services
  4. Deletes the original message (if it only contained music links [keeping the channel clean])

Deployment

Public Hosting

The application exposes port 10000 by default and is designed to be deployed behind a reverse proxy. Common deployment options include:

  • Container platforms (Docker, Kubernetes)
  • Cloud services (Azure Container Apps, AWS ECS, Google Cloud Run)
  • Platform-as-a-Service (Heroku, Railway, Render)

Note: Public hosting location is TBD.

Technology Stack

  • .NET 9.0 - Cross-platform framework
  • ASP.NET Core - Web framework
  • NetCord - Discord bot library
  • Apple MusicKit API - Apple Music integration
  • Spotify Web API - Spotify integration
  • Tidal API - Tidal integration

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Taylor Marvin

Edit this page