schrodinger.application.maestro_reset module

Reset the active Maestro profile’s UI preferences to their defaults.

The reset deletes the on-disk files backing most categories of UI state so Maestro starts with factory defaults on its next launch:

  • Color schemes shared by every profile: scheme.res, schemes/

  • Window and panel positions: mainwindowx.state, tablewindow.state, layout.res, maestro_settings.ini

  • Toolbars: default.toolbars

  • Mouse actions: default.mouseactions, custom.mouseactions

  • Fonts: maestro_user.sty

  • Presets: custom_presets.pre

A few settings share a file with data we must keep, so they are edited in place rather than deleted:

  • Label, workspace, measurement, and adjustment fonts, and the active mouse-action set: the matching prefer.cmd lines are removed.

  • Favorites: cleared from default.tasks.menu, keeping its recent-task history.

Scientific settings, job/host configuration, feature flags, and recent projects are left untouched: these are user data, not UI settings, so a UI reset should not discard them.

exception schrodinger.application.maestro_reset.InvalidProfileError

Bases: OSError

Raised when a profile cannot be safely reset.

schrodinger.application.maestro_reset.reset_ui(maestro_dir: str | pathlib.Path, profile_name: str) → None

Remove the active profile’s UI settings covered by the reset workflow.

Top-level color schemes are shared across all profiles, so resetting them affects every profile.

Parameters:

  • maestro_dir – Maestro version directory containing the profiles.

  • profile_name – Name of the active supported Maestro profile.

Raises:

  • InvalidProfileError – If the profile cannot be safely reset. Nothing is changed.

  • OSError – If one or more settings cannot be reset. The reset may be partial.