Upload Issues

Upload stuck at 0%

Check your internet connection. If the connection is stable, try reconnecting the platform account in Settings > Connections.

YouTube upload failed

Check if you've exceeded your API quota. Verify your YouTube API credentials are configured correctly in Settings. See guide.

BeatStars upload failed

Sessions expire periodically. Go to Settings > Connections and reconnect BeatStars. This is normal behavior - BeatStars sessions typically last a few hours and need to be refreshed.

Video upload quality is lower than expected

Platforms may process videos at lower quality initially. YouTube typically takes several hours to process HD and 4K versions after upload.

Connection Issues

Can't connect YouTube

Make sure you've set up API credentials first. BeatOps requires YouTube API credentials to upload. See setup guide.

BeatStars keeps disconnecting

Sessions expire after a few hours. Simply reconnect when prompted in Settings > Connections. This is expected behavior and not a bug.

Authorization error

Try revoking and re-authorizing the connection in Settings > Connections. Click the disconnect button, then reconnect.

OAuth redirect error

Make sure BeatOps is running when you complete the OAuth flow. The browser redirects back to the app, which needs to be open to receive the authorization.

Generation Issues

Thumbnail generation failed

Check that your image source is valid. If using auto image search, make sure you have an internet connection. Try uploading your own image instead.

Video generation taking too long

Large audio files take longer to process. Check that you have sufficient available disk space. Video generation can take 1-2 minutes for longer beats.

Audio analysis not detecting correct BPM

You can manually edit the BPM in the beat details. Click on the BPM field to override the detected value.

Template variables not filling in

Make sure your beat has all the required metadata fields filled in. Check that your template syntax is correct (e.g., {{ title }}, {{ bpm }}).

General

App won't start

Try restarting your computer. Check that your system meets the minimum requirements. If the issue persists, contact support.

Where is my data stored?

All your data is stored locally on your computer. BeatOps runs 100% locally - your beats and metadata never leave your machine except when you explicitly upload to platforms. Read our Privacy Policy.

How do I update BeatOps?

BeatOps will notify you when updates are available. You can also check for updates in Settings > About.

Can I use BeatOps offline?

Most features work offline except for uploads, auto image search, and API credential setup. You can generate content offline and upload later when you have internet.