Frequently Asked Questions: new users start here

Discussions about our next-generation scoring application, Dorico.
User avatar
Daniel at Steinberg
Posts: 12157
Joined: Mon Nov 12, 2012 10:35 am

Frequently Asked Questions: new users start here

Post by Daniel at Steinberg » Fri Nov 02, 2018 1:08 pm

Thanks for downloading and trying Dorico Pro or Dorico Elements.

About this forum
This forum is very active and has a thriving and very helpful community. You can ask any question you like about Dorico on the forum, and you can be sure of receiving assistance either from a fellow user or a member of the Dorico development team.

All we ask is that you use the resources in this thread and the tools to search the forum in order to try and find the answer to your question before you post. You may receive a gentle suggestion to search before you post in reply to your question – please don't take offence.

Searching the forum
Searching the forum is awkward and the built-in search tools of phpBB are not wonderful. You may have better luck using a custom Google search, which you can set up in your browser.

For example, in Chrome, you can set up custom search providers in Settings > Manage Search Engines.

For Search engine, give it a helpful title like "Dorico Forum".

For "Keyword", type something you want to type into the address bar as a prefix for searching the forum: I went for dorfor (not something I'm likely to type by accident), and for Url with %s in place of query I specified:

Code: Select all
Once you've added this, you can type e.g. dorfor "page up" into the address bar of your browser, and Google will search just this forum for the exact words "page up".

Resources for new users
There is a wealth of information available to help you get to grips with Dorico.

Online documentation
Dorico's documentation can be found at Online documentation and a PDF version is available. The documentation is currently more extensive in English than in other languages, but we are working on updating the documentation in all localised languages as quickly as possible.

The online documentation is designed to be Google-able: if you're not sure how to do something in Dorico, you are encouraged to simply Google for it. For example, try typing a simple query like add dynamics in Dorico into Google, and you will usually find both a YouTube video (see below) and a link to the relevant pages from the online documentation within the first couple of hits.

Version History
For features in Dorico 2, the online documentation is not yet complete, and so an important supplementary location to consult for documentation is the Version History PDF files that are supplied along with each release. The Dorico 1.2.10 Version History is around 150 pages and contains detailed documentation for important features like cues, chord symbols, unpitched percussion, and more. The Dorico 2 Version History likewise contains documentation for working with video, divisi, ossias, rhythmic notation, etc.

We strongly recommend that you read these two documents in conjunction with the online documentation.

Dorico 1.2.10 Version History PDF
Dorico 2.1.10 Version History PDF

Dorico has an extensive YouTube channel with over 100 short, concise tutorial videos that explain almost every major feature of the program in detail.

You are encouraged to subscribe to the YouTube channel and click the little bell icon to be notified when a new video is added.

Our product specialist John Barron also runs a monthly live stream called Discover Dorico on the YouTube channel, and you can request topics for him to cover in these sessions by emailing

German-speaking users may also find these German-language videos from educator Marcel Vonesch helpful.

Getting Started documentation
John has also produced a couple of simple tutorials to help get you started with Dorico. You can download two handouts, one introducing you to note input, and the other to page layout for producing worksheets and teaching materials, from the Dorico blog here.

Community-led documentation
Dorico user Dan Kreider has written, with contributions from other users, a beginner's guide to Dorico that many users have found helpful. You can download this guide from Dan's web site here.

A French-language translation by Marc Larcher is available here.

Other supplementary documentation
As you become more familiar with Dorico, you will start to rely on features like popovers, which provide the fastest way to create items using the keyboard, and tokens, which are used in text frames to automatically show appropriate information (e.g. for headers, footers, page numbers, composer name, etc.).

Separate documents detailing what you can type into popovers and what tokens are available can be downloaded from

Feature overview
Finally, you might be wondering whether or not Dorico has a particular feature. You can download a comprehensive list of all of its features from here.

User avatar
Daniel at Steinberg
Posts: 12157
Joined: Mon Nov 12, 2012 10:35 am

Re: Frequently Asked Questions: new users start here

Post by Daniel at Steinberg » Fri Nov 02, 2018 1:08 pm

Troubleshooting common problems

Installation fails on Mac
If you encounter an error during the installation of Dorico on Mac, then it is most likely because the Dorico installer was unable to update or install the necessary components for the eLicenser. Make sure that you quit any applications on your computer that might be using the eLicenser (e.g. Cubase, Nuendo, WaveLab, any Steinberg VST instrument, VSL Vienna Ensemble Pro, etc.), then run the installer again.

If you still encounter an error, please restart your computer and then run the Dorico installer before you run any other applications, and it should complete successfully.

Fonts are messed up, no music symbols appear
This can happen on Windows after installing a Dorico update. Simply reboot your computer to fix this problem.

Playback problems
If you are unable to hear sound on playback, or have some other kind of audio problem, we have produced a troubleshooting video that walks through all of the common problems you might experience with playback. You can find that video on YouTube here.

If you get no playback, first use Edit > Device Setup to make sure that the appropriate audio output device is chosen. Quit and restart Dorico after making a change to the audio device, to make sure that your choice has been saved correctly (this will not be necessary in the long term but is currently required).

If you don't get sound in a particular project, try switching to Play mode and choose Play > Playback Template and reapply one of the default playback templates.

If you're not getting any sound at all, start a new project and add a player with a piano instrument, then switch to Play mode, and in the VST Instruments panel on the right-hand side, check that one instance of HALion Sonic SE is shown as loaded. Click the little e (for editor) button to show the HALion Sonic SE window. You should see that the Yamaha S90ES Piano patch is loaded: click any of the keys in the keyboard at the bottom of the window. You should see the VU meters in the window light up, and you should hear some notes playing.

You can also try resetting the audio engine back to its default state. The attached cleanup scripts will:
  • * kill any running Dorico and audio engine processes
    * removes the Dorico application data, including any preferences, key commands or custom options that you have set.
    * removes Dorico's cache directories

It should get you back to the state when you ran Dorico for the first time. This can be helpful if the audio engine hangs on startup, or was tripped up by a crashing plugin.

If in any doubt, back up your system before running this script.


HALion Sonic SE won't show me any patches/sounds
If the sound browser in Halion or other plugins is blank then you can force the MediaBay database to update by running the above clean-up scripts for the audio engine, or by manually deleting:

%APPDATA%\Steinberg\VSTAudioEngine_64 (for Dorico 1.2.10)
%APPDATA%\Steinberg\VSTAudioEngine2_64 (for Dorico 2x)

/Users/your-user-name/Library/Preferences/VSTAudioEngine (for Dorico 1.2.10)
/Users/your-user-name/Library/Preferences/VSTAudioEngine2 (for Dorico 2.x)

No sound from other applications when Dorico is running.
Read this article.

Dorico will not start on Windows 7
Although it is not officially supported, Dorico should also run fine on Windows 7.

If you are on Windows 7 and Dorico hangs during start-up with the error message "Audio Engine Process Died" then chances are high that you are missing a certain Windows update.
Please download and execute KB2670838 and then reboot your machine.

Besides that Windows update, you also must have Windows Aero enabled. To enable Aero, read this guide. For how to enable Aero on Windows 7 Home Basic read the advice from user ShikiSuen here.

MIDI keyboard problems
Make sure that your MIDI keyboard is connected to your computer and switched on before you run Dorico. Dorico will not detect your keyboard if it is switched on or connected after the program is already running: you will need to quit and restart Dorico for your keyboard to be detected.

Dorico is crashing. What do I do?
Although we make every effort to ensure that Dorico will run stably on everyone's computer, you may occasionally encounter a crash. To help us troubleshoot the problem, please follow these steps.

On Windows, applications no longer produce a crash dump by default. You can make your computer generate the minidump files we need to diagnose your problem by downloading, unzipping and double-clicking this Registry key:

Now when Dorico crashes, Dorico will create mini-dump files that we can use to determine what happened before it crashed.

If Dorico crashes, run Dorico again and choose Help > Create Diagnostic Report, which will create a zip file on your desktop. Send that to us, either by attaching it to a post here on the forum, or by contacting technical support. The zip file contains various logs, crash dumps, and other files that we can use to diagnose the problem.

If your crash is reproducible with a particular project or set of steps, please also include the steps needed to reproduce the crash, and ideally the project, MusicXML or MIDI file you need to reproduce the problem along with your problem report.


Return to “Dorico”

Who is online

Users browsing this forum: Andre, András at Steinberg, filter55, pianoleo, SeeWhat and 9 guests