With the increase in functionality of the Opus configuration system, the distinction between Environment settings which just affect the visual display and Options which just affect the
operation of the program functions has become blurred. To allow you to find settings more easily, the Options editor has been removed and the settings amalgamated into a new expanded
Environment section. The older Environment sub-menu has been removed from the Settings menu. Now there is just one Environment menu to access the editor.

Loading and saving of Environments is done from the new Load/Save Environment menus directly. Alternatively you may load it directly from Environment editor's menu just like all the other preference-style editors.

If you load an Environment from the Load Environment menu, this will load the full Environment settings including all aspect of the visual display including referenced objects such as buttons, start
menus, Listers, etc. However, if you load a new Environment from within the editor, only the direct Environment settings will be loaded and reset.

The Save Layout option is now a distinct function in the Settings menu. This lets you save the current layout immediately on demand.

The following details the changes to these environment sections.

See also Menus, Options


Opus Magellan can display background images directly using a defined or random picture or you may use your old WBPattern Preferences. (Similarly, you may also have images in Button Banks and Start Menus.)

Enable Backgrounds lets you turn on or off all background pictures in Opus. Underneath are three fields which select a picture file for the Desktop (Opus main window), Windows (Listers
and groups) and Requesters. At the far right of each field is a gadget for a popup menu to control how the images is displayed.

Display gives you the ability to centre, tile or stretch the image and set the border colour for centred pictures (normal, black or white).

--> The term 'Stretch' means adjust the size of the image either larger or smaller to fit the current screen display size. Stretch may not function correctly under RTG systems.

Remapping controls how the picture is colours are remapped to be displayed on your screen, and affects the number of pens used and the quality of the final result. The actual level used should be
determined by how many spare pens are available on your screen and the complexity of the actual image. For example, if using a 24-bit display, start with Best and experiment with the settings until you achieve the desired result.

--> The Amiga Datatypes system is responsible for remapping the images so the results achieved may be dependent upon your datatypes settings.

Use WBPattern Prefs enables the original behaviour as in earlier versions of Opus. When enabled, Opus will use the WBPattern preferences file to set the picture or pattern displayed on the desktop or in Listers and groups.

--> Under OS2.0 and 2.1, you can only use WBPattern prefs, and only to generate patterns, not pictures. The picture display system relies on the Amiga Datatypes system, which is not available under OS2.0.

Random Pictures

Random background images are now supported. If a directory or wildcard pattern is specified instead of a filename, DOpus will pick a new random picture from the directory every time it is run.

Note on Comment Field of Image files

As a special feature, the file comment of background pictures can be used to specify individual settings for that picture. These will override the settings configured in the environment. This feature
might be useful if you were using random background pictures and had some pictures that needed to be tiled, some that needed to be centred, etc. It also allows you to specific the layout of a designed background image more exactly when you give files to others. For example, your image may look best when tiled or maybe when centred with a black border.

To enable this feature, the file comment of the picture file must begin with the word "dopus " followed by a number of keywords:

  dopus   [tile|center|stretch] [precision <precision>],
      [border off|<colour>]

tile, center, stretch specify the layout of the picture; precision lets you specify the remapping precision: none, gui, icon, image, exact; border lets you specify the colour for the border (when a picture is centred), or turn the border off. The colour value is specified in hex. If any or all of this information is not provided, the current configuration settings will be used instead.

--> This system of file comments is specifically designed to OVERRIDE your Environment settings. ANY image file with the correct comments will override all user layout settings including when used as part of a theme. If you wish to adjust the settings yourself then you MUST REMOVE the comments first!

CLI Launching

We have reorganised and renamed the older Output Window section to CLI Launching. These settings allows you to set the title, size and device of the Output Window used by Opus 5 to display CLI tasks and associated messages.

Device: The name of the console device used for the output window. Normally this will be set to CON: but there are other console devices which provide extra features that you may have installed. To use KingCon, for instance, enter KCON: in this field.

Stack: This allows you to set the stack for AmigaDOS programs which DOpus executes (the default is 4000 bytes). Although poor programming practice, some Amiga programs will crash if run with a traditional default 4K stack. In such cases you may need to set this to a higher value, say 50K. (Converted UNIX programs run by the Ixemul system are an example where large stacks are required.)

CLI Launching/Max: This controls the maximum line length used for all internal Opus commands.


The Desktop section controls have been revised with the icon parts moved to their own section.

The operation of the Hidden Drives list has been changed and now doesn't discard the entries of devices that aren't present. This means that if you have a device which is not always mounted, its
entry won't get lost (or reset) if you go into Environment without it mounted.

A cycle gadget allows you to set both hidden disks and hidden bad disks so you may selectively hide devices that have bad disks in them. For example, if you had four filesystems mounted on the
one drive, you could hide all of them for bad disks except for one.

Desktop Folder: This is the physical location of the drawer used by Opus to hold the desktop files. By default this is the directory DOpus5:Desktop. See the Opus Desktop section for a description
of the other settings.


The older Cache settings from Options has been expanded and split into two new sections named Directories and Miscellaneous. Some features previously controlled by environment variables have been moved to these sections for ease of access. New are:-

Enable MUFS Support: Provides limited support for the MultiUserFileSystem and will open the library on startup.

Robert Milkowski <milek@disneyland.mif.pg.gda.pl> posted the following on the DOpus5 Mailing list which sums up how to easily get MUFs and Opus running together.

"I've got better solution that this one on Aminet. Just after LoadWB (using Opus as WB replacement) in startup-sequence type: Login own task "DO_LAUNCHER" global and everything will be ok. You have to have .166 version of multiuser.library (on Aminet). Of course in startup- sequence there is : logout global [gui] somewhere before loadwb. It's better 'coz you don't have to retype password like in this one on Aminet.."

So just use the following lines:-

  Logout <NIL: >NIL: Global GUI
  Login <NIL: >NIL: Own Task "DO_LAUNCHER" Global

Maximum Filename Length: Opus now internally supports file names up to 107 characters in length. Set the maximum length you wish to use in this variable. The default is 30. See General.

Icon Display

This new section allows configuration of the NewIcons settings within Opus plus the Font and Colour settings for all icons.

Currently available options include:-

  • Enable NewIcons turns NewIcons support on or off.
  • Discourage NewIcons tells Opus to only shows a NewIcon image if there is no 'standard' image (i.e if the image is less than 5x5 in size)
  • Dither Image turns on dithering for NewIcons.
  • Pen Precision sets the precision for NewIcons.

The Dither Image and Pen Precision settings affect the operation of the NewIcons system itself. It was necessary for Opus to have these settings since version 3 of the newicons.library does not load the user-defined NewIcons preferences (unless the c:NewIcons patch is running.) Version 4 of the newicons.library reads the user preferences automatically, however you can still adjust the settings through this Opus section as well as through the NewIcons Prefs.

--> If a change is made to any of these settings you will need to restart Opus for the change to become effective.

From Desktop you may edit the font settings for icons on the desktop and from Windows you may edit the font settings for icons in Listers/groups.

Shadow or Outline fonts for Desktop and window icons may be chosen from the font requesters.

Icon Settings

The main options which control icon handling have been collected and incorporated into the new section. In previous versions of Opus, some of these settings were controlled by esoteric ENV:
variables. These have been removed and are now displayed as normal configuration items.

Allow icons with no labels: This will disable label-less icons. Some users have been reporting that their icons are showing up with no labels. Obviously, the special bit in the icon structure used by Opus uses is accidentally set. (See the FixIcons Command.)

Borderless Icons are fully transparent: Tells Opus to render its borderless icons with colour 0 transparent over the whole icon, rather than just colour 0 around the edge. This results in quite a large speed increase when loading borderless icons.

Force split of long labels: This setting complement the Split Long Icon Labels. By default the algorithm will only split labels on spaces, punctuation characters or on a capital letter. If there is nowhere to split the text then the label won't be split at all. This setting forces Opus to split the label at the 150% point.

Icon Borders on by default: Turns on all icon borders by default but can be overridden on an individual icon basis from the Icon Information requester.

Quick icon dragging: If enabled, icons will no longer be masked when they are dragged. This results in an opaque background to the icon (as in Workbench) but is much quicker.

Remove Opus Icon Positions: Theoretically, setting this option along with the Use Workbench Icon Positions enables you to move an older Opus-ised system back to a Workbench position system without having to resnapshot all your icons. With this flag set, Opus will use the Opus icon position set in the icon structure if there is one. When the icon is snapshotted, the Opus position will be removed, and the Workbench position will be saved. Next time the icon is read the Workbench position will be used.

Show Left-out Arrow on left-out icons: Controls the little arrow shown on the bottom left of left-out icons.

Smart icon copying: Opus 5.5 copied icons using library calls from the Amiga icon.library of GetDiskObject() / PutDiskObject() to provide compatibility with some Public Domain programs. Unfortunately this method had some unwanted artefacts. Opus Magellan now copies icons as normal using a straight byte copy. However, if you set this option, it will copy icons with the older Get/PutDiskObject() method as before.

Split Long icon labels: If an icon's label is more than 1.5 times the width of the icon itself, it can be split onto multiple lines. The algorithm will only split labels on spaces, punctuation or on a capital letter. If there is nowhere to split the text then the label won't be split at all unless Force split of long labels is turned on.

Use custom drag routines: This switch should be ON for non-RTG (AGA,ECS) since it will make dragging faster. You may want to turn this switch OFF if you are using an RTG system that has its own dragging routines (For example, CyberGraphics, Picasso).

Use Workbench icon positions: Tells Opus to use the same fields in the icon as used by Workbench to store and retrieve icon and window positioning information. This provides better
compatibility when you are swapping disks with other users. If you use Opus's internal icon positioning system then snapshot a disk and give this to another user, the icons will not be arranged correctly for them.

Lister Colours

The settings for Lister colour adjustment have been collected in their own section. The colour settings now have an additional custom pen for each of the settings. This pen is completely separate from the standard user/system pens. It can be configured individually for each element, providing there are free pens available. At the moment, the custom pen is only implemented by the free space gauge, but the other elements will be using it in the next version.

--> When setting the colours for the free space gauge, the foreground colour is used when the bar shows less than 90% full, and the background colour is used when the bar is at 90% or above. This lets you have a warning colour when the disk is getting full!

Lister Default

Lister default allows you to set the Default size and Default format for Name Mode Listers.

Lister Display

Lister Display now controls the default Lister font and Lister status bar text display.

Lister Options

These settings collect special options for Lister displays. New settings include:-

  • Allow file select on source activation: Traditionally, when you clicked in a Lister to activate it as a source (SRCE) Lister, if you clicked on a file, that file would also become selected. With this new option turned on, Opus will behave as before.
  • With this option turned off, when you click on a file in a Lister that is not the source Lister, the Lister will be set to source but the file will not be selected. Note that this option only has effect if there is more than one Lister currently open.
  • Window zooms to title bar: For many users, the traditional 'zoom' gadget is less than useful so we have provided a mechanism to change its function. With this option set, the zoom gadget causes the Lister to shrink down to just the title bar. This is often much more useful than fully iconifying the Lister since it provides a smaller visual footprint which is easy to move around the desktop.
  • Inline Editing: Enables inline editing of the name and details in name mode Listers. You can perform the equivalent of Rename, Comment, Date and Protect functions directly in the Lister without having to bring up a requester.
  • The cycle gadget controls how the activation of inline editing. Left Button means that you must hold the left mouse button over the entry for a certain time before editing mode is activated. Likewise, Middle Button means that you must hold the middle mouse button down. Left & Middle means that both buttons work.
  • When in Inline Editing mode, TAB moves to the next field and SHIFT-TAB moves to the previous one. Press RETURN to save the changed you have made, or ESC to cancel. SHIFT-Del and SHIFT- BACKSPACE delete from the cursor to the end of field or start of the field respectively.


A new section derived from assorted settings from the old Options area. New are:-

  • Thin gadget borders: Turning this on will make all Opus gadgets (except the ones provided by GadTools) use single-pixel vertical borders, to improve the appearance on 1:1 ratio screens.
  • Popup Delay: You may now control how quickly popup menu sub-menus open by setting the value in 50ths of a second. The default is 10 or about a fifth of a second.
  • Maximum 'Open With' Entries: Project files have a new Open With.. in the file popup menu, which lets you select an application to open the file with. Opus remembers up to the last 10 programs chosen, and displays them in the menu for you to select from. You can control the maximum number of items in this menu with this setting.
  • Custom Screen Title: Many users have traditionally used various third party utilities to customise the text display in the screen (Workbench/Desktop) title bar. Some of these utilities caused problems when used with Opus so we have now incorporated this feature internally in Opus itself. The screen title can now be extensively customised using a simple text string with command arguments.

You may choose from the following command sequences:-

  %cp      CoProcessor type
  %cs      Graphics chip set
  %dv      Directory Opus version
  %ev%  sequence Environment variable (Note)
  %fc   Free chip memory
  %ff   Free fast memory
  %fm      Free memory
  %fp      Free Pen Count
  %kv      Kickstart version
  %pm   Phase of the Moon
  %pr      Processor type
  %pu      Processor usage
  %sc      Screen Count
  %ta   Task count
  %tc   Total chip memory
  %tf   Total fast memory
  %tm      Total memory
  %uc      Chip memory in use
  %uf      Fast memory in use
  %um   Memory in use
  %wv   Workbench version
  %%%   character

Note the special Environment variable. This allows you to expand the Opus display to include practically any string or value. This sequence reads the named variable and displays the result. Usage is %ev<name>%. For example,


The memory fields can be further customised by following them with these codes:

  K  Kilobytes, to one decimal place
  k  Kilobytes, no decimal places
  M  Megabytes, to one decimal place
  m  Megabytes, no decimal places
  S  "Smart" mode (bytes, kb, mb, depending on the actual
   amount), one decimal place
  s  Smart mode, no decimal places
  %  Percentage of total memory (free or in use memory
  %cs reports P96 for Picasso96 and CGX for CyberGraphics
   screen modes

For example,

Opus v%dv Memory %fm%%% free, %um%%% in use
  CPU %pu%% %ta tasks

Path List

The Amiga has a rudimentary system of setting the system search path which is searched when you attempt to run a program. Normally, paths are set by S:User-Startup when you boot your
system. Like Workbench, Opus inherits the path list from the initial CLI from whence it is run. However, depending on exactly what boot utilities you are running, paths within Opus can be incompletely defined. Specifically, if you are running one of the dual-boot or multi-user systems on the Amiga, paths can be lost.

Now you may configure the path list used by Opus directly, without having to worry about where the path list has been inherited from.

Sound Events

This new section allows you to configure a sound to be played automatically for certain events. The event list is the same as for scripts, but it saves you having to configure a whole script just to play a sound file.

The Test button allows you to quickly test the highlighted sound.

The Volume of the sound many be set from 0-64 by entering a number or using the slider.

--> Some datatypes do not support the volume command. At least one of the WAV datatypes does not and you cannot alter the volume - it will play at full volume only.

Exclusive Startup/Shutdown Sounds. If you have a multitude of sound events set to be called when Opus starts up or shuts down, because the Amiga can only handle a limited number of sounds at once, such multiple sounds can interfere with each other or be lost. With this option set, no sounds will be played until the Startup sound has been played, and no sounds other than the Shutdown sound will be played on shutdown.

Random Sounds

As with background pictures, Sound Events supports random sounds by specifying either a directory or a wildcard pattern as the sound filename. Random sounds are only assigned when the
environment is loaded, or when a sound setting is modified - they do not change every time they play. If required, you can specify the volume for a sound by setting the comment of the sound file to
the desired volume to a number from 1 to 64. See also ARexx/Dopus Set Sound, ARexx/Dopus Query Sound, Scripts.

WB Emulation

The old Display Options section has been renamed WB Emulation, since the backdrop picture settings are now in their own section.

The new setting, Move AppIcons to Tools Menu allows you to redirect AppIcons to menu items in the Tools Menu. Note that changing the flag only affects AppIcons added after the change is made.

Changes to Environment Variables

The following additions to the ENV variables (ENV:Dopus / <variable>) allow fine tuning of esoteric aspects of the Opus interface and command behaviour. Generally these variables are only read when Opus is started. If you wish to change a settings you will need to quit and restart Opus for these variables to be re-read.

WorkbenchTitle: When set to 1, Opus will not generate its own clock/memory display in the screen title bar. Instead, it will set the screen title to Amiga Workbench. This lets it be intercepted by programs such as MCP, which allows you to configure the title bar display. But why not use Opus's in-built system to customise the screen title? See Environment/Miscellaneous.

HidePadlock: If set to 1, the padlock title bar gadget will not be added to Listers.

WARNING: Opus also contains a number of other environment variables for internal use. DO NOT SET any environment variables unless advised by GPSoftware technical support. We will not guarantee the behaviour of Opus if you set random variables. Just Don't Do It!