Skip to content
dream-ini
guide

The GUI

The Dream INI window: every field, the three output modes, the result tabs, the file picker, languages, and controller navigation.

Run dream-ini with no arguments and it opens Dream INI, the same import as the command line in a window. It asks for the same things in the same order: a Morrowind.ini, optionally a cfg, what to import, and where the result goes. Nothing is written until you import with an output chosen.

The desktop builds for Windows, Linux and macOS open a normal window, for mouse, keyboard or a controller. The PortMaster build draws the same window full screen, for a controller. The Android build has no GUI.

Source#

  • Morrowind.ini: the INI to import. Required.
  • Existing: the openmw.cfg to start from. Optional; without it, the import starts from an empty cfg, as without --cfg.

Type a path, or use Browse….

Import options#

  • Encoding: Auto uses the cfg’s encoding=, or win1252 if it has none. Or choose win1250, win1251 or win1252. See Encoding.
  • Import bitmap fonts: --fonts. Off.
  • Import archives: the opposite of --no-archives. On.
  • Import content files / load order: --game-files. Off.

Overrides#

  • Data Files directory: --data, a folder searched for content and archives before any other.
  • data-local, resources, user-data: --data-local, --resources and --user-data. Each replaces that setting in the result, and none is searched for files. Hover over each for what OpenMW uses it for.

Output#

ChoiceWritesCommand line
Preview onlyNothingneither --output nor --in-place
Save asThe Output path--output
Update existing openmw.cfgThe Existing cfg--in-place

Press Import / Preview. The button says why it cannot run yet: no Morrowind.ini, no output path for Save as, or no existing cfg to update. Writing the cfg covers what each choice keeps of the cfg you started from.

Results#

TabShows
ErrorsWhy the import failed. Nothing was written
WarningsLines skipped and a load order that stopped early
EventsEvery content file and archive found, and every data= folder added
Generated cfgThe whole cfg, exactly as written or as it would be

Copy puts the generated cfg on the clipboard, and Clear empties the results. After a write, the window names the file it wrote.

Picking files#

Browse… opens Dream INI’s own picker rather than the system’s, so it works the same with a controller and on a handheld. It starts where the field’s path points. Parent goes up a folder, Refresh rereads it, and Show hidden directories reveals folders such as ~/.config/openmw. For an output file, type its name under File name.

Languages#

Language switches the window between English, French, German, Russian, Spanish and Swedish. The window starts in English.

Controllers#

On Linux, Dream INI reads controllers from /dev/input itself. If your session cannot read those devices, the window still works, without the controller; adding yourself to the group that owns them, usually input, fixes it. Windows and macOS read controllers through gilrs.

On the form:

ButtonDoes
D-pad or left stickMove between fields
AToggle a checkbox, open a picker, or type into a path with the on-screen keyboard
XClear the selected path
Left and rightChange the selected option, such as the encoding or the language
StartImport
Select, or BLeave Dream INI
Right stickScroll the generated cfg
LB and RBPage through the generated cfg

In the picker:

ButtonDoes
AOpen the selected folder, or choose the selected file
B or leftGo to the parent folder
RightOpen the selected folder, or choose the selected file
StartChoose the current or expected path
LBShow or hide hidden folders
SelectCancel

On the path keyboard, A presses a key, B shifts, Y types a space, X deletes, Start applies, and Select cancels. The window shows the buttons for whatever is on screen.