> 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/3/sound-and-playback/soundfonts-and-sfz-files.md).
# SoundFonts and SFZ files
**MuseScore 4.0's** [Sound and playback](https://musescore.org/en/handbook/4/sound-and-playback) support:
* SoundFont (.sf2/.sf3): supported directly, no need to click load in the synthesizer anymore. Setup per instrument in the [Mixer](https://musescore.org/en/handbook/4/mixer). Cannot select preset/bank in the mixer directly (yet). See [SoundFonts](https://musescore.org/en/handbook/4/soundfonts).
* SFZ (.sfz): supported **indirectly** through 3rd party VST. See [SoundFonts](https://musescore.org/en/handbook/4/soundfonts).
* VST, VSTi: supported VST3, [some VSTs are reported](https://musescore.org/forum) not working properly. See [Working with VSTi](https://musescore.org/en/handbook/4/working-vst-and-vsti)
* MuseSounds: free high quality proprietary sounds from MuseGroup, installable thru MuseHub.
***
## **The following describes MuseScore 3 only, it contains instructions that do not work on Musescore 4.**
[Jump to a curated list of free files downloadable](#list-of-downloadable-soundfonts-and-sfz), feel free to add to the list.
## Overview
All [pre-defined instruments added onto a score](/3/basics/create-a-new-score.md) is capable of creating audio playback without further setup. MuseScore creates audio playback by using the [Synthesizer](/3/sound-and-playback/synthesizer.md) and the virtual instrument technology. MuseScore 3 comes with the free *MuseScore\_General.sf3* which contains the virtual instrument and human voice sounds, drum/percussion kits sounds, and sound effects needed.
To use custom sounds, install a custom virtual instrument file, enable it inside Musescore, then configure a score to use a sound inside the custom file. The two sample-based MIDI synthesizing virtual instrument technologies supported by Musescore 3 are [SoundFont](#soundfonts) (.sf2/.sf3) and [SFZ](#sfz) (.sfz).
Creation of audio playback starts with processing of score notation into MIDI data. MIDI exchange utilized includes **sound preset/patch/program, MIDI velocity, MIDI CC** etc. To edit sound preset usage, see [Mixer](/3/sound-and-playback/mixer.md) chapter. To choose whether Musescore use MIDI velocity or MIDI CC or both, and the MIDI CC number used (CC2 by default), see [Synthesizer](/3/sound-and-playback/synthesizer.md) chapter. These data are used together with SF2/SF3/SFZ data.
SF2/SF3/SFZ data consists of sound samples in (PCM (WAV), OGG, or FLAC format / container) and algorithms that handle MIDI data provided by Musescore (sound volume response / attenuation modulator). MuseScore does not offer functionality to edit any data inside SF2/SF3/SFZ, including the MIDI handling algorithm. *How MIDI data such as MIDI velocity affect sound volume is determined by the file but not Musescore, it is solely engineered by the creator of SF2/SF3/SFZ file*. The free [Polyphone](https://www.polyphone-soundfonts.com/) editor can be used to edit them, it can also convert SF2/SF3 into SFZ and vice versa, but with some definition data loss. The SFZ definition files can be edited with any plain text editor.
Install a custom file by copying it into the custom virtual instrument directory, which is configurable in **Edit → Preferences: General tab**, see [Preferences](/3/advanced-topics/preferences.md) chapter, it is by default:
* Windows: `%HOMEPATH%\Documents\MuseScore3\Soundfonts`
* macOS and Linux: `~/Documents/MuseScore3/Soundfonts`
Then [enable the custom file by setting up Synthesizer window](#setting-up-musescore-to-use-a-custom-sf2sf3-or-sfz). **Scores refer to virtual instrument files by their ordering** in the list in the Synthesizer window. Scores do not create correct playback, unless the ordering is identical to the ordering used last time. To save and load the ordering setting, see [Synthesizer](/3/sound-and-playback/synthesizer.md) chapter.
Lastly, [configure a score to use a sound inside the custom file](#using-a-custom-sound-on-a-score).
Musescore creates playback audio in real-time, it does not use or save cache. A score using a custom virtual instrument will not create identical playback on another machine unless the custom virtual instrument is also installed on that machine. To export audio as an independent file, see [Export](/3/basics/opensaveexportprint.md) chapter.
## SoundFonts
SoundFonts (.sf2/.sf3) are virtual instrument files. The SF2 format is invented by a now defunt company, but a copy of the format specification can be viewed online, see [Soundfont, MIDI velocity and instruments.xml: Online Resources](https://musescore.org/en/handbook/developers-handbook/references/instrumentsxml-documentation#Online_Resources). SF3 offers sound data compression, see [Glossary](/3/appendix/glossary.md#sf2). One soundfont file is capable of [embedding (packaging) all data](#internal-structure-of-sf2sf3) required for multiple Musescore Instrument sound generation, see the [Instruments, staff setup and templates](/3/basics/instruments.md) and [Mixer](/3/sound-and-playback/mixer.md) chapters.
* GM SoundFonts: Conforms to GM ([General MIDI](https://en.wikipedia.org/wiki/General_MIDI)) program / preset numbering standard that Musescore use. If the pre-installed SF3 in [Synthesizer](/3/sound-and-playback/synthesizer.md) is replaced with a custom GM soundfont **as 1st ordered item** , staffs create correct playback without further tweaking and picking in the [Mixer](/3/sound-and-playback/mixer.md).
* SND SoundFonts: Contains sounds that response to MIDI CC 2 signals created by Musescore 3's SND mechanisms, see [Glossary: SND](/3/appendix/glossary.md#snd).
Musescore need time to process soundfonts at startup, especially SF3 files. Removing unused files from the list in the Synthesizer can speed up program startup.
### Installing SF2/SF3
1. [Unzip if required](#compressed-file-formats)
2. Double click on a sf2/sf3 file
3. A dialog appears asking if you want to install the SoundFont. If not, right-click or Ctrl-click on the file, select to "open with ... MuseScore"
4. Click "Yes" to place a copy of the SoundFont file in MuseScore's SoundFonts directory.
5. [Setup Musescore](#setting-up-musescore-to-use-a-custom-sf2sf3-or-sfz)
6. [Use it on a score](#using-a-custom-sound-on-a-score)
If you're having problem, move / copy the file manually to the [custom virtual instrument directory](#overview).
### Disabling and uninstalling SF2/SF3
To disable a virtual instrument, remove the file from [the list inside Synthesizer](#setting-up-musescore-to-use-a-custom-sf2sf3-or-sfz).
To uninstall a virtual instrument, remove the file from [the directory](#overview). This may change the virtual instrument ordering in Synthesizer, which affects all scores previously created with this Musescore program because [the order of soundfonts affects playback](/3/sound-and-playback/synthesizer.md#fluid-sf2sf3). Score may play an incorrect sound even if it does not use the virtual instrument you just uninstalled. When Musescore cannot locate particular data, a staff's playback falls back to use the first sound of the first file, that is usually the "Grand Piano" sound of the [pre-installed SF3](#the-pre-installed-sf3).
### Internal structure of SF2/SF3
*a simplified illustration*
* one SF2/SF3 file, embedding all the following data
* instrument 1 sound 1 (eg guitar normal)
* sound samples (various pitches)
* instrument 1 sound 2 (eg guitar open string)
* sound samples
* instrument 2 sound 1 (eg piano)
* sound samples
* instrument 3 sound 1 (eg violin arco)
* sound samples
* instrument 3 sound 2 (eg violin pizz)
* sound samples
* instrument 3 sound 3 (eg violin tremolo)
* sound samples
* etc
## SFZ
SFZ is a free virtual instrument format not related to sf2/sf3, see [https://sfzformat.com](https://sfzformat.com/) . SFZ files do not embed (package) audio sample. Musescore 3 understand and uses each SFZ for one articulation sound of one instrument only, see the [Mixer](/3/sound-and-playback/mixer.md) chapter.
### Installing SFZ
1. [Unzip if required](#compressed-file-formats)
2. Move / copy *SFZ files and the folders containing audio samples* manually to the [custom virtual instrument directory](#overview). Leave the sub-directories and their contents as they are.
3. [Setup Musescore](#setting-up-musescore-to-use-a-custom-sf2sf3-or-sfz)
4. [Use it on a score](#using-a-custom-sound-on-a-score)
### Disabling and uninstalling SFZ
[Same as in soundfont](#disabling-and-uninstalling-sf2sf3)
### Folder structure of SFZ and audio samples
SFZ files do not embed audio data. Audio files (WAV or FLAC format) are usually located in folder(s) next to SFZ file(s):
* SFZ definition file 1 (eg guitar normal)
* SFZ definition file 2 (eg guitar open string)
* SFZ definition file 3 (eg piano)
* etc
* folder(s) next to the SFZs contains all samples
## Setting up Musescore to use a custom SF2/SF3 or SFZ
Once the files has been [installed](#installing-sf2sf3), they also need to be enabled inside the synthesizer window, see [Synthesizer](/3/sound-and-playback/synthesizer.md).
## Using a custom sound on a score
If the sound needed is shipped with Musescore, use it by adding [instruments onto a score](/3/basics/create-a-new-score.md) instead, their sounds are already configured properly.
To add a custom sound, [choose and add an instrument](/3/basics/create-a-new-score.md#change-instrument-and-staff-setup) that use a staff style similar to the custom sound would relate to, then change its sound in the [Mixer](/3/sound-and-playback/mixer.md).
Advanced users could create custom instruments, see developers' handbook [instruments.xml](https://musescore.org/en/handbook/developers-handbook/references/instrumentsxml-documentation) chpater. That chapter has info on how to make a soundfont more compatible with MuseScore 3 such as adding sound change text (eg pizz.) support, adding MIDI CC response etc.
## List of downloadable SoundFonts and SFZ
The list below are different from other sf2/sf3/sfz online depositories, in that these virtual instruments contains at least one [Musescore 3 compatible attenuation modulator](#overview). That is, they are engineered to at least responds to one volume-affecting MIDI data exchange practice used by Musescore 3, such as MIDI velocity. Community handbook editors updating this list should be mindful of the *distribution* aspect of the SoundFonts or SFZ's license ([wikipedia](https://w.wiki/8JyK))
### All sounds
* GeneralUser GS
* [Direct download from schristiancollins.com](https://schristiancollins.com/soundfonts/GeneralUser_GS_1.442-MuseScore.zip) (29.8 MB uncompressed)
* Courtesy of [S. Christian Collins](https://schristiancollins.com/generaluser.php)
* [Magic Sound Font, version 2.0](http://www.personalcopy.com/sfarkfonts1.htm) (67.8 MB uncompressed)
* [Arachno SoundFont, version 1.0](https://www.arachnosoft.com/main/download.php?id=soundfont-sf2) (148 MB uncompressed)
* Courtesy of [Maxime Abbey](https://www.arachnosoft.com/)
* TimGM6mb:
* The free default soundfont that comes with **MuseScore 1**
* [Direct download from sourceforge](https://sourceforge.net/p/mscore/code/HEAD/tree/trunk/mscore/share/sound/TimGM6mb.sf2?format=raw) (5.7 MB uncompressed):
* License: GNU GPL, version 2
* Courtesy of [Tim Brechbill](http://ocmnet.com/saxguru/Timidity.htm#sf2)
* FluidR3Mono\_GM:
* The free default soundfont that comes with **MuseScore 2 (up to version 2.1)**.
* [`SF3 Direct download from github`](https://github.com/musescore/MuseScore/raw/2.1/share/sound/FluidR3Mono_GM.sf3) (13.8 MB).
* License: [MIT license](https://ftp.osuosl.org/pub/musescore/soundfont/MuseScore_General/MuseScore_General_License.md)
* MuseScore\_General and MuseScore\_General\_HQ:
* MuseScore\_General.sf3 is the free default soundfont that comes with **MuseScore 3** and **MuseScore 2 (2.2 and above).**
* [`SF3 Direct download from osuosl.org`](https://ftp.osuosl.org/pub/musescore/soundfont/MuseScore_General/MuseScore_General.sf3) (35.9 MB)
* [`SF2 Direct download from osuosl.org`](https://ftp.osuosl.org/pub/musescore/soundfont/MuseScore_General/MuseScore_General.sf2) (208 MB)
* MuseScore\_General\_HQ.sf3 is the pre scale-down version of MuseScore\_General. You can download and install it inside Musescore 3 as an extension, see [Language, translations, and extensions: install extension](/3/getting-started/language-translations-and-extensions.md#installuninstall-extension).
* [Changelog](https://ftp.osuosl.org/pub/musescore/soundfont/MuseScore_General/MuseScore_General_Changelog.md).
* License: [MIT license](https://ftp.osuosl.org/pub/musescore/soundfont/MuseScore_General/MuseScore_General_License.md)
* Courtesy of [S. Christian Collins](https://musescore.org/user/62809)
* MS Basic:
* MS Basic.sf3 is the free default soundfont that comes with **MuseScore 4**
* More info see notes inside your computer's Musescore 4 `MuseScore\instruments\instruments.xml`
* [Bank and program (work in progress) details on google sheets](https://docs.google.com/spreadsheets/d/1SwqZb8lq5rfv5regPSA10drWjUAoi65EuMoYtG-4k5s)
* [Development folder on github](https://github.com/musescore/MuseScore/tree/master/share/sound)
* Timbres of Heaven, version 4.0:
* [Direct download from google drive](https://drive.google.com/file/d/1-cwBWZIYYTxFwzcWFaoGA7Kjx5SEjVAa/view?usp=drivesdk) (429 MB uncompressed)
* [Direct download from jeetee.net](https://musescore.jeetee.net/rawfiles/Timbres%20of%20Heaven%20\(XGM\)%204.00\(G\).7z)
* Courtesy of Don Allen
* [Soundfonts4U](https://sites.google.com/site/soundfonts4u/) (12 MB up to 1 GB, depending on which package you choose)
* Collection of beautifully sounding acoustic guitars as well as pianos, basses, strings, harps and many more.
### Orchestral sounds
File that contains common instrument sounds of the four families:
* Sonatina Symphonic Orchestra (503 MB uncompressed)\
Downloads: [SoundFont](https://ftp.osuosl.org/pub/musescore/soundfont/Sonatina_Symphonic_Orchestra_SF2.zip) | [SFZ format](https://sso.mattiaswestlund.net/)\
License: Creative Commons Sampling Plus 1.0
* [Aegean Symphonic Orchestra](https://sites.google.com/view/hed-sounds/aegean-symphonic-orchestra)\
Courtesy of [Ziya Mete Demircan](https://musescore.org/user/230181) (352 MB uncompressed)
### Piano sounds
#### SF2 Pianos
* [Acoustic grand piano, release 2016-08-04](https://freepats.zenvoid.org/Piano/YDP-GrandPiano/YDP-GrandPiano-SF2-20160804.tar.bz2)\
Description: Yamaha Disklavier Pro Grand Piano, sf2 format, 36 MB compressed, 113 MB uncompressed, 121 samples, 5 velocity layers\
More information: including other soundfonts.\
License: Creative Commons Attribution 3.0\
Courtesy of [Roberto Gordo Saez](https://web.archive.org/web/20190914132427/https://freepats.zenvoid.org/sf2/acoustic_grand_piano_ydp_20080910.txt)
* [Salamander C5 Light](https://sites.google.com/view/hed-sounds/salamander-c5-light)\
Courtesy of [Ziya Mete Demircan](https://musescore.org/user/230181) (24.5 MB uncompressed)
#### SFZ Pianos
* Salamander Grand Piano\
Downloads: [version 2](https://download.linuxaudio.org/lau/SalamanderGrandPianoV2/) | [version 3](https://freepats.zenvoid.org/Piano/acoustic-grand-piano.html)\
Description: Yamaha C5, 48kHz, 24bit, 16 velocity layers, between 80 MB and 1.9 GB uncompressed\
License: Creative Commons Attribution 3.0\
Courtesy of Alexander Holm
* [Detuned Piano](https://download.linuxaudio.org/musical-instrument-libraries/sfz/detuned_piano.tar.7z) (244 MB uncompressed)\
License: Creative Commons Attribution-ShareAlike 3.0
* [Plucked Piano Strings](https://download.linuxaudio.org/musical-instrument-libraries/sfz/plucked_piano_strings.tar.7z)\
Description: 44.1kHz, 16bit, stereo, 168 MB uncompressed\
License: Creative Commons Attribution-ShareAlike 3.0
* [The City Piano](https://bigcatinstruments.blogspot.ca/2015/09/all-keyboard-instruments.html)\
Description: Baldwin Baby Grand, 4 velocity layers, 696 MB uncompressed\
License: Public domain\
Courtesy of Big Cat Instruments
* [Kawai Upright Piano, release 2017-01-28](https://freepats.zenvoid.org/Piano/acoustic-grand-piano.html#KawaiUpright)\
Description: 68 samples, 44KHz, 24bit, stereo, 2 velocity layers, 58 MB uncompressed\
License: GNU General Public License version 3 or later, with a [special exception](https://freepats.zenvoid.org/licenses.html#GPL_exception)\
Courtesy of Gonzalo and Roberto
### Drumset SFZs
* The free [MuseScore Drumline (MDL)](https://musescore.org/en/mdl) extension contains a collection of drumset sounds, to download and install see [Language, translations, and extensions: install extension](/3/getting-started/language-translations-and-extensions.md#installuninstall-extension)
## Troubleshooting
Tips on extracting downloaded files:
* ZIP (\*.zip) is standard compression format supported by most operating systems.
* sfArk (\*.sfArk) is a compression format designed especially for compressing SoundFont files. To decompress it, use [Polyphone](https://www.polyphone-soundfonts.com/en) (cross-platform software); or this online service:
* .tar.gz (\*.tar.gz) is a popular compression format for Linux. Windows users can use [7-Zip](https://www.7-zip.org/); Mac users can use [The Unarchiver](https://unarchiver.c3.cx/unarchiver), or macOS' built-in Archive Utility. Note that if using 7-Zip, you will need to apply decompression twice—once for GZip and once for TAR.
If the toolbar play panel is greyed out, or not visible, follow the instructions below to get your sound working again:
1. Right-click on the menu bar and make sure there is a check mark next to the **Playback Controls** menu item. If this step does not solve your problem, go to Step 2.
2. If the play panel disappears after changing the SoundFont, go to **Edit -> Preferences... -> I/O** tab and click OK without making any changes. After restarting MuseScore, the play panel should reappear.
If you are setting up a SoundFont for the first time, please use one of the recommended SoundFonts listed above.
If playback stutters, then your computer may not be able to handle the SoundFont being used. The following advice may help:
* Reduce the amount of RAM (memory) used by MuseScore by using a smaller SoundFont. See the [list](#list-of-downloadable-soundfonts-and-sfz) above for suggestions.
* Increase the amount of RAM available for MuseScore by quitting all applications except MuseScore. If you still have problems and a large SoundFont is important to you, consider more RAM for your computer.
[Drum notation](/3/notation/entering-and-editing-percussion-notation.md) and [Unpitched layout sound](https://musescore.org/en/handbook/developers-handbook/references/instrumentsxml-documentation) requires MIDI Bank number set to 128
## The pre-installed SF3
MuseScore 3 comes with the free *MuseScore\_General.sf3*. It is located in the directory shown below. This directory should **not** be used for installing custom files, the [custom virtual instrument directory](#overview) should be used instead.
* Windows x86 (32-bit) / MuseScore x86: `%ProgramFiles%\MuseScore 3\sound\MuseScore_General.sf3`
* Windows x64 (64-bit) / MuseScore x86: `%ProgramFiles(x86)%\MuseScore 3\sound\MuseScore_General.sf3`
* Windows x64 (64-bit) / MuseScore x86\_64: `%ProgramFiles%\MuseScore 3\sound\MuseScore_General.sf3`
* macOS: `/Applications/MuseScore 3.app/Contents/Resources/sound/MuseScore_General.sf3`
* Linux (Ubuntu): `/usr/share/mscore-xxx/sounds/MuseScore_General.sf3` (with `xxx` being the MuseScore version)
## See also
* [Synthesizer](/3/sound-and-playback/synthesizer.md)
* [Add or remove instruments / staffs](/3/basics/create-a-new-score.md#change-instrument-and-staff-setup)
* [Mixer](/3/sound-and-playback/mixer.md)
## External links
* [How to edit a SoundFont](https://musescore.org/en/node/13734) (list of softwares)
* [The SFZ Format](http://www.sfzformat.com/legacy/) (for details about the sfz specification)
* [Soundfont, MIDI velocity and instruments.xml](https://musescore.org/en/handbook/developers-handbook/references/instrumentsxml-documentation) (A guide on how to create and edit a soundfont and its MIDI CC response)
* [How to change the SoundFont or add another](https://musescore.org/en/node/50721) (MuseScore HowTo)
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://handbook.musescore.org/3/sound-and-playback/soundfonts-and-sfz-files.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.