forSheets (and giggles)

Setlist converter for forScore (.4ss) and MobileSheets (.mss).

Troubleshooting

Every failure below shows up in the converter's Warnings or match-report panel with the same wording — warnings never stop a partial conversion, so read them before re-exporting.

"My .msf / .msb files were rejected"

Those are proprietary MobileSheets bundles (song file / full library backup), not the open setlist format. In MobileSheets, long-press the setlist → Export setlist (.mss) to device storage (or Share it to yourself on another device; called Share song list on older versions) to get an .mss file, and supply the song PDFs separately. See the MobileSheets → forScore guide.

"Should I share or export the setlist?"

Both create the identical .mss file — only the delivery differs. Export saves to this device's storage (converting on the same tablet? use this). Share sends the file to another app such as mail or Drive (converting elsewhere? use this). Full comparison in the MobileSheets → forScore guide.

"PDFs alone cannot be converted"

On the MobileSheets → forScore path, PDFs without an accompanying .mss are rejected — there is no setlist structure to convert. Upload the .mss together with its PDFs; matching is by filename, case-insensitive.

"Everything is reference-only / nothing embedded"

For forScore → MobileSheets: the .4ss was shared Setlist Only (no scores inside). Re-share with Include Scores. For MobileSheets → forScore: no PDFs were attached, or filenames don't match the .mss entries. Check the report's unmatched-PDFs list for typos, and remember non-PDF media never embeds — it only marks entries as supplied.

"Illegal characters detected"

MobileSheets forbids \ / : * ? " < > | + , and control characters. The converter's warn mode lists every offender and offers keep / strip / replace before re-running. Prefer replace with _ when downstream tools dislike extension-less names.

"Some setlist songs import as blank placeholders"

MobileSheets matches an imported .mss by song title, and Batch Import titles each PDF from its file name. forSheets therefore titles every converted song from its file name, so they line up. Make sure you set the Batch Import Title option to "Use Filename as Title" and import the PDFs before the .mss. A warning names any song whose forScore title differed from its file name (for example a 2 duplicate suffix).

"My bookmark lands on the whole PDF"

Known limitation, not a bug: a bookmark always opens the entire parent PDF on the other side — page-specific bookmarks don't survive the trip. Use Bookmarks: suffixed to append " (bookmark)" to the title so the loss is visible at import.

"My placeholders vanished"

Vanishing placeholders are expected: with no MobileSheets counterpart they are dropped unless you pick Placeholders: blank (kept as Blank songs, FileType 5, which map back on return). Skipped ones are named in the bundle's IMPORT_ME.txt.

"SongIds disappeared"

forScore has no song-ID concept. The converter offers a songids.json sidecar download alongside MobileSheets → forScore results so the IDs aren't lost — but they can't be re-attached inside forScore, which has no song-ID field.

"Unrecognized native .4ss / nothing happens"

Native forScore 12+ files need gzip + binary-plist support. Use a current Chrome, Edge, Firefox, or Safari; very large selections convert locally too but may need extra browser memory (the page warns when that looks likely). Ad blockers change nothing about conversion — the converter references no ad globals.

Still stuck? Mail the direction, file types, and exact warning text — not your PDFs — to help@forsheets.app (see Contact).