dorico custom instruments

01_README.md

To add custom instruments, you need to modify some XML files under /Applications/Dorico 2.app/Contents/Resources. Only do this if you're comfortable doing something like that!

For instruments.xml and instrumentnames_en.xml, you will add new entries. I placed them after the Pianoforte entry.

If your computer isn't set to English, choose the correct localization file for your system.

For instrumentFamiliesDefinitions.xml you will replace the existing keyboards entry (essentially you add instrument.keyboard.piano.alias.part to the <instrumentDefinitionIDs> element for Keyboards.

instrumentFamiliesDefinitions.xml

			<InstrumentFamilyEntityDefinition>
				<entityID>instrument family.keyboards</entityID>
				<name>Keyboards</name>
				<order>5</order>
				<parentEntityID/>
				<inheritanceMask>0x0</inheritanceMask>
				<instrumentDefinitionIDs>instrument.keyboard, instrument.keyboard.accordion, instrument.keyboard.bandoneon, instrument.keyboard.celesta, instrument.keyboard.celesta.alias.celeste, instrument.keyboard.clavichord, instrument.keyboard.harmonium, instrument.keyboard.harpsichord, instrument.keyboard.melodica, instrument.keyboard.organ, instrument.keyboard.organ.electric, instrument.keyboard.organ.grandstaff, instrument.keyboard.piano, instrument.keyboard.piano.alias.pianoforte, instrument.keyboard.piano.alias.part, instrument.keyboard.piano.electric, instrument.keyboard.piano.honky-tonk, instrument.keyboard.synthesizer, instrument.strings.hurdy-gurdy</instrumentDefinitionIDs>
			</InstrumentFamilyEntityDefinition>

instrumentnames_en.xml

			<InstrumentNameEntityDefinition>
				<entityID>instrumentname.keyboard.piano.alias.part</entityID>
				<name>Part</name>
				<parentEntityID/>
				<inheritanceMask>0</inheritanceMask>
				<data>
					<uiName>Part</uiName>
					<singularFullName>Part</singularFullName>
					<singularShortName>Part</singularShortName>
					<pluralFullName>Parts</pluralFullName>
					<pluralShortName>Pt.</pluralShortName>
					<gender>kNeutral</gender>
					<language>kEnglish</language>
				</data>
			</InstrumentNameEntityDefinition>

instruments.xml

			<InstrumentEntityDefinition>
				<name>Part</name>
				<entityID>instrument.keyboard.piano.alias.part</entityID>
				<parentEntityID/>
				<inheritanceMask>0</inheritanceMask>
				<nameID>instrumentname.keyboard.piano.alias.part</nameID>
				<numStaves>1</numStaves>
				<musicXMLSoundID>keyboard.piano</musicXMLSoundID>
				<numberingStyle>kDummy</numberingStyle>
				<showGuitarChords>false</showGuitarChords>
				<showChordSymbols>true</showChordSymbols>
				<staveDefinition>
					<numStaveLines>5</numStaveLines>
					<barlineSpan>1</barlineSpan>
					<useBrace>false</useBrace>
					<isVocalStave>false</isVocalStave>
					<defaultContextualStemDirectionIsUp>false</defaultContextualStemDirectionIsUp>
				</staveDefinition>
				<clefs>
					<clefIDsForEachStave array="true">
						<staveClefIDs>
							<idForTransposingLayouts>clef.treble</idForTransposingLayouts>
						</staveClefIDs>
					</clefIDsForEachStave>
				</clefs>
				<pitchedInstrumentData>
					<standardRange>A0-C8</standardRange>
					<advancedRange>A0-C8</advancedRange>
					<concertOctaveTransposition>0</concertOctaveTransposition>
					<transposedChromaticTransposition>0</transposedChromaticTransposition>
					<transposedDiatonicTransposition>0</transposedDiatonicTransposition>
					<useKeySignatures>true</useKeySignatures>
					<showTransposition>kNever</showTransposition>
				</pitchedInstrumentData>
				<playingTechniques array="true">
					<playingTechnique>
						<techniqueID>pt.accent</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.arpeggioDown</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.arpeggioUp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.crescendo</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.crescendoDiminuendo</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.diminuendo</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.diminuendoCrescendo</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.f</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.ff</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.fff</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.ffp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.fp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.glissandoDown</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.glissandoUp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.legato</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.marcato</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.mf</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.mp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.natural</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.nonLegato</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.p</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.pp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.ppp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.sf</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.sfp</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.sfz</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.simile</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.sostenutoPedal</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.staccatissimo</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.staccato</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.sustainPedal</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.tenuto</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.tremblement</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.tremolo</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.trill</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.unaCorda</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.laissezVibrer</techniqueID>
					</playingTechnique>
					<playingTechnique>
						<techniqueID>pt.pizzicato</techniqueID>
					</playingTechnique>
				</playingTechniques>
			</InstrumentEntityDefinition>