Frequently Asked Questions

Everything you need to know about installing, verifying, and getting the most out of Melophile.

Why does Windows SmartScreen warn about Melophile?

When you launch MelophileSetup.exe for the first time, Windows Defender SmartScreen may display a blue dialog stating:

"Windows protected your PC — Microsoft Defender SmartScreen prevented an unrecognized app from starting."

Why this happens: Commercial software developers purchase expensive EV (Extended Validation) code-signing certificates from certificate authorities (costing hundreds of dollars annually) so Microsoft builds automatic reputation. Because Melophile is an independent, non-commercial, private project distributed among friends, releases are not signed with an EV certificate.

How to run it:

  1. Click the small underline link labeled "More info" on the SmartScreen dialog.
  2. A new button labeled "Run anyway" will appear at the bottom right.
  3. Click "Run anyway" to proceed with the launch or installation.

You can always verify the authenticity of your download by comparing its SHA-256 hash against the official checksum published on our download page (see below).

How do I install the Android APK ("Unknown Sources")?

Because Melophile is distributed directly as an APK outside Google Play Store, Android requires you to authorize side-loading:

  1. Download the melophile_final.apk file to your device.
  2. Tap the downloaded file in your browser or File Manager.
  3. If Android displays a prompt saying "For your security, your phone is not allowed to install unknown apps from this source", tap Settings.
  4. Toggle the switch for "Allow from this source".
  5. Press the back button and tap Install.

Melophile does not require root access or any invasive device permissions.

How do I verify the SHA-256 checksum of downloaded files?

You can verify that your downloaded file has not been altered or corrupted by running a SHA-256 hash check.

On Windows (PowerShell):

Get-FileHash -Algorithm SHA256 .\MelophileSetup.exe

On Linux or macOS (Terminal):

sha256sum MelophileSetup.exe

Compare the printed hash string with the official SHA-256 hash shown on the Download page. If the characters match identically, your file is authentic.

What streaming and audio formats does Melophile support?

Local Audio Files:

FLAC, MP3, AAC (M4A), Ogg Vorbis, Opus, WAV, and AIFF.

Streaming & Online Links:

YouTube Music track URLs, playlist URLs, album URLs, and YouTube watch links (e.g., https://music.youtube.com/watch?v=...). You can paste any valid link directly into Melophile's search bar or command palette.

How does Melophile Connect & Jam work between PC and Android?

Melophile uses zero-configuration mDNS local discovery on your home Wi-Fi network. When your PC and Android phone are on the same Wi-Fi subnet, they automatically discover each other without any manual IP configuration.

If your Wi-Fi router blocks multicast or peer-to-peer traffic (AP isolation), Melophile automatically falls back to our encrypted cloud relay server on Cloudflare Workers, allowing seamless room sync across different networks.

How do I get an invite code?

Melophile is currently in an invite-only private preview for personal testing among friends. If you know the developer personally, reach out directly or via our community channels:

• Email: hello@melophile.app
• Discord: Join our Discord Community (TODO-CONFIRM)

How do I report a bug or suggest a feature?

If you experience a crash or unexpected behavior:

  • PC: Check the crash report generated in your Melophile installation directory or launch the app with console logging enabled.
  • Android: Note the device model and Android version, and copy the stack trace if prompted by the crash dialog.
  • Send bug reports directly to the maintainer via Discord or email with reproduction steps.