Enhanced Info windows with support for changing icons and swapping their colors.
User defined menus.
Docks with support for drag and drop of icons.
Support for launching tools at startup.
User defined global hot keys for window management and more.
Requirements
Minimum 1MB of memory.
reqtools.library (version 38.390 for Kickstart 1.3 included).
iffparse.library (version 37.1 for Kickstart 1.3 included).
Default icons in ENVARC:Sys (included).
Installation
The included installation script will copy the required files but some changes must be made to S:Startup-Sequence manually.
Old Blue Workbench requires the ENVARC: assign for locating the default icons so add the following to
S:Startup-Sequence if it doesn’t already exist.
C:Assign ENVARC: SYS:Prefs/Env-Archive
To launch Old Blue Workbench instead of the original Workbench when Old Blue Workbench has been installed in SYS:Tools/OldBlue
replace the LoadWB command in S:Startup-Sequence with:
The STARTUPDRAWER argument specifies the path to a drawer with tools and projects to launch at startup.
The SHOWSTARTUP argument tells Old Blue Workbench to show a window with a progress bar while launching these tools and projects.
The STARTPRI tool type can be set for each of the tools and projects to control the launch order.
LaunchDaemon is a background task that is used by Old Blue Workbench to launch tools and commands.
It makes it possible to quit Old Blue Workbench without quitting all tools launched by it.
Workbench windows
There are three types of Workbench windows that are used for navigating the file system and share most of their behavior.
Browser windows are used for browsing the file system and can show all disks and the content of drawers and disks.
Mouse interaction
Clicking the mouse’s select button when the mouse pointer is over the background and dragging will extend a lasso for selecting multiple icons.
Clicking the mouse’s menu button when the mouse pointer is over an icon will deselect all selected icons and select that icon before
showing the Icon menu as a context menu. If the SHIFT key is pressed when clicking the mouse’s menu button then no icons
will be deselected.
Clicking the mouse’s menu button when mouse pointer is over the background will show the Window menu as a context menu.
Keyboard interaction
Cursor keys can be used to scroll the content of the windows. Pressing a SHIFT key while using the cursor keys will scroll to the end points,
and pressing an ALT key will scroll only a single pixel.
Workbench window
Workbench window
The Workbench window shows disk icons and can be a backdrop window or a normal window with a titlebar, resize gadget and scrollbars.
Whether the window is a backdrop window or a normal window is set in the Project menu.
By default the Workbench window will position icons without a saved position from top to bottom on the right side of
the window but this can be changed in the Workbench Appearance tab in the
Appearance Settings window.
The Workbench window also supports opening a browser window by double clicking the background.
This functionality is disabled by default but can be enabled in the General Setting window.
Drawer windows
Drawer window
Drawer windows show the contents of a drawer or disk and there will always only be one drawer window for a drawer or disk open.
Trying to open another drawer window will only bring the existing drawer window to the front.
By default a drawer window shows only files and drawers that have an icon but this can be changed in the Icon menu.
Browser windows
Browser window
Browser windows are used for browsing the file system.
They have much of the same functionality as drawer windows but there are some major differences.
A browser window has a navigation bar with the following items from left to right:
A Back button going back in the path history.
A Forward button going forward in the path history.
A Parent button that can be used for making the browser window show the content of the parent drawer or disk.
A Root button for showing disks and, if Show All Files is selected, assignments.
A Path text field where the path of the drawer or disk to show the content of can be set.
A blank path shows all disks. Icons can be dragged and dropped on this text field to set the path.
A browser window has an optional filter bar that can be shown with the Filter command in the Window menu.
When the filter bar is shown, the browser window will only show icons with names that contains the filter string.
A browser window will show all disks and, if Show All Files is selected, assignments as the root of the file system.
Opening a drawer within a browser window will just make the browser window show that drawer instead.
A browser window can be set to use a rows or grid layout instead of using the saved icon positions.
When set to a rows or grid layout, the icon positions are automatically updated whenever icons are added, removed or the window is resized.
A browser window can also be set to automatically sort the icons when rows or grid layout is used.
Workbench menus
When the Workbench window, a drawer window or a browser window is active is has the following menus:
Backdrop sets whether the Workbench window is a backdrop window without any borders or a normal window with borders.
Open Browser opens a new browser window.
Open Drawer… opens a file requester for selecting which drawer to open and then opens the selected drawer.
Execute Command… opens the Execute Command window for executing a command with or without arguments.
Update All makes all drawer and browser windows to update their content.
About… opens the About window.
Quit quits Old Blue Workbench.
Window menu
New Drawer… opens the New Drawer window for creating a new drawer in the active window.
New File… opens the New File window for creating a new file in the active window.
Open Parent opens the parent drawer of the active window. If the active window is a drawer window the drawer window for the parent drawer is opened. If the active window is a browser window the parent drawer will be opened in the active window.
Close closes the active window.
Update updates the content of the active window.
Select All selects all icons in the active window.
Filter shows the filter bar in the active browser window.
Arrange By arranges all icons in the active window.
Name arranges the icons in a grid sorted by name as a one-time action in drawer windows.
Browser windows are set to always sort the icons by name.
Type arranges the icons in a grid sorted by type and then name as a one-time action in drawer windows.
Browser windows are set to always sort the icons by type and then name.
Snapshot
Window saves the size and position of the active window. If the active window is a drawer window the size and
position is saved immediately to disk. If the active window is a browser window the size and position will be used for
new browser windows, but the size and position will not be saved to disk until the settings are saved.
All saves the size and position of the active window and the positions of all icons in the active window.
Show
Only Icons makes the active window show only files and drawers with icons.
All Files makes the active window show all files and drawers. Default icons are used for files and drawers without
icons.
Icon menu
Open opens selected files and drawers.
Open With Browser opens selected drawers and disks in new Browser windows.
This can also be done by pressing one of the ALT keys while double clicking on a drawer or disk.
Copy creates copies of selected files and drawers in the drawer they’re in.
Rename… opens the Rename window for renaming the selected file, drawer or disk.
Information opens Info windows for selected files, drawers and disks.
Align aligns all selected icons in the active window with the first selected icon.
Left aligns the left edge of the icons.
Center aligns the horizontal center of the icons.
Right aligns the right edge of the icons.
Top aligns the top edge of the icons.
Middle aligns the vertical middle of the icons.
Top aligns the Top edge of the icons.
Distribute distributes all selected icons in the active window along an axis from the first selected icon in the order the icons were selected.
Horizontally distributes the icons horizontally.
Vertically distributes the icons vertically.
Snapshot saves the position of selected icons.
Unsnapshot clears the saved position of selected icons so that they’re positioned automatically the next time they’re read.
Delete deletes selected files and drawers.
Format formats selected disks.
Empty Trash deletes the content of selected trashcans.
Default Icons… opens the ENVARC:Sys drawer where the default icons are located.
Changes made in this drawer are not loaded automatically so Load Default Icons must be used before the changes
have any effect.
Load Default Icons loads default icons from the ENVARC:Sys drawer.
Loading new default icons does not affect already open windows until their content is updated.
Load… opens a requester where a settings file to load can be selected and then loads the settings from that file.
Save saves the current settings to the S:OBWorkbench.settings.
Save As… opens a requester where a settings file to save the current settings to can be selected and then saves the current settings to that file.
Last Saved loads the settings from S:OBWorkbench.settings.
Settings windows
General Settings window
General Settings window
The General Settings window contains the following settings:
Use default tool path sets how the path set in the Default Tool field in Project Info window is used when searching for the tool.
Only searches using only the full path. If the path is relative LaunchDaemon will search relative
to the drawer the project is in and then relative to the search path when LaunchDaemon was started.
First searches using the full path and then using the tool name.
Last searches using the tool name and then using the full path.
Never searches using only the tool name.
Default command stack size sets the stack sized used when executing commands. For dock items, menu items and hot key items the
stack size can be overridden for each item.
Show minimize window gadget in the title bar sets whether a gadget for minimizing a window to just its title bar is shown next to the depth gadgets
in the title bar.
Double click title bar to move window to front sets whether double clicking a window’s title will move the window to front.
Double click Workbench background to open browser sets whether double clicking the background in the Workbench window opens
a new browser window with the settings set in the Browser Settings window.
At the bottom there are three standard buttons for settings windows:
Save closes the window, applies the changes and saves the settings.
Note that this saves all settings not just the general settings.
Use closes the window and applies the changes but does not save the settings.
Cancel closes the window and discards the changes.
Appearance Settings window
The Appearance Settings window has three tabs:
Workbench for settings related to the main Workbench window.
Drawer for settings related to drawer windows.
Browser for settings related to browser windows.
At the bottom there are three standard buttons for settings windows:
Save closes the window, applies the changes and saves the settings.
Note that this saves all settings not just the appearance settings.
Use closes the window and applies the changes but does not save the settings.
Cancel closes the window and discards the changes.
Workbench Appearance tab
Workbench tab in Appearance Settings window
Background is the background used by the Workbench window. Clicking Edit… opens the Edit Background window.
Icon font is the font used for icons in the Workbench window. Clicking Edit… opens the Edit Font window.
Icon position sets where the icons for disks without icons or with icons without a saved position will be positioned.
Top positions the icons from left to right at the top of the Workbench window.
Left positions the icons from top to bottom on the left side of the Workbench window.
Bottom positions the icons from left to right at the bottom of the Workbench window.
Right positions the icons from top to bottom on the right side of the Workbench window.
Drawer Appearance tab
Drawer tab in Appearance Settings window
Background is the background used by drawer windows. Clicking Edit… opens the Edit Background window.
Icon font is the font used for icons in drawer windows. Clicking Edit… opens the Edit Font window.
Browser Appearance tab
Browser tab in Appearance Settings window
Background is the background used by browser windows. Clicking Edit… opens the Edit Background window.
Icon font is the font used for icons in browser windows. Clicking Edit… opens the Edit Font window.
Edit Background window
The content of this window depends on the background type, but the first field is always the Type field for
setting the background type. Possible background types are:
Color for using a single solid color as background.
Image for using an image as background.
Pattern for using a simple two-color pattern as background.
Edit Color Background window
Edit Color Background window
Color is the color used as background.
Edit Image Background window
Edit Image Background window
Path is the path to the image used as background.
Alignment is the alignment of the image within the window.
Repeat image sets whether the image is repeated to fill the window or not.
Edit Pattern Background window
Edit Pattern Background window
Pattern is the pattern used as background.
Primary color is the primary color of the pattern.
Secondary color is the secondary color of the pattern.
Edit Font window
Edit Font window
Font sets the basic font attributes like font name, size and styles like bold, italic and underline.
The … button opens a font requester for selecting the font.
Color sets the color used for the font.
Decoration sets whether text is drawn with an additional decoration and if so, what the decoration is.
None draws text without any decoration.
Color background draws text with a solid color background set by Decoration color.
Shadow draws text with a drop shadow. Decoration color is used for the drop shadow.
Outline draws text with an outline. Decoration color is used for the outline.
Decoration color sets the color used by the decoration.
Browser Settings window
Browser Settings window
The Browser Settings window contains the settings for browser windows opened with Open Browser in the
Project menu or by double clicking the background in the Workbench window.
Path is the path to the drawer or disk to open in the browser window. A blank path shows all disks.
Shows is what to show in the browser window.
Only Icons shows only files and drawers with icons.
All Files shows all files and drawers by using default icons for files and drawers without icons.
Sort is how the icons shall be sorted in the browser window.
No does not sort the icons so that are shown in the order read from disk.
By Name sorts the icons by name.
By Type sorts the icons by type and then name.
Layout is how the icons are laid out in the browser window.
Workbench uses the position icon positions.
Grid positions icons in rows and columns.
Rows positions icons in rows.
Name position is where the icon name is positioned.
Bottom positions the name under the icon.
Right positions the name on the right side of the icon.
User defined menus
Old Blue Workbench enables the user to define additional menus that are shown when the Workbench window, a drawer window, a browser window or a dock is active.
The user defined menus can have menu items of several different types:
Tool for opening a tool as if it was opened from Workbench.
Trashcan for opening a trashcan, deleting files or drawers or moving them to a trashcan.
Select Edit Menus… in the Settings menu to edit these menus.
Edit Menus window
Edit Menus window
This window has a list of the user defined menus on the left and a list of the items in the currently selected user defined menu on the right.
At the bottom this window has three buttons.
Save closes the window, applies the changes and saves the settings.
Note that this saves all settings not just the user defined menus.
Use closes the window and applies the changes but does not save the settings.
Cancel closes the window and discards the changes.
Menu list
On the right side of the menu list there are buttons for editing the list.
Add adds a new menu.
Remove removes the currently selected menu.
Up moves the currently selected menu up in the list of menus.
Down moves the currently selected menu down in the list of menus.
In addition, the list has a text field with the name of the currently selected menu.
Changing the content of the text field and pressing RETURN will rename the menu.
Menu item list
On the right side of the item list there are buttons for editing the list.
Add opens the Edit Menu Item window for adding a new item to the currently selected menu.
Add Separator adds a separator for grouping items to the currently selected menu.
Tool for opening a tool as if it was opened from Workbench.
Trashcan for deleting files or drawers or moving them to a trashcan.
Name is the name of the menu item and is shown in the menu.
Shortcut is an optional keyboard shortcut for the menu item.
Edit Browser Menu Item window
Edit Browser Menu Item window
Path is the path to the drawer or disk to open in the browser window. A blank path shows all disks.
Shows is what to show in the browser window.
Only Icons shows only files and drawers with icons.
All Files shows all files and drawers by using default icons for files and drawers without icons.
Sort is how the icons shall be sorted in the browser window.
No does not sort the icons so that are shown in the order read from disk.
By Name sorts the icons by name.
By Type sorts the icons by type and then name.
Layout is how the icons are laid out in the browser window.
Workbench uses the position icon positions.
Grid positions icons in rows and columns.
Rows positions icons in rows.
Name position is where the icon name is positioned.
Bottom positions the name under the icon.
Right positions the name on the right side of the icon.
Edit Command Menu Item window
Edit Command Menu Item window
Path is the path to the command to execute when the menu item is selected.
Action is what to do when the menu item is selected. There are three options:
Open executes the command with only the arguments specified in Arguments.
If Expand argument variables is selected, any variable based on the selection will be blank.
Open with… opens a file requester where files and drawers can be selected.
If Expand argument variables is selected, the selected files and drawers are available as variables.
If not the paths to the files and drawer are added to the arguments specified in Arguments.
Open with selection executes the command with the paths to selected files, drawers and disks added to the
arguments specified in Arguments if Expand argument variables is not selected.
If Expand argument variables is selected, the selected files, drawers and disks are available as variables.
Arguments are arguments passed to the command. If Expand argument variables is selected anything enclosed in
$() will be expanded as a variable. $$ can be used to get a single $.
Insert Variable is enabled when Expand argument variables is selected and opens a window
where a variable to be inserted at the current cursor position in Arguments can be selected.
Stack size is the stack size used when executing the command. If blank, the default command stack size set in
General Settings window is used.
Console is an optional console specification. If not set the default, CON:0/11/640/189/Command Output, is used.
Close console window when completed is whether the console shall close immediately when the command is completed
or if the user must press ENTER to close the console.
Expand argument variables is whether any variables in Arguments are expanded before the arguments are passed
to the command.
Edit Dock Menu Item window
Edit Dock Menu Item window
Dock has an Edit… button that opens a Edit Dock window for the dock opened by this menu item.
Close dock when deactivated sets whether the dock closes when the dock is deactivated or stays open.
If it stays open this menu item is used to toggle between opening and closing the dock.
Edit Drawer Menu Item window
Edit Drawer Menu Item window
Path is the path to the drawer to open.
Edit Tool Menu Item window
Edit Tool Menu Item window
Path is the path to the tool to open when the menu item is selected.
Action is what to do when the menu item is selected. There are three options:
Open opens the tool with no arguments.
Open with… opens a file requester where the files and drawers to be passed as arguments to the tool
can be selected and then opens the tool with those arguments.
Open with selection opens the tool with any selected files, drawers or disks as arguments.
Edit Trashcan Menu Item window
Edit Trashcan Menu Item window
Path is the path to the trashcan.
Action is what to do when the menu item is selected. There are three options:
Open opens the trashcan in a drawer window.
Delete deletes all selected files and drawers.
Move to trashcan moves all selected files and drawers to the trashcan.
Any selected files and drawers on a different volume than the trashcan will first be copied
to the trashcan and then deleted.
Docks
Old Blue Workbench supports docks which are windows with a row or a column with dock items.
Dock items are buttons that can show the item’s image, the item’s name or both and can perform different actions when clicked,
when icons are dropped on them or from their context menus.
Tool for opening a tool as if it was opened from Workbench.
Trashcan for opening a trashcan, deleting files or drawers or moving them to a trashcan.
Dock keyboard interaction
When a dock is active the number keys can be used to perform the same action as clicking on a dock item.
1 is the first dock item, counting from the left or the top, and 0 is the tenth.
Edit Dock window
Edit Dock window
On the left side of the window there are fields for configuring the appearance and the behavior of the dock.
Layout is the layout orientation of the items in the dock.
Horizontal orders the items in a single row.
Vertical orders the items in a single column.
Border is whether and where the dock draws a beveled border.
None draws no border.
Around dock draws a single border around the whole dock.
Around items draws a border around each individual item.
Position is where the dock is positioned.
Show item as is how items are shown.
Image shows just the item image.
Name shows just the item name.
Image and name show both the item image and name.
Item layout is how the item image and name are positioned relative to each other.
Horizontal positions the item name to the right of the image.
Vertical positions the item name below the image.
Item font is the font used for the item name. Clicking Edit… opens the Edit Font window.
Background is the background used by the dock item if Border is Around items or by the dock if not.
Clicking Edit… opens the Edit Background window.
Show dragbar sets whether a small dragbar is shown that allows the dock to be positioned manually.
On the right side of the window there is a list of the items in the dock and buttons for editing that list.
Tool for opening a tool as if it was opened from Workbench.
Trashcan for deleting files or drawers or moving them to a trashcan.
Name is the name of the dock item and can be shown in the dock.
Edit Browser Dock Item window
Edit Browser Dock Item window
Path is the path to the drawer or disk to open in the browser window. A blank path shows all disks.
Shows is what to show in the browser window.
Only Icons shows only files and drawers with icons.
All Files shows all files and drawers by using default icons for files and drawers without icons.
Sort is how the icons shall be sorted in the browser window.
No does not sort the icons so that are shown in the order read from disk.
By Name sorts the icons by name.
By Type sorts the icons by type and then name.
Layout is how the icons are laid out in the browser window.
Workbench uses the position icon positions.
Grid positions icons in rows and columns.
Rows positions icons in rows.
Name position is where the icon name is positioned.
Bottom positions the name under the icon.
Right positions the name on the right side of the icon.
Edit Command Dock Item window
Edit Command Dock Item window
Path is the path to the command to be executed by this dock item.
Action is what to do when the dock item is clicked. There are three options:
Open executes the command with only the arguments specified in Arguments.
If Expand argument variables is selected, any variable based on the selection will be blank.
Open with… opens a file requester where files and drawers can be selected.
If Expand argument variables is selected, the selected files and drawers are available as variables.
If not the paths to the files and drawer are added to the arguments specified in Arguments.
Open with selection executes the command with the paths to selected files, drawers and disks added to the
arguments specified in Arguments if Expand argument variables is not selected.
If Expand argument variables is selected, the selected files, drawers and disks are available as variables.
Arguments are arguments passed to the command. If Expand argument variables is selected anything enclosed in
$() will be expanded as a variable. $$ can be used to get a single $.
Insert Variable is enabled when Expand argument variables is selected and opens a window
where a variable to be inserted at the current cursor position in Arguments can be selected.
Stack size is the stack size used when executing the command. If blank, the default command stack size set in
General Settings window is used.
Console is an optional console specification. If not set the default, CON:0/11/640/189/Command Output, is used.
Close console window when completed is whether the console shall close immediately when the command is completed
or if the user must press ENTER to close the console.
Expand argument variables is whether any variables in Arguments are expanded before the arguments are passed
to the command.
Edit Dock Dock Item window
Edit Dock Dock Item window
Dock has an Edit… button that opens a Edit Dock window for the dock opened by this dock item.
Close dock when deactivated sets whether the dock closes when the dock is deactivated or stays open.
If it stays open this dock item is used to toggle between opening and closing the dock.
Edit Drawer Dock Item window
Edit Drawer Dock Item window
Path is the path to the drawer to open.
Edit Tool Dock Item window
Edit Tool Dock Item window
Path is the path to the tool to be open by this dock item.
Action is what to do when the dock item is clicked. There are three options:
Open opens the tool with no arguments.
Open with… opens a file requester where the files and drawers to be passed as arguments to the tool
can be selected and then opens the tool with those arguments.
Open with selection opens the tool with any selected files, drawers or disks as arguments.
Edit Trashcan Dock Item window
Edit Trashcan Dock Item window
Path is the path to the trashcan.
Action is what to do when the dock item is clicked. There are three options:
Open opens the trashcan in a drawer window.
Delete deletes all selected files and drawers.
Move to trashcan moves all selected files and drawers to the trashcan.
Any selected files and drawers on a different volume than the trashcan will first be copied
to the trashcan and then deleted.
Drop action is what to do when icons are dropped on the dock item. There are two options:
Delete deletes all dropped files and drawers.
Move to trashcan moves all dropped files and drawers to the trashcan.
Any dropped files and drawers dragged from a different volume than the trashcan will first be copied
to the trashcan and then deleted.
Delete or Close deletes the active dock or closes it depending on whether the dock was created by New Dock… in the
Settings menu or opened by a dock item or menu item.
Snapshot saves the position of the active dock.
Dock Item context menu
Open opens the browser, dock, drawer, tool, trashcan or executes the command depending on the dock item type.
Open With… opens a file requester for selecting arguments before opening the tool or executing the command with those arguments.
Open With Selection opens the tool or executes the command with the selected files, drawers and disks as arguments.
Empty deletes all files and drawers in the trashcan if the dock item is a trashcan.
Old Blue Workbench support user configurable global hot keys.
A hot key may either be a key with or without qualifier keys like shift, alt, control or an Amiga key, or a mouse button click with qualifier keys.
The default hot keys are:
Left Amiga and Tab moves the front window to back.
Shift, left Amiga and Tab moves the back window to front.
Left Amiga and M moves front screen to back. This overrides standard Kickstart 1.3 behavior with standard Kickstart 2.0 behavior.
The Edit Hot Keys window consists of two main columns. On the left is the list of configured hot keys with buttons for
editing that list and on the right is the configured action for the selected hot key.
Tool for opening a tool as if it was opened from Workbench.
Trashcan for opening a trashcan, deleting files or drawers or moving them to a trashcan.
Save screen saves the frontmost screen as an IFF ILBM image.
Save window saves the window under the pointer as an IFF ILBM image.
Save active window saves the active window as an IFF ILBM image.
Ignore prevents the hot key from being passed to other applications.
The actions that saves IFF ILBM images has a Create icon option.
If selected the def_project.ilbm.info, or as a fallback, def_project.info default icons will be used to create an icon for the image.
At the bottom there are three standard buttons for settings windows.
Save closes the window, applies the changes and saves the settings.
Note that this saves all settings not just the hot key settings.
Use closes the window and applies the changes but does not save the settings.
Cancel closes the window and discards the changes.
Edit Browser Hot Key window
Edit Browser Hot Key window
Path is the path to the drawer or disk to open in the browser window. A blank path shows all disks.
Shows is what to show in the browser window.
Only Icons shows only files and drawers with icons.
All Files shows all files and drawers by using default icons for files and drawers without icons.
Sort is how the icons shall be sorted in the browser window.
No does not sort the icons so that are shown in the order read from disk.
By Name sorts the icons by name.
By Type sorts the icons by type and then name.
Layout is how the icons are laid out in the browser window.
Workbench uses the position icon positions.
Grid positions icons in rows and columns.
Rows positions icons in rows.
Name position is where the icon name is positioned.
Bottom positions the name under the icon.
Right positions the name on the right side of the icon.
Edit Command Hot Key window
Edit Command Hot Key window
Path is the path to the command to execute when the hot key is pressed.
Action is what to do when the hot key is pressed. There are three options:
Open executes the command with only the arguments specified in Arguments.
If Expand argument variables is selected, any variable based on the selection will be blank.
Open with… opens a file requester where files and drawers can be selected.
If Expand argument variables is selected, the selected files and drawers are available as variables.
If not the paths to the files and drawer are added to the arguments specified in Arguments.
Open with selection executes the command with the paths to selected files, drawers and disks added to the
arguments specified in Arguments if Expand argument variables is not selected.
If Expand argument variables is selected, the selected files, drawers and disks are available as variables.
Arguments are arguments passed to the command. If Expand argument variables is selected anything enclosed in
$() will be expanded as a variable. $$ can be used to get a single $.
Insert Variable is enabled when Expand argument variables is selected and opens a window
where a variable to be inserted at the current cursor position in Arguments can be selected.
Stack size is the stack size used when executing the command. If blank, the default command stack size set in
General Settings window is used.
Console is an optional console specification. If not set the default, CON:0/11/640/189/Command Output, is used.
Close console window when completed is whether the console shall close immediately when the command is completed
or if the user must press ENTER to close the console.
Edit Dock Hot Key window
Edit Dock Hot Key window
Dock has an Edit… button that opens a Edit Dock window for the dock opened by this menu item.
Close dock when deactivated sets whether the dock closes when the dock is deactivated or stays open.
If it stays open this menu item is used to toggle between opening and closing the dock.
Edit Drawer Hot Key window
Edit Drawer Hot Key window
Path is the path to the drawer to open.
Edit Tool Hot Key window
Edit Tool Hot Key window
Path is the path to the tool to open when the hot key is pressed.
Action is what to do when the hot key is pressed. There are three options:
Open opens the tool with no arguments.
Open with… opens a file requester where the files and drawers to be passed as arguments to the tool
can be selected and then opens the tool with those arguments.
Open with selection opens the tool with any selected files, drawers or disks as arguments.
Edit Trashcan Hot Key window
Edit Trashcan Hot Key window
Path is the path to the trashcan.
Action is what to do when the hot key is pressed. There are three options:
Open opens the trashcan in a drawer window.
Delete deletes all selected files and drawers.
Move to trashcan moves all selected files and drawers to the trashcan.
Any selected files and drawers on a different volume than the trashcan will first be copied
to the trashcan and then deleted.
Record Hot Key window
Record Hot Key window
The Record Hot Key window wait for a key or a mouse button to be pressed or the Cancel button to be clicked.
Qualifier keys are keys that can be held while pressing a hot key and supported qualifier keys are:
Left shift
Right shift
Control
Left alt
Right alt
Left Amiga
Right Amiga
Using a mouse button as a hot key requires a qualifier key.
Info windows
Info windows show info about an object where the object can be a file, drawer or disk.
All info windows show the icon in a recessed rectangle in the top left corner of the window.
An icon can be dragged and dropped in this recessed rectangle to change the icon.
This recessed rectangle also has the Info window Icon menu as its context menu.
All info windows have the following fields:
Name is the name of the object. Changes to this name will cause the object to be renamed when the changes are saved.
Type is the type of the object.
Assign for assignments.
Disk for disks.
Drawer for drawers.
Project for files that are projects.
Tool for files that are tools.
At the bottom all info windows except the Assign Info window have two buttons:
Save saves updated info to the .info file, renames the file, drawer or disk if the name has changed and
closes the info window.
Cancel closes the window and discards the changes.
Assign Info window
Assign info window
The assign info window differs from the other info windows in that it has no editable fields.
Even the icon is not editable so all icon operations except the export operations are disabled.
Path is the path to the disk or drawer the Name is assigned to.
The Info… button opens an info window for the disk or drawer.
Disk Info window
Disk info window
Blocks is the number of blocks on the disk.
Used is the number of blocks in use on the disk.
Free is the number of block available for use on the disk.
Block size is the number of bytes in a block on the disk.
Default tool is the default tool for a disk and is not used by Old Blue Workbench.
Drawer Info window
Drawer info window
Script is set if the file is a script.
Archived is intended to be set when a file or drawer has been archived and reset when changed so that it can be
used determine whether the file or drawer needs to be archived or not.
Readable is set if the file or drawer is readable.
Writable is set if the file or drawer is writable.
Executable is set if the file or drawer is executable.
Deletable is set if the file or drawer is deletable.
Comment is a comment that the user may set to whatever he/she wants.
Project Info window
Project info window
This window is the same as the Drawer Info window but with the following fields added.
Stack size is an optional stack size for the default tool. If not set the default stack size, 4096 bytes, is used.
Default tool is the path to the tool to open with the project file.
Icons can be dragged and dropped on the text field to set the path.
Tool types is a list of tool types that can be read by the tool. Selecting a tool type will put in the text field so
it can be changed. The Add button will add the content of the text field as a new tool type and the Remove
button will remove the currently selected tool type. Double clicking a tool type with the mouse’s select button will
wrap the tool type in parentheses or remove those parentheses if the tool type is already wrapped in parentheses.
Tool Info window
The tool info window is the same as the Project Info window but with the Default tool field
removed.
Info window menus
Info window Project menu
Open… opens a requester for selecting another file, drawer or disk to open an info window for.
Save saves updated info to the .info file, renames the file, drawer or disk if the name has changed and
closes the info window.
About… opens the About window.
Quit closes the info window.
Info window Icon menu
The menu is also available as a context menu by clicking the mouse’s menu button on the icon in the info window.
Import Icon… opens a file requester for selecting a .info file to load and use as the icon.
Import Default Icon imports the default icon for the object for use as the icon.
Import Image… opens a file requester for selecting an IFF ILBM image file to load and use a as the icon.
Import Selected Image… opens a file requester for selecting an IFF ILBM image file to load and use a as the selected image for the icon.
Export Image… opens a file requester for saving the icon as an IFF ILBM image file.
Export Selected Image… opens a file requester for saving the selected image for the icon as an IFF ILBM image file.
This menu item is disabled if no selected image is loaded.
Swap Colors swaps color 1 and 2 in the icon. Useful for making icons from Workbench 2.0 and later look right with Workbench 1.3 colors.
Highlight By sets the icon highlight.
Complement highlights the entire icon including the background surrounding the icon.
Backfill highlights the icon but not the background surrounding the icon.
Image highlights by using a separate selected image.
This menu item is disabled if no selected image is loaded.
Other windows
Insert Variable window
Insert Variable window
This window is shown when using the Insert Variable button under the Arguments field for a command dock or menu item is clicked.
The window has a list view of available variables, and a variable can be quickly inserted by double clicking a variable.
RequestConfirmation opens a requester with a message, a button for expanding to nothing and a button for cancelling.
It is intended to be used for asking the user for a confirmation before executing the command.
It has three optional parameters, the window title, a message and the title of the Ok button.
RequestDevicePath opens a requester for selecting a device and expands to the device name.
It differs from RequestDiskPath in that devices with no disk inserted can be selected.
It has one optional parameter, the window title.
RequestDirectoryPath opens a requester for selecting a directory and expands to the path of the selected directory.
It has two optional parameters, the window title and the initial path for the requester.
RequestDirectoryPaths opens a requester for selecting directories and expands to the paths of the selected directories.
It has two optional parameters, the window title and the initial path for the requester.
RequestDiskPath opens a requester for selecting a disk and expands to the device name for that disk.
It has one optional parameter, the window title.
RequestFilePath opens a requester for selecting a file and expands to the path of the selected file.
It has two optional parameters, the window title and the initial path for the requester.
RequestFilePaths opens a requester for selecting files and expands to the paths of the selected files.
It has two optional parameters, the window title and the initial path for the requester.
RequestOutputFilePath opens a requester for selecting an output file and expands to the paths of the selected file.
It differs from RequestFilePath in that double click on a file is disabled to avoid accidental overwriting of existing file,
and that entering a non-existing drawer name will open a requester for creating that drawer.
It has two optional parameters, the window title and the initial path for the requester.
RequestPaths opens a requester for selecting files and directories and expands to the paths of the selected files and directories.
It has two optional parameters, the window title and the initial path for the requester.
RequestText opens a requester for entering the text to expand to.
It differs from RequestVerbatimText in that the text is intended to be a single argument and will be quoted with " if it contains spaces.
It has four optional parameters, the window title, a message to be shown above the text field, the default text and the title of the Ok button.
The default window title is the name of the command.
RequestVerbatimText opens a requester for entering the text to expand to.
It differs from RequestText in that the text is intended to be one or more arguments and will not be quoted with " if it contains spaces.
It has four optional parameters, the window title, a message to be shown above the text field, the default text and the title of the Ok button.
The default window title is the name of the command.
SelectedDirectoryName expands to only the name of the selected drawer or disk.
For disks the name is the device name and not the disk name.
An error requester is shown of more than one drawer or disk is selected.
SelectedDirectoryNames expands to only the name of all selected drawers and disks.
For disks the name is the device name and not the disk name.
SelectedDirectoryPath expands to the path of the selected drawer or disk.
An error requester is shown of more than one drawer or disk is selected.
SelectedDirectoryPaths expands to the paths of all selected drawers and disks.
SelectedFileName expands to only the name of the selected file.
An error requester is shown of more than one file is selected.
SelectedFileNames expands to only the name of all selected files.
SelectedFilePath expands to the path of the selected file.
An error requester is shown of more than one file is selected.
SelectedFilePaths expands to the paths of all selected files.
SelectedName expands to only the name of the selected file, drawers or disks.
For disks the name is the device name and not the disk name.
An error requester is shown of more than one file, drawer or disk is selected.
SelectedNames expands to only the name of all selected files, drawers and disks.
For disks the name is the device name and not the disk name.
SelectedPath expands to the path of the selected files, drawers or disks.
An error requester is shown of more than one file, drawer or disk is selected.
SelectedPaths expands to the paths of all selected files, drawers and disks.
Note that variables referencing selected files, drawers and disks have a blank value when the Open action is used for dock and menu item.
Variable parameters containing spaces must be quoted with " and an empty parameter (“”) can be used to get the default value for
a parameter.
The button parameter accepted by many variables allows a keyboard shortcut to be specified by using an underscore before the shortcut character in the button title.
Examples
Arguments to LHA for a Create LHA Archive… menu item.
a -r $(RequestOutputFilePath "Select Output Archive" RAM:) $(SelectedPaths)
Arguments to LHA for an Extract LHA Archive To… menu item.
x $(SelectedFilePath) $(RequestDirectoryPath "Select Where To Extract" RAM:)
Arguments to Join for a Join Files… menu item.
$(SelectedFilePaths) AS $(RequestOutputFilePath "Select Output File" RAM:)
Arguments to DMS for a Extract DMS To DF0: menu item.
$(RequestConfirmation "" "Do you want to extract DMS file to DF0:?" _Yes) WRITE $(SelectedFilePath) TO DF0:
Execute Command window
Execute Command window
This window is shown when Execute Command… is selected in the Project menu.
Command is the command line to execute. The file button can be used to open a file requester for selecting the command.
Icons can be dragged and dropped on the text field to set the command.
Add selection as arguments set whether the path to selected files, drawers and disks are added as arguments to the command line.
Close console window when completed is whether the console shall close immediately when the command is completed
or if the user must press ENTER to close the console.
New Drawer window
New Drawer window
This window is shown when New Drawer… is selected in the Window menu.
Name is the name of the drawer to create.
Create icon is whether an icon shall also be created for the drawer.
By default the default drawer icon is used but the icon can be changed by dragging and dropping an icon to the recessed icon are on the left side of the window.
New File window
New File window
This window is shown when New File… is selected in the Window menu.
Name is the name of the file to create.
When the name is changed the icon is updated to the default project icon for the name extension.
If there is no extension specific project icon, the default project icon is used.
Create icon is whether an icon shall also be created for the file.
The icon is set based on Name but it can be changed by dragging and dropping an icon to the recessed icon are on the left side of the window.
Rename window
Rename window
This window is shown when Rename… is selected in the Icon menu.
Old name is the current name of file, drawer or disk to rename.
New name is the name to rename the file, drawer or disk to.
Default icons
Default icons are used for files, drawers and disks without icons and must be in ENVARC:Sys.
Old Blue Workbench supports the same default icons as Workbench 2.0.
def_assign.info for assignments. If this icon is not present, Old Blue Workbench will not show assignments.
def_disk.info for disks. If this icon is not present, Old Blue Workbench will not show disks without icons at all.
def_drawer.info for drawers. This icon is also used when creating a new drawer.
def_tool.info for executable files.
For all files that are not executable Old Blue Workbench will search for a default icon in the following order:
If the file is an IFF file and there is an .info file named def_project. followed by the IFF FORM ID, i.e. def_project.ilbm.info for an IFF ILBM image file or def_project.8svx.info for an IFF 8SVX sound sample file, then it will be used as the icon.
If there is an .info file with the same extension as the file, i.e. def_project.txt.info for a file with the .txt extension, then it will be used.
If there is a def_project.info file then it will be used.
Examples
A HippoPlayer Dock Item
HippoPlayer has an ARexx interface that makes it possible to create a dock item that not just only launches HippoPlayer
but also allows song files to be dropped on the dock item and then added to the HippoPlayer playlist.
HippoPlayer will be automatically launched if its not already running when adding song files to the playlist.
To do this we need to create a Command dock item for executing an ARexx script.
Play Songs Dock Item window
Path shall be set to SYS:Rexxc/RX if you use a standard ARexx installation.
Action shall be set to Open so that clicking on the dock item will just launch HippoPlayer.
Arguments shall be set to the path of the ARexx script.
Console shall be set to NIL: so that no console window is opened.
Close console window when completed shall be selected.
Use the following ARexx script with hippoPlayerPath set to the path of the HippoPlayer executable.
/* Script for adding file arguments to the HippoPlayer playlist. */
hippoPlayerPath='SYS:Music/HippoPlayer/HiP'
parse arg commandLine
argc = 0
do while length(commandLine) > 0
commandLine = strip(commandLine, 'B')
argc = argc + 1
if left(commandLine, 1) = '"' then
parse var commandLine '"' argv.argc '"' commandLine
else
parse var commandLine argv.argc commandLine
end
if ~show('ports', 'HIPPOPLAYER') then do
address Command 'Run' hippoPlayerPath
address Command 'WaitForPort HIPPOPLAYER'
end
address 'HIPPOPLAYER'
options results
do argi = 1 to argc
add argv.argi
get PLAY
if result = 0 then
play
end
Feedback
Please help this project by reporting any issues to mats.hansen@triumph.no
or contact me on Mastodon (@matseh@mstdn.social).
History
Version 1.2.3
Fixed an issue introduced with the new resizing handling in 1.2.2 that prevented the layout of user interface elements from being updated when the content of the window was changed so that the window resized.
Fixed an issue where clearing the filter in a browser window after opening a drawer with the filter active would also show the icons from the parent drawer that had been hidden.
Version 1.2.2
Fixed an issue where changing the selection state of an icon that had been scrolled out of a window with a pattern background caused corruption of data in chip memory. This could crash the system or cause visual artifacts.
Fixed an issue where opening a window with a background when the Workbench isn’t the frontmost caused the background to be drawn to the frontmost screen. This could crash the system or cause visual artifacts.
Fixed an issue where using the sizing gadget would sometimes not redraw the window content. This happened most often when clicking the size gadget without actually resizing the window.
Fixed an issue where the background is not completely redrawn when a context menu closes and the selected menu item causes the content of the window to be scrolled (e.g. arranging icons).
Fixed an issue where the window title bar would be drawn over the minimize gadget when the title is changed. This happens when changing the directory of a browser window.
Fixed an issue that prevented the Close dock when deactivated setting from having an effect after editing the parent dock or user menus.
Added a Open With Browser command to the Icon menu for opening selected drawers and disks in new Browser windows.
This can also be done by pressing one of the ALT keys while double clicking on a drawer or disk.
Added hot key actions for saving the frontmost screen, the window under the pointer or the active window as an IFF ILBM image.
Added speaker brush and default icon for ARexx (.rexx) files.
Made removing a tool type select the next tool type for quicker removal of many tool types.
Made renaming a project with a default icon based on the name reevaluate the default icon.
Fixed an issue where copying a file/drawer without icon to drawer or browser window showing all files wouldn’t show the copied file/drawer.
Fixed an issue where renaming a file/drawer didn’t update the layout when using grid or rows layout or compare the new name with current filter.
Fixed an issue where changing the icon of a file/drawer didn’t update the layout when using grid or rows layout.
Fixed an issue where the wrong error message was shown if there was read error during a file copy/move.
Fixed an issue where list views could be drawn with the wrong font in some situations.
Fixed an issue that caused all disk icons to be updated when a disk was inserted or removed.
Fixed an issue where the correct drawer window position and size was not loaded for disks other than the boot disk.
Fixed an issue that could lead to a crash in the ReqTools font requester.
Fixed an issue where editing the dock opened by a dock item, menu item and hot key would not remember the existing background setting.
Fixed a deadlock that could occur when double clicking an icon while moving the mouse so it was also seen as the start of a drag.
Version 1.2.0
Added navigation buttons for going forward and backward in the path history, and a button for showing disks to browser windows.
The Parent button has been moved together with the navigation and its title has been changed into an image.
Added support for showing assignments in the Workbench window and in browser windows when Show All Files is selected.
This requires a def_assign.info default icon.
Added support for opening a browser window by double clicking the background in the Workbench window.
This functionality is disabled by default but can be enabled in the General Setting window.
Added a Browser Settings window with settings for browser windows opened with Open Browser in the
Project menu or by double clicking the background in the Workbench window.
Added an option for positioning the icon name on the right side of the icon in browser windows.
This option is in both the Browser Settings window and in the settings windows for browser dock items, menu items and hot keys.
Added a filter bar to browser windows that can be shown with the Filter command in the Window menu.
When the filter bar is shown, the browser window will only show icons with names that contains the filter string.
Changed to rows and grid layout of browser windows so that layout is updated when icons are added, removed or the window is resized.
Changed Arrange By Name and Arrange By Type for browser windows from being a one-time action to also setting the sorting used whenever the layout is updated.
Improved performance when scrolling in drawer and browser windows with a lot of icons.
Fixed an issue in the input handling that could lead to a loss of input events, e.g. mouse clicks, and sometimes stop input
processing completely, i.e. the mouse pointer stops moving.
Fixed a crash when dragging and dropping a disk icon into a drawer window.
Now the disk is copied as a drawer and gets the default drawer icon.
Fixed an issue where icons for files and drawers that have icons were shown twice in browser windows showing all files with sorting.
Fixed an issue where the protection flags for the icon was not changed when the protection flags were changed in an Info window.
Fixed an issue where an active window would show the context menu and/or select an icon even if that window was covered by another
window at the position of the mouse pointer.
Fixed an issue with the dock item type not being set correctly when setting the path of a dock item to a drawer, disk or trashcan.
Setting the path of a dock item to a drawer or disk now sets the dock item type to Drawer unless it already is Drawer or Browser.
Setting the path to a trashcan now sets the dock item type to Trashcan.
Fixed an issue where the Edit Dock Item window wasn’t updated when the dock item type was changed because of a changed path.
Version 1.1.3
Added support for setting default stack size for commands in General Settings window and to override it
for dock items, menu items and hot key items.
Fixed an issue introduced in 1.1.2 that made snapshotting a drawer or trashcan icon write the icon as Disk.info within the drawer
instead of as the drawer icon.
Fixed an issue that prevented some application, e.g. NiftyTerm and DMS, from being started as commands.
Fixed an issue that caused a crash when reverting settings with Last Saved or loading settings with Load… in the
Settings menu and window backgrounds were set.
Version 1.1.2
Added support for more complex command arguments for dock and menu items by supporting expansion of argument variables.
Added Align and Distribute sub-menus to the Icon menu for aligning and distributing selected icons along an axis.
Added support for dragging and dropping an icon on path gadgets (i.e. the string gadgets with a button for opening a file requester) to set their path.
Made it possible to delete the disk icon (Disk.info) when using Show All Files.
Fixed several issues where the wrong disk could be used if there were multiple disks with the same name.
This affected operations like opening, renaming, showing and editing information about disks, and arguments sent to commands.
Fixed an issue that made it impossible to format non-DOS disks.
Version 1.1.1
Added support for changing the icon highlight, importing IFF ILBM images as icons and exporting icons as IFF ILBM images to Info windows.
Fixed an issue where the loading icons in a drawer would never complete on some filesystems when Show All Files was selected.
Fixed an issue where a disk icon wasn’t removed visually when the disk was ejected.
Fixed an issue where arranging disk icons in the Workbench window, either by Arrange By menu items or automatically for disk icons without
a saved position, would not work correctly after a disk was ejected.
Fixed an issue where the checkmark was not shown for checked menu items in context menus.
Fixed an issue that caused crashes after resizing a browser window.
Fixed an issue that prevented the coordinates of the top-left to be reset when arranging icons in a window with icons with negative coordinates.
Version 1.1.0
Added support for setting the fonts and backgrounds (color, image or pattern) used by Workbench, drawer and browser windows
in the Appearance Settings window.
The font color is configurable, and the font can be decorated with a color background, a shadow or an outline.
Added support for setting the font and background (color, image or pattern) used by a dock
in the Edit Dock window.
The font color is configurable, and the font can be decorated with a color background, a shadow or an outline.
Added optional gadget in the window title bar for minimizing the window to just the window title bar.
This can be configured in the General Settings window.
Added optional support for moving a window to front by double clicking its title bar.
This can be configured in the General Settings window.
Added support for configurable hot keys that can perform window management actions or execute a command.
Made Old Blue Workbench ignore hot keys when other applications take over the display completely instead of using standard screens and windows.
Fixed an issue where closing a drawer while it was loading icons would prevent the drawer from being opened again.
Fixed an issue where loading default icons would never complete on some file systems, e.g. WinUAE’s virtual file system.
Fixed multiple issues with the handling of info files (icons) with a not all lower case .info suffix.
Version 1.0.1
Added a Use Default Tool Path setting in the Settings menu for setting how the path in
Default Tool for project icons is used when searching for the tool.
Made the CLI created by LaunchDaemon when launching commands inherit the search path when LaunchDaemon was started.
Made LaunchDaemon use the search path when LaunchDaemon started as the search path when launching tools with a relative path.
This affects icons with a default tool with a relative path.
Fixed an issue where a drawer/browser window reloaded the icon position when an icon was changed.
Fixed an issue where a drawer/browser window reloaded the drawer size and position when updating the window or
changing between Show All Files and Show Only Icons.
Fixed an issue where the icon was not removed from a drawer/browser window when a file that is only an
.info file is deleted.
Fixed an issue with context menus not showing when clicking the mouse’s menu button in the area of a drawer/browser window with negative coordinates.
Fixed an issue with Snapshot Window being disabled when a browser window was showing disk icons.
Fixed an issue with Close in the Window not being disabled for the Workbench window.
Fixed an issue where dropping a file or drawer icon did not copy the file or drawer to the disk.
Fixed an issue with executing commands failing when using standard CON: or NEWCON: handlers.
Fixed an issue with the disk icon being shown as part of the disk content if the Disk.info file was not capitalized
like that.
Other projects
RetroPlayer logo
If you’re into Amiga or C64 music and using macOS, you may also be interested in one of my other projects,
RetroPlayer, which is a music player and management application supporting
music formats for old computers and games consoles.