How to open .LY files on iOS
To open .LY files on iOS, iOS does not typically compile LilyPond files locally; open the .ly file in a plain-text editor/viewer app to read it, or transfer it to a desktop system and compile with GNU LilyPond.
Step-by-step instructions
- iOS does not typically compile LilyPond files locally; open the .ly file in a plain-text editor/viewer app to read it, or transfer it to a desktop system and compile with GNU LilyPond.
Common issues
The file opens as unreadable text or symbols
.ly files are source code for LilyPond, not a finished score document. Opening it in a PDF viewer or office app will not show sheet music.
- Open the file in a plain-text editor to view/edit the LilyPond notation.
- Compile the file with GNU LilyPond to generate a readable score output (such as PDF).
Double-clicking does nothing or opens in the wrong app
Your system may not be associated with LilyPond or a text editor for .ly files.
- Set the default app for .ly to a text editor for editing, or use “Open with” to choose your preferred editor.
- Install GNU LilyPond if you need to compile the file into a score.
Compilation fails or produces errors
LilyPond is strict about syntax; a small typo or version mismatch can prevent successful engraving.
- Check the LilyPond error output to locate the failing line and fix the notation/syntax in the .ly file.
- If the file was generated by another tool (for example MusicXML conversion), re-generate it or adjust it to match your LilyPond version.
Security note
.ly files are plain text, but they are still parsed by LilyPond; treat files from unknown sources cautiously because malformed input can trigger parser/processing issues.