How to Install Directory Opus Magellan II

From MorphOS Library

Revision as of 16:23, 21 March 2015 by JPV (talk | contribs) (Filetypes)

Author: jPV/RNO

Preface

This is a tutorial how to install the original Amiga version of Directory Opus 5.82 Magellan II filemanager on a MorphOS machine. There are newer open source versions of the program available nowadays too, but at least MorphOS ports are a bit unstable at the moment and you might prefer to use the original version.


Installation

Installing from the Pre-installed Archive

The easy method is to install from the pre-installed archive found here.

  1. Download the archive and extract it to the location you want.
  2. Edit the S:user-startup file with correct Assign and Path lines. It is important that DOpus5: assign points to the correct directory where you extracted the archive. Here's how it looks after the original installer:
    Dopus5 assigns.png
  3. Reboot (or set both assign and path manually on the shell).
  4. Remove the supplied LHA archive, LZX archive, and Sound Module filetypes, because they don't work properly on MorphOS. Delete them from DOpus5:Filetypes/ directory or move them to the DOpus5:Storage/ directory. Or use Filetypes Settings on the program itself to remove or store them.

You can now jump to the Registration section of this tutorial.


Installing from Floppy Images

Nothing prevents from installing the program from scratch either. It just has more steps and requires original floppy images in ADF format.

  1. Download ADF images or convert DMS images to ADF with xDMS, for example.
  2. Download two patch archives from SourceForge or Aminet. These will be used to update from the initial Magellan II release (5.80) to the latest 5.82 version.
  3. Start the Tools/FileImageCtrl program and insert "Opus55_Install" and "Opus55_Extras" ADF files into it (you can drag&drop the files or use the Insert button).
  4. Mount the images by selecting "Amiga FFS" filesystem and clicking the Mount button for each file. FileImageCtrl window can be closed after successful mounting.
    Dopus5 adf mount.png
  5. Open the Opus55_Install disk from the desktop and double click the InstallOpus icon. Only the important options are covered in the following steps, otherwise just follow the instructions and make your preferred selections.
  6. Select "Install or Update Opus 5.5".
    Dopus5 adf install.png
  7. Do not install ArcDir, because it's broken under MorphOS! We will replace it with XADopus instead.
    Dopus5 adf install arcdir.png
  8. Select "Do not start Directory Opus on boot" in startup options selection.
    Dopus5 adf install not on boot.png
  9. Reboot the machine after the installation is done.
  10. Start the Tools/FileImageCtrl program again, insert the MagellanII_Install ADF image, and mount it.
  11. Open the disk on the desktop, double click the Install_Opus_MagellanII icon, and select "Update Opus to Magellan-II". Installation should be straightforward to finish.
    Dopus5 adf magellan2 update.png
  12. After successful Magellan II update, extract the two patch archive files (5.81 and 5.82 updates) to a temporary directory, like "Ram Disk:" for example.
  13. Navigate to "PCH581" drawer, double click the Opus_Patch580-581 file, and do the installation.
    Dopus5 adf 581 patch.png
  14. Navigate to "PCH582" drawer, double click the Opus_Patch581-582 file, and start the installation.
    Dopus5 adf 582 patch.png
  15. When it asks to update the OS 3.5 icon.library, select "Skip This Part".
    Dopus5 adf 582 patch skip iconlibrary.png

The base installation is now done and you can start the program from the location you originally chose.


Registration

You can use a free serial number (4456BLJEM4616474390) to finalize the installation and to prevent the registration window popping up on program startup. Registration window may cause debug hits on MorphOS if it doesn't accept the data you entered. If that happens, reboot the machine before continuing.

Dopus5 registration.png


Workarounds for Graphical Issues on MorphOS

When the program is run with default settings, it opens on its own screen and some quite visible graphical issues are seen. A custom screen title and two window gadgets don't seem to fit with the rest, and Ambient's PNG icons don't work.

Dopus5 firstrun.png


The custom screen title can be removed with the DOpus/WorkbenchTitle env variable. Type in the shell:

Setenv SAVE DOpus/WorkbenchTitle 1

One of the problematic gadgets can be removed with the following command:

Setenv SAVE DOpus/HidePadLock 1

Dopus5 env set.png


The other gadget (iconify) can be removed only by patching the original DirectoryOpus executable. A suitable patch for it can be found inside the D2A program's archive. Extract the D2A archive and run D2A/Patch/Script file. It will make a backup of the original executable and replace it with a new patched one.

Dopus5 gadget patch.png


Your Directory Opus screen should look like this now:

Dopus5 gadgets patched.png


Integrating with Ambient

PNG icons can't be shown on the Directory Opus screen, but Directory Opus and its functionality can be integrated quite seamlessly to the Ambient screen. It's convenient to select which way you want to manage the files when both Ambient and Directory Opus are on the same screen. You can open Ambient windows when wanting to view by PNG icons and unleash the power of Directory Opus in many other cases.

The integration can be taken a step further by hiding the Directory Opus's main window and enabling the pop up of its listers when clicking on the Ambient screen. This can be achieved with D2A or Magellambient programs.

D2A will be used in this tutorial and it requires a working ARexx environment. If you haven't enabled ARexx in your system yet, install rexxsyslib.library with Grunch or manually.


  1. Download and extract D2A to some temporary directory if you haven't done it already.
  2. Disable (uncheck) the Backdrop mode from the pulldown menu on Directory Opus.
    Dopus5 disable backdrop.png
    Main window will show up in full screen size:
    Dopus5 main window.png
  3. Resize the main window as small as possible.
    Dopus5 main window resized.png
  4. Select "Settings/Save Layout" from the pulldown menu to snapshot window positions.
    Dopus5 save layout.png
  5. Open Environment settings from the "Settings/Environment..." pulldown menu and select "Workbench: Use" to a display mode. Click "Save" button.
    Dopus5 display mode.png
    Directory Opus uses the Ambient screen now:
    Dopus5 on ambient screen.png
  6. Open the D2A drawer and copy the D2A program to your WBStartup drawer (to be started on boot).
    Dopus5 d2a to wbstartup.png
  7. (Optional step) By defalut D2A will open a DOpus lister when doing the double click on the desktop, but it may clash with the similar function in Ambient if you have enabled it. D2A can be configured to open the DOpus lister with a single middle (wheel) click instead. Open the icon information window of the D2A in your WBStartup drawer (right click on it and select "Information..." or left click to select the icon and lcommand-i from the keyboard). Double click the "MIDDLE" tooltype so that parentheses around it are removed. Click "Save" button.
    Dopus5 d2a tooltypes.png
  8. (Optional step) If you want to disable the progress bar on the program startup, you can tune it with the D2A tooltypes too. Add a new tooltype DOPUS_COMMAND=Run DETACH QUIET DOpus5:DirectoryOpus QUIET and save it. The last QUIET disables the progress bar.
    Dopus5 disabling progressbar.png


If you now have Directory Opus quitted and double click the D2A icon on the WBStartup drawer (or reboot the computer), Directory Opus will load and it shows the little main window for a few seconds until it gets hidden. The rest of DOpus windows will stay visible on the Ambient screen and you can open new DOpus listers by middle click on empty space on the Ambient desktop (or double left click if you skipped the first optional step).

Dopus5 main window hidden.png


The main window can be moved somewhere else on the screen to be less noticeable at the boot. For example to the lower right corner where it doesn't pop up over the drive icons. You can unhide the hidden window with ctrl-alt-u or ctrl-alt-a keyboard combinations if you want to move it after the hiding. I also like to close all DOpus windows to let it be more under the hood on the startup. Use "Save Layout" again to snapshot the window setup and positions.

Dopus5 saving layout with everything hidden.png


Directory Opus running under the hood after a reboot, available with a one click:

Dopus5 hidden on boot.png


Configuration

Enabling the Archive Browsing with XADopus

  1. Make sure that you don't have any archive filetypes enabled. The File Types window in Directory Opus should look like this after the initial installation:
    Dopus5 filetypes cleared.png
  2. Download XADopus archive from Aminet.
  3. Copy Modules/XADopus.module file from the downloaded archive to DOpus5:Modules/ directory.
  4. Copy contents of the Filetypes directory from the downloaded archive to the DOpus5:Filetypes/ directory.
    Dopus5 copy xadopus filetypes.png
    Your File Types window should look like this after that and you're ready to browse archives:
    Dopus5 filetypes xadopus.png

Environment variables

Type this in the shell to view certain pictures in more MorphOS friendly way:

Setenv SAVE DOpus/ShowUseDatatypesFirst 1

Environment Settings

The default settings are very modest in Directory Opus and you should go through the settings and read the documentation to get an impression what could be useful for you. Here are the most significant environment settings which should at least be enabled.

  1. Filename Length should be increased to the maximum of 107 characters.
    Dopus5 filename length.png
  2. It's probably a good idea to enable the RTG Mode for NewIcons.
    Dopus5 rtg mode.png
  3. Name Mode PopUp (RMB contextual menus on name mode listers) and Inline Editing (realtime filename/date/protectionbit/comment/etc renaming) are very powerful options which should be enabled always.
    Dopus5 namemodepopup inlineedit.png
  4. Thin Gadget Borders will look better on 1x1 pixel displays nowadays. Enabling "Mouse buttons over inactive banks" did cause some issues on MorphOS 1.x, but quickly tried it wouldn't look like that anymore, but keep it in mind if you decide to enable it.
    Dopus5 tgb.png

Filetypes

Filetypes system is the heart of Directory Opus in practise. Filetypes will identify the type of a file and define actions available for it. Every user should create new filetypes according the other software, needs, and configurations they have and prefer, but here is a small collection for starters. It should work generally under any MorphOS setup. Copy the filetypes found in it to your DOpus5:Filetypes/ directory.

The collection includes the next filetypes:

All - a filetype for all files

  • Double click (with Ctrl key pressed): SmartRead
  • Double click (Alt): Version
  • Drag&drop: Copy MOVEWHENSAME
  • Context menu: Duplicate, SmartRead, Version, Open with XAD

All, Directories - a filetype for all directories

  • Double click (Ctrl): GetSizes
  • Drag&drop: Copy MOVEWHENSAME
  • Context menu: Get size, Find file, Burn to Disc

Archive, LHA

  • Double click: browse the archive with XADopus
  • Drag&drop: extracts to the destination
  • Context menu: Extract to, Extract to RAM:, Extract here

Archive, XZ

  • Double click: browse the archive with XADopus
  • Context menu: Extract here

ASCII

  • Double click: Multiview
  • Context menu: Edit with Ed, Edit with Scribble

Audio, MP3

  • Double click: Play in Jukebox

Document, AmigaGuide

  • Double click: Multiview

Document, HTML

  • Double click: OpenURL

Document, PDF

  • Double click: View with VPDF
  • Context menu: View with APDF

Executable, ELF - Recognizes MorphOS PPC native executable files

  • Double click: runs the file as shell command and asks arguments for it
  • Double click (Ctrl): runs the program with WBRun, like you'd clicked the icon
  • Context menu: Execute with WBRun

Image file, ADF

  • Double click: browse the image with XADopus

Image file, ISO

  • Double click: browses the image on Ambient
  • Context menu: Mount, Burn to Disc

Picture - a filetype for all picture files recognized by the datatypes

  • Double click: views the picture by Ambient definitions
  • Context menu: View in Showgirls

Version

  • Double click: shows the version information for the following type of files: library, device, gadget, datatype, handler, mcp, mcc, mui
  • This is very simple output from the Version command. For a more advanced version I'd use the WB-Version command or Severin's cool script for example.

Video

  • Double click: plays the popular video formats by Ambient definitions

Dopus5 filetypes example.png

Misc

Directory Opus is a very flexible and configurable program. Play around, learn, and remember RMB menus and ctrl key options in many places. Button banks and Start Menus do work over Ambient screen, hotkeys do also work fine and with the global hotkeys option you can use Directory Opus as a general purpose hotkey manager too.

Graphical tuning requires mostly icon files or IFF images, but when converted to the correct formats you'll get the look you want.

Here's an example video how you can tune Start Menus on MorphOS for example: https://www.youtube.com/watch?v=lRrIi0datLs

And here are some examples of different lister toolbar images. MagicWB one comes with the install disk and others can be found from Aminet for example.

Dopus5 listerbuttons mwb.png Dopus5 listerbuttons.png

3rd party modules should work generally, but of course ones hitting the original Amiga hw (like some audio players) won't work. I'd recommend for example CycleMode (for cycling lister view modes from the keyboard), RootParent (to view the device list if going parent from the root level), and CutNPaste (copy/cut/paste files).


Directory Opus manuals are available at least in these places:

Remastered manuals in Aminet

Original scanned manuals


Happy tuning! :)