If something's not working, scan this article first — most common issues have a 30-second fix.
App won't open / crashes on launch
- Quit the app completely (Cmd+Q in the menu bar — not just close the window).
- Re-launch from Applications.
- If it still crashes: open Console.app (in /Applications/Utilities/), filter for "MusicLaunch", look at the latest crash report, and email it to hello@musiclaunchapp.com.
A scheduled post didn't go out
- Open the Content Calendar: the post is under "Needs attention" with the reason. Use "Publish now" or "Reschedule", or "Delete" if you no longer want the post ("Dismiss" only takes it off the list).
- A TikTok post that reads "Sent to TikTok" did go out: it is a notification in TikTok's Inbox, not in your Drafts folder. Tap the notification to finish and post it.
- Scheduled posts only go out while MusicLaunch is running. Closing the window is fine (it stays in the menu bar); quitting it, or a Mac that is asleep or off, pauses them.
- A post less than 24 hours late goes out when MusicLaunch next runs. A later one is marked Failed so nothing goes out days late without you knowing.
- Turn on Settings → Posting → "Open MusicLaunch at login" so it is always in the menu bar.
- "Not connected": reconnect the account in Social Hub → Connect Accounts, then publish the post again.
- Instagram needs a photo, TikTok a photo or video, YouTube a video.
- X, Threads and Bandcamp posts are reminders: MusicLaunch can't post there by itself.
- "Check this one" means MusicLaunch was interrupted while posting. Look at the platform before you publish again, so it doesn't go out twice.
License activation fails with "Couldn't reach the license server"
- Check your internet connection.
- Visit https://www.musiclaunchapp.com in your browser — if it loads, our server is up.
- Check that nothing is blocking outbound HTTPS to musiclaunchapp.com (firewall, VPN, corporate proxy).
- Wait 30 seconds and try again — sometimes our server briefly hiccups.
MusicLaunch says your license is active on another Mac
Your license works on one Mac at a time. On the other Mac, open Settings → License → Deactivate. If you no longer have that Mac or it won't start, or if the "other Mac" is this one because you erased it and set it up again, go to musiclaunchapp.com/license and, under "Old Mac lost, broken or already wiped?", click "Email me a link to free up my license." Open the emailed link and confirm, then enter your key again here.
My old Mac says my license is no longer active
That's expected after you move MusicLaunch to a new Mac or free up your license on our website. Your data is still on the old Mac. To use the old Mac again instead, deactivate on the new Mac first, then enter your key on the old one.
I can't find my license key
Search your email (including spam) for "Your MusicLaunch License Key". Still missing? Go to musiclaunchapp.com/license and we'll email it again to the address you used to buy MusicLaunch.
Connecting an account opens the browser but never returns to the app
Quit MusicLaunch completely (Cmd+Q), re-launch, and try connecting again. A fresh launch re-registers MusicLaunch with macOS so the browser can hand you back to the app.
Instagram post opened in the browser instead of posting ("Image upload failed")
- Instagram only accepts posts with an image, and the image has to be reachable at a web address. So when you post, MusicLaunch uploads a copy of the image to our image hosting (it's deleted automatically within about two days) and gives Instagram that link. The upload uses your license, so it needs an active license.
- MusicLaunch converts and resizes common photo formats for you (JPG, PNG, WebP, and HEIC photos from an iPhone). If a HEIC photo can't be converted, export it as a JPG and try again.
- Check your internet connection — the upload needs it.
- If the upload fails, MusicLaunch copies your caption and opens Instagram so you can post by hand. If you see 'Image hosting needs an active license' or that MusicLaunch couldn't confirm your license, open Settings → License, click "Refresh subscription status", then post again. If it keeps failing, email hello@musiclaunchapp.com.
Your team says "You've used this month's allowance"
You've used your plan's monthly allowance. It starts again on the 1st of next month. The message has an "Upgrade plan" button that opens the page for switching plans (on All Access there is no bigger plan, so it shows the reset date only). To get more capacity sooner, move to a bigger plan: Settings → License → "Manage subscription", pick the new plan, then click "Refresh subscription status". (During the included 30 days or the encore week, the message says you've used this month's allowance included with them; click "Get a subscription" in Settings → License to keep going. Your first subscription, on any plan, starts a fresh monthly allowance right away: what your team used before it began doesn't count against it.)
Email sending fails with "Gmail not connected"
Settings → Gmail Integration → Connect. In a New Submission (pitch) window, you can click "Connect Gmail" next to Send via Gmail instead, without losing what you typed. Once connected, retry sending. If it still fails after connecting, your Gmail account may have hit its daily send limit (~500/day for free Gmail).
Where do I find my data?
Your MusicLaunch data lives at: ~/Library/Application Support/MusicLaunch/profiles/<profile-id>/ — to navigate there in Finder, hit Cmd+Shift+G, paste the path up to profiles/, and open the folder for your profile. Inside it, data/musiclaunch.db is your database, backups/ holds auto-backups, and media/ holds your imported media.
Still stuck?
Something not working? Help → Report a Problem… in the menu bar (or Report a problem at the bottom of this Help page) opens an email to us with your app version and Mac details filled in. Have an idea? Help → Suggest a Feature… starts an email to us about it.
Email hello@musiclaunchapp.com. We read every message. Include: your macOS version (Apple menu → About This Mac), MusicLaunch version (Settings → About), and a screenshot of any error.
