Workspaces

Built-in Workspaces

Built-in workspaces are stored in the share/workspaces folder. To register them in the application, you need to specify them in src/app/configs/workspaces.cfg.

Editing workspaces

You need to modify the workspace content that comes bundled with the application. For example, you want a certain toolbar button to be visible.

⸻

Manual method:

1. Locate the workspace you want to edit in the share/workspaces folder.
2. Unpack the .mws file using our unpacker: https://github.com/musescore/MuseScore/tree/master/tools/ziprw
3. Inside you’ll find the following files:

• ui_settings - General UI settings: show/hide buttons, etc.

• ui_states - Panel layout for each page.

• ui_toolconfigs - Configs for toolbars that can be customized. It’s better to modify these configs together.

• META-INF - Container information. If you manually delete files from the container, you also need to remove references to them in this folder.

  If you need to enable a toolbar button, open ui_toolconfigs in a text editor and set the corresponding flag (true/false) for that button.

4. Pack the updated workspace back into .mws.

UI method:

1. Launch MuseScore.
2. Select the desired workspace.
3. Apply the change - enable/disable the toolbar button.
4. Close MuseScore.
5. Check that the file has been updated, or simply reopen the program to confirm that the changes were saved.

Important note!

When saving a workspace, ui_states (panel layout) is also saved. This is not needed for other users. To avoid this, manually remove ui_states from the workspace (see the manual method above).

6. After editing, the new workspace will be saved to userAppDataPath/workspaces/
7. Copy it back (with replacement) into share/workspaces.