> For the complete documentation index, see [llms.txt](https://handbook.musescore.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://handbook.musescore.org/file-management/convert-a-file.md).

# Convert a file

### Overview

MuseScore Studio can turn sheet music into an editable score using optical music recognition (OMR). Start from a PDF, a scan or a photo, and you'll get a normal MuseScore Studio score that you can edit, play back and export, without leaving the app.

You can also convert an audio file or a YouTube or Audio.com link (beta).

Converting is free, with reasonable usage limits in place to prevent abuse. You will need a free MuseScore.com account.

Please only convert music you have the right to use, such as your own work or music in the public domain. Converting is covered by the MuseScore.com [Terms of Use](https://musescore.com/legal/terms).

> **Using an older version?** In versions before 4.7.6, **Import PDF** opens the upload page on MuseScore.com in your browser instead. Update to convert inside the app.

### Convert sheet music into a score

![Screenshot showing the file import dialogue. The dialogue contains options to select a file or to convert from a pasted link.](https://3455969201-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP81HaeapLzzJGtG6DSwH%2Fuploads%2F3V1hHgsqoz5L1sPEn3ar%2Fimport-file.png?alt=media\&token=8cac2899-37fa-42bf-8865-486b67ce2a4d)

1. Open MuseScore Studio and go to **Home -> Scores**.
2. Click **Convert**.
3. Select one or more files, or click **Convert from link** then press `Ctrl`+`V` (Mac: `Cmd`+`V`) to paste in a YouTube or Audio.com link.
4. If prompted, sign in to your MuseScore.com account.
5. Keep working while your files convert, and follow each file's progress in the notification in the corner of the window.
6. When a score is ready, click **Open** in the notification.
7. Rate the conversion to help improve the feature.

Converted scores are saved as private scores in your MuseScore.com account. Only you can see them unless you choose to share them, and you can save a copy to your computer like any other score.

MuseScore Studio reads the notes from the image, so the cleaner the page, the better the result. Unclear scans, unusual notation and very dense scores can cause recognition errors.

You can also convert a file at any time by clicking **File** -> **Convert file...**

### Accepted file formats

Accepted formats include PDF, JPEG, PNG, MP3, WAV and FLAC. Audio imports are in beta and recommended for solo arrangements only.

You can find more details in the [Uploading Guidelines](https://musescore.com/redirect/af?mu_target=https%3A%2F%2Fmusescore.com%2Fscore-uploading-guidelines%3Futm_medium%3DReferral%26utm_source%3Dmss%26utm_campaign%3DMU_WW_REF_MSS_WEB_ALL_271026_crosslink%26utm_content%3Dhandbook\&utm_medium=Referral\&utm_source=mss\&utm_campaign=MU_WW_REF_MSS_WEB_ALL_271026_crosslink\&utm_content=handbook).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://handbook.musescore.org/file-management/convert-a-file.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
