Skip to content

LibreScore/dl-librescore

Repository files navigation

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

dl-librescore

LibreScore logo

Discord Weblate Github All Releases Github All Releases npm

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

  1. Go to the latest dl-librescore.user.js file
  2. 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