Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/librescore/dl-librescore
Download sheet music
https://github.com/librescore/dl-librescore
Last synced: 3 days 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 (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-06T08:52:50.000Z (22 days ago)
- Last Synced: 2024-12-17T16:05:21.876Z (10 days ago)
- Language: TypeScript
- Homepage:
- Size: 4.63 MB
- Stars: 1,734
- Watchers: 25
- Forks: 61
- Open Issues: 4
-
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
[](https://discord.gg/DKu7cUZ4XQ) [](https://weblate.librescore.org/engage/librescore) [](https://github.com/LibreScore/app-librescore/releases/latest) [](https://github.com/LibreScore/dl-librescore/releases/latest) [](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