https://github.com/librescore/dl-librescore

Download sheet music
https://github.com/librescore/dl-librescore

Last synced: about 2 months ago
JSON representation

Download sheet music

• Host: GitHub
• URL: https://github.com/librescore/dl-librescore
• Owner: LibreScore
• License: mit
• Created: 2021-10-30T21:24:22.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2025-02-21T04:09:38.000Z (4 months ago)
• Last Synced: 2025-04-09T22:09:06.770Z (3 months ago)
• Language: TypeScript
• Homepage:
• Size: 4.69 MB
• Stars: 1,963
• Watchers: 24
• Forks: 64
• Open Issues: 11
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


‎[čeština](/docs/cs/PŘEČTĚTEMĚ.md) | ‎**English** | ‎[español](/docs/es/LÉAME.md) | ‎[français](/docs/fr/LISEZMOI.md) | ‎[magyar](/docs/hu/OLVASSAEL.md) | ‎[Melayu](/docs/ms/BACASAYA.md) | ‎[русский](/docs/ru/ПРОЧТИМЕНЯ.md) | ‎[简体中文](/docs/zh-Hans/自述文件.md) | ‎[[+]](https://weblate.librescore.org/projects/librescore/docs)

[//]: # "\+\_==!|!=_=!|!==_/+/ ***DO NOT EDIT ABOVE THIS LINE*** /+/^^+#|#+^+#|#+^^\+\"

# dl-librescore





[![Discord](https://img.shields.io/discord/774491656643674122?color=5865F2&label=&labelColor=555555&logo=discord&logoColor=FFFFFF)](https://discord.gg/DKu7cUZ4XQ) [![Weblate](https://weblate.librescore.org/widgets/librescore/-/dl-librescore/svg-badge.svg)](https://weblate.librescore.org/engage/librescore) [![Github All Releases](https://img.shields.io/github/downloads/LibreScore/app-librescore/total.svg?label=App)](https://github.com/LibreScore/app-librescore/releases/latest) [![Github All Releases](https://img.shields.io/github/downloads/LibreScore/dl-librescore/total.svg?label=Userscript)](https://github.com/LibreScore/dl-librescore/releases/latest) [![npm](https://img.shields.io/npm/dt/dl-librescore?label=Command-line+tool)](https://www.npmjs.com/package/dl-librescore)

Download sheet music



> DISCLAIMER: This is not an officially endorsed MuseScore product

## Installation

There are 4 different installable programs:

| Program                                                                            | MSCZ | MIDI | MP3 | PDF | Conversion |     | Windows | macOS | Linux | Android | iOS/iPadOS |

| ---------------------------------------------------------------------------------- | ---- | ---- | --- | --- | ---------- | --- | ------- | ----- | ----- | ------- | ---------- |

| [App](#app)                             | ✔️   | ✔️   | ✔️  | ❌  | ❌         |     | ✔️      | ✔️    | ✔️    | ✔️      | ❌         |

| [Userscript](#userscript)               | ❌   | ✔️   | ✔️  | ✔️  | ❌         |     | ✔️      | ✔️    | ✔️    | ✔️      | ✔️         |

| [Command-line tool](#command-line-tool) | ❌   | ✔️   | ✔️  | ✔️  | ✔️         |     | ✔️      | ✔️    | ✔️    | ✔️      | ❌         |

| [Webmscore website](#webmscore-website) | ❌   | ❌   | ❌  | ❌  | ✔️         |     | ✔️      | ✔️    | ✔️    | ✔️      | ✔️         |

> Note: `Conversion` refers to the ability to convert files into other file types, including those not downloadable in the program.

> Conversion types include: Individual Parts, PDF, PNG, SVG, MP3, WAV, FLAC, OGG, MIDI, MusicXML, MSCZ, and MSCX.

### App

1. Go to the [README](https://github.com/LibreScore/app-librescore#installation) page of the `app-librescore` repository

2. Follow the installation instructions for your device

### Userscript

> Note: If your device is on iOS or iPadOS, please follow the [Shortcut](#shortcut) instructions.

>

> Note: If you cannot install browser extensions on your device, please follow the [Bookmark](#bookmark) instructions instead.

#### Browser extension

1. Install [Tampermonkey](https://www.tampermonkey.net)

> Note: If you already installed an old version of the script called "musescore-downloader", "mcsz downloader", or "musescore-dl", please uninstall it from the Tampermonkey dashboard

2. Go to the latest [dl-librescore.user.js](https://github.com/LibreScore/dl-librescore/releases/latest/download/dl-librescore.user.js) file

3. Press the Install button

#### Shortcut

1. Install the [LibreScore shortcut](https://www.icloud.com/shortcuts/901d8778d2da4f7db9272d3b2232d0fe)

2. In Safari, when viewing a song on MuseScore, tap 

3. Tap the LibreScore shortcut to activate the extension

> Note: Before you can run JavaScript from a shortcut you must turn on Allow Running Scripts

>

> 1. Go to Settings  > Shortcuts > Advanced

> 2. Turn on Allow Running Scripts

#### Bookmark

1. Create a new bookmark (usually Ctrl+D)

2. Type `LibreScore` for the Name field

3. Type `javascript:(function () {let code = document.createElement('script');code.src = 'https://github.com/LibreScore/dl-librescore/releases/latest/download/dl-librescore.user.js';document.body.appendChild(code);}())` for the URL field

4. Save the bookmark

5. When viewing a song on MuseScore, click the bookmark to activate the extension

### Command-line tool

1. Install [Node.js LTS](https://nodejs.org)

2. Open a terminal (do _not_ open the Node.js application)

3. Type `npx dl-librescore@latest`, then press `Enter ↵`

### Webmscore website

1. Open [Webmscore](https://webmscore-pwa.librescore.org)

> Note: You can access the website offline by installing it as a PWA

## Building

1. Install [Node.js LTS](https://nodejs.org)

2. `npm install` to install packages

3. `npm run build` to build

- Install `./dist/main.user.js` with Tampermonkey

- `node ./dist/cli.js` to run command-line tool