Uploading MIDI and Songs (Media Library)
Which files you can upload, size limits, where your files are stored, what "Local only" means, and how to use, delete and clean up uploads.
What you can upload
BallEngine accepts two kinds of music file. A MIDI file carries notes and timing, so the ball can bounce on each note. A Song is a normal audio file with no note data, so the Studio plays it in slices, one slice per bounce, or converts it to MIDI for you.
Separately, you can upload short sound effects for bounces and breaks (see Bounce and Break Sounds).
| File | Accepted formats | Size limit | Tag in your library |
|---|---|---|---|
| MIDI | .mid or .midi (standard MIDI files) | 10 MB per file | MIDI |
| Song (audio) | MP3 or WAV | 10 MB per file | Song |
| Bounce or break sound effect | MP3 or WAV | 10 MB per file | Shown under My Uploads |
Technical parameters
- The file picker may let you choose other audio formats (such as M4A, AAC or OGG), but only MP3 and WAV are accepted. Convert other formats to MP3 first.
- Files are checked on upload. A file whose content does not match its type is rejected with "File content does not match the expected type."
- A 3 minute MP3 at 192 kbps is about 4.3 MB. A WAV of the same length is roughly 30 MB, which is over the 10 MB limit, so prefer MP3 for full songs.
- MIDI names are shortened to 45 characters, song names to 80, sound effect names to 50.
Where to upload
There are several upload buttons. They all add to the same library, so use whichever is closest.
| Button | Where | Accepts | What happens after upload |
|---|---|---|---|
| Upload MIDI or Song | Inside the track picker (Audio section and Basics) | MIDI or audio | The file becomes the active track right away and the simulation restarts |
| Drop or Choose File | Media Library, in the Sound, MIDI & Audio Hub | MIDI or audio | Added to All Uploads. Press Use to make it active |
| Upload MIDI File | MIDI Workshop | MIDI only | Asks for a name if the Name field is empty, then makes it active |
| Upload MP3 | Bounce & Break Sounds, My Uploads source | MP3 or WAV | Asks for a sound name, then lists it under My Uploads |
| Upload custom MP3 | Basics, Sound effect choice | MP3 or WAV | Same as above |
The Media Library
The Media Library is the first part of the Sound, MIDI & Audio Hub. It shows every MIDI file and song you have uploaded or created in one list, All Uploads (N), newest first.
| Element | What it means |
|---|---|
| Song tag (green) | An audio file. Use loads it as the active track, played as slices. |
| MIDI tag (purple) | A MIDI file. Use makes it the active track and turns Music Sync on. |
| Full MIDI / YMIDI tag | MIDI that the Universal Audio Hub extracted from one of your songs. |
| Cloud (delete only) tag | A song whose audio is no longer available. It cannot be used, only deleted to free space. |
| Local only tag | Stored on this device only because your cloud storage was full. It syncs automatically once space frees up. |
| by <name> tag | Uploaded by a collaborator. Only the owner can delete it. |
| Use / In Use | Apply this file to the active mode. In Use marks the current one. |
| Bin icon | Delete the file from your library and cloud storage. Deleting a MIDI removes every copy with the same name. |
Tip
- A song uploaded on another device appears here too. The first time you press Use, the Studio fetches it, which can take a moment.
Where your files are stored
Uploads are stored in your BallEngine cloud storage on our servers, so they follow you to every device you sign in on and play for anyone you share a project with. Every upload counts toward your plan's storage: 250 MB on Free, 5 GB on Lite, 25 GB on Creator, 100 GB on Pro, 200 GB on Elite and 500 GB on Agency. Songs from the Song Library and the Built-in Tunes do not count.
If an upload would go over your storage, it is not lost. It is kept on this device only and marked Local only, and you see "Cloud storage full: saved on this device only." It works on this device straight away and syncs to the cloud once you free up space or upgrade. Until it syncs, it will not play on your other devices or for people who open your shared project.
Technical parameters
- Uploading the exact same file twice does not upload it again; the existing copy is reused.
- If a file uploads but its library entry cannot be saved, you see a warning that it is kept on this device only and will retry, instead of a success message.
Old Converted Songs
Some older accounts have a panel called Old Converted Songs in the Hub. These are duplicate records made by an older version of the uploader. Nothing uses them any more; they only take up cloud storage. The panel shows how much space they use and lets you delete them one by one or with Delete All Old Data (N). Deleting them is safe and cannot be undone. The panel hides itself when you have none.
More from BallEngine
Guides, plans and answers for making your videos.