Table of Contents

Old Blue Workbench

Old Blue Workbench screen
Old Blue Workbench screen
Download LHA Download ZIP

Old Blue Workbench is a Workbench replacement for Amigas running Kickstart 1.3 written by Mats Eirik Hansen with the following features:

Requirements

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:

C:Assign OldBlue: SYS:Tools/OldBlue
C:Run <NIL: >NIL: OldBlue:LaunchDaemon
C:Stack 8192
C:Run <NIL: >NIL: OldBlue:Workbench STARTUPDRAWER SYS:WBStartup SHOWSTARTUP

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.

Mouse interaction

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
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 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 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.

Workbench menus

When the Workbench window, a drawer window or a browser window is active is has the following menus:

Project menu

Window menu

Icon menu

Settings menu

Settings windows

General Settings window

General Settings window
General Settings window

The General Settings window contains the following settings:

At the bottom there are three standard buttons for settings windows:

Appearance Settings window

The Appearance Settings window has three tabs:

At the bottom there are three standard buttons for settings windows:

Workbench Appearance tab

Workbench tab in Appearance Settings window
Workbench tab in Appearance Settings window

Drawer Appearance tab

Drawer tab in Appearance Settings window
Drawer tab in Appearance Settings window

Browser Appearance tab

Browser tab in Appearance Settings window
Browser tab in Appearance Settings 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:

Edit Color Background window

Edit Color Background window
Edit Color Background window

Edit Image Background window

Edit Image Background window
Edit Image Background window

Edit Pattern Background window

Edit Pattern Background window
Edit Pattern Background window

Edit Font window

Edit Font window
Edit Font window

Browser Settings window

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.

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:

Select Edit Menus… in the Settings menu to edit these menus.

Edit Menus window

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.

On the right side of the menu list there are buttons for editing the list.

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.

On the right side of the item list there are buttons for editing the list.

Items can also be added to the list by drag and drop of icons from Workbench, drawer and browser windows.

Edit Menu Item window

The content of this window depends on the menu item type, but the following fields are common for all menu item types.

Edit Browser Menu Item window

Edit Browser Menu Item window
Edit Browser Menu Item window

Edit Command Menu Item window

Edit Command Menu Item window
Edit Command Menu Item window

Edit Dock Menu Item window

Edit Dock Menu Item window
Edit Dock Menu Item window

Edit Drawer Menu Item window

Edit Drawer Menu Item window
Edit Drawer Menu Item window

Edit Tool Menu Item window

Edit Tool Menu Item window
Edit Tool Menu Item window

Edit Trashcan Menu Item window

Edit Trashcan Menu Item window
Edit Trashcan Menu Item window

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.

There are several dock item types:

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
Edit Dock window

On the left side of the window there are fields for configuring the appearance and the behavior of the dock.

On the right side of the window there is a list of the items in the dock and buttons for editing that list.

At the bottom this window has three buttons:

Edit Dock Item window

The content of this window depends on the dock item type, but all types of dock items have these fields:

Edit Browser Dock Item window

Edit Browser Dock Item window
Edit Browser Dock Item window

Edit Command Dock Item window

Edit Command Dock Item window
Edit Command Dock Item window

Edit Dock Dock Item window

Edit Dock Dock Item window
Edit Dock Dock Item window

Edit Drawer Dock Item window

Edit Drawer Dock Item window
Edit Drawer Dock Item window

Edit Tool Dock Item window

Edit Tool Dock Item window
Edit Tool Dock Item window

Edit Trashcan Dock Item window

Edit Trashcan Dock Item window
Edit Trashcan Dock Item window

Dock menus

When a dock is active is has the following menus:

In addition the Dock Item context menu is shown when clicking the mouse’s menu button when the mouse pointer is over a dock item.

Dock menu

Dock Item context menu

Hot keys

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:

Edit Hot Keys window

Edit Hot Keys window
Edit Hot Keys window

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.

The buttons for editing the list of hot keys are:

A hot key can perform one of the following actions:

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.

Edit Browser Hot Key window

Edit Browser Hot Key window
Edit Browser Hot Key window

Edit Command Hot Key window

Edit Command Hot Key window
Edit Command Hot Key window

Edit Dock Hot Key window

Edit Dock Hot Key window
Edit Dock Hot Key window

Edit Drawer Hot Key window

Edit Drawer Hot Key window
Edit Drawer Hot Key window

Edit Tool Hot Key window

Edit Tool Hot Key window
Edit Tool Hot Key window

Edit Trashcan Hot Key window

Edit Trashcan Hot Key window
Edit Trashcan Hot Key window

Record Hot Key window

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:

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:

At the bottom all info windows except the Assign Info window have two buttons:

Assign Info window

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.

Disk Info window

Disk info window
Disk info window

Drawer Info window

Drawer info window
Drawer info window

Project Info window

Project info window
Project info window

This window is the same as the Drawer Info window but with the following fields added.

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

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.

Other windows

Insert Variable window

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.

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
Execute Command window

This window is shown when Execute Command… is selected in the Project menu.

New Drawer window

New Drawer window
New Drawer window

This window is shown when New Drawer… is selected in the Window menu.

New File window

New File window
New File window

This window is shown when New File… is selected in the Window menu.

Rename window

Rename window
Rename window

This window is shown when Rename… is selected in the Icon menu.

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.

For all files that are not executable Old Blue Workbench will search for a default icon in the following order:

  1. 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.
  2. 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.
  3. 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
Play Songs Dock Item window

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

Version 1.2.2

Version 1.2.1

Version 1.2.0

Version 1.1.3

Version 1.1.2

Version 1.1.1

Version 1.1.0

Version 1.0.1

Other projects

RetroPlayer logo
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.