dl-librescore/docs/en/README.md

‎čeština | ‎English | ‎español | ‎français | ‎magyar | ‎Melayu | ‎русский | ‎简体中文 | ‎[+]

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

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	✔️	✔️	✔️	❌	❌		✔️	✔️	✔️	✔️	❌
Userscript	❌	✔️	✔️	✔️	❌		✔️	✔️	✔️	✔️	✔️
Command-line tool	❌	✔️	✔️	✔️	✔️		✔️	✔️	✔️	✔️	❌
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 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 instructions.

Note: If you cannot install browser extensions on your device, please follow the Bookmark instructions instead.

Browser extension

1. Install Tampermonkey

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 file
3. Press the Install button

Shortcut

1. Install the LibreScore shortcut
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
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

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

Building

1. Install Node.js LTS
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