Developers / File Types

File Types

Direct Formats

With forScore, users primarily work with standard PDF files stored in the app’s Documents directory, but this is not the only file type forScore is compatible with. Users can also add audio files, images, and CSV indexes to their forScore library for use in a number of different ways. Support for these direct file types may either be full (publicly declared support and compatibility with iOS and iPadOS’ sharing protocols), or partial (the file can be added to forScore’s Documents directory and is usable within the app, but is not publicly declared or importable).

Name Identifier Support Purpose
Portable Document Format com.adobe.pdf
Full The primary content type; sheet music
Tracks may be linked to specific scores for automatic queueing and easier playback control, and WAV-format samples may be used instead of the default metronome sounds
Comma-Separated Values public.comma-separated-values-text
CSV indexes can be used to create bookmarks within scores; values are imported and not used directly
forScore Backup or Archive com.forScore.4sb
Backups contain a snapshot of forScore’s metadata, settings, and non-file content such as setlists; Archives also contain a copy of all files in forScore’s Documents directory (learn more here)
Portable Network Graphics public.png
Partial May be used in the Stamps creator to create custom annotation stamps

Transport Formats

Additional file types are used to move data but are not stored or displayed as-is. This includes custom file types, used to bundle forScore-specific information along with a user’s content, as well as formats that can be automatically converted to a supported format as a convenience.

Name Identifier Purpose
forScore Container com.forScore.4sc
Automatically unpacked as a PDF file upon import; may include forScore-specific metadata, annotations, versions, and more
forScore Setlist com.forScore.4ss
Automatically unpacked as a forScore setlist upon import; includes setlist information and may include scores as generic PDFs or as 4SC files with embedded metadata, annotations, and more
Text-Based Documents public.plain-text
Automatically converted to PDF files upon import


Drag & Drop Formats

Most compatible file types can be dropped into forScore from other apps, but the drop target and behavior varies based on the content type. Generally, files can be dropped where they’re used; CSV files can be dropped into the Indexes browser, 4SB files can be dropped into the Backups panel, and 4SS files can be dropped into the Setlists menu.

There is one major difference in file format handling when using Drag and Drop that’s specific to images: while forScore only recognizes and supports PNG images stored within its Documents directory, Drag and Drop allows users to work with many different image formats. Any file that conforms to Apple’s base image UTType of public.image (kUTTypeImage) can be dropped onto a page to be positioned and placed as an annotation, or dropped into the Stamp creator to be used to create a new custom stamp. The exact file types that are supported using this method depends on Apple’s APIs and are subject to change at any time.