AmiDock

Customizable 1-Click Application Dock for Amiga

Note: You can find more detailed information about the use of this excellent application here

 

Version 1.3
03/10/91
by Gary Knight

 


What is AmiDock?
For those familiar with the NeXT computer, this will be a short explanation. AmiDock is an Amiga version of the NeXT's Dock. AmiDock is (of course) more versatile and not as limited as its NeXT cousin.

For those unfamiliar with the NeXT computer: AmiDock provides you with a number of buttons on the WorkBench screen that, when pressed, will launch other programs. These buttons are fully configurable to run any program you want with a single press.


Features of AmiDock:

  • Program Compatibility
    AmiDock can run programs that need a CLI or the WorkBench.
  • Button Imagery
    AmiDock uses IFF brushes for the button imagery. The brushes are standard IFF files and can be customized to your individual preferences. Many programs added to the dock will need a custom brush. A Dock Image Grid is included for this purpose.
  • WorkBench Compatibility
    AmiDock is compatible with WorkBench 1.2, 1.3, and 2.0 and will run on any Amiga computer with any amount of memory. It has been tested on all Amiga models (500/1000/2000/2500/3000).
  • Unlimited Buttons
    AmiDock supports an unlimited number of buttons, displayed in a single line (column or row) that can extend beyond the screen boundaries with the use of scroll arrows.
  • Moveable Dock
    AmiDock can be moved around the screen like any normal window, and can be configured as a vertical column or a horizontal row.

Setup Instructions:

  1. Copy arp.library
    Ensure arp.library is in your LIBS: directory. This library is included with AmiDock and is used for file requests.
  2. Install AmiDock
    Copy the AmiDock program to your C: directory.
  3. Copy the Dock Directory
    Copy the Dock directory to your hard drive or WorkBench Boot Floppy. The Dock directory contains the following:

    Dock/
        Interlace/
            DockImageGrid2.iff
            MainDock/
                dock.config
        Non-interlace/
            DockImageGrid1.iff
            MainDock/
                dock.config
    
     
  4. Set the DOCK: Assignment
    Assign DOCK: to the directory containing the configuration file and brushes. Use either the "Dock/Interlace/MainDock/" or "Dock/Non-Interlace/MainDock/" directory, depending on whether you run your WorkBench in interlace mode. This assignment should be added to your startup-sequence.
  5. Run AmiDock
    Execute AmiDock. It comes pre-configured to run a variety of programs. Reconfigure the dock as needed for your programs.

Additional Notes

  • Brushes and Config File Location
    In this release, brushes must be in the same directory as the dock.config file. Although the brush requester allows entering a brush from another directory, AmiDock will not recognize it if it's not in the same directory as dock.config.
  • Running AmiDock in Background
    AmiDock does not need to be "run"; it sets itself up as a background process and returns control to the CLI. You can add it to your startup-sequence to allow the startup CLI to close. If using AmigaDOS 2.0, place AmiDock in the wbstartup drawer with a DONOTWAIT tool type.
  • CLI Argument
    AmiDock accepts one argument when run from the CLI: the path to the config file and brushes (e.g., amidock dh0:dock/interlace/maindock). If no argument is given, AmiDock will use the DOCK: assignment.
  • Unfinished Feature
    The Text button in the Add/Edit/Delete window does not work yet. Pressing it has no effect, and AmiDock will continue to use the brush.
  • DockImageGrid Files
    Two files, DockImageGrid1.iff and DockImageGrid2.iff, are included as non-interlaced and interlaced versions. These are IFF ILBM images containing pre-defined and blank buttons. To create or add a brush, load DockImageGrid?.iff into a paint program, create or select a button, and save the brush in the appropriate dock directory.

Disk Preview

Dock
Interlace
Default
Shell.brush
01/27/1992 16:00
596
Shell.brush
default.brush
01/27/1992 16:00
596
default.brush
dock.config
01/27/1992 16:00
48
MainDock
ADPro.brush
03/15/1992 12:00
500
ADPro.brush
AVision.brush
03/15/1992 12:00
500
AVision.brush
Calculator.brush
01/27/1992 15:00
596
Calculator.brush
SpreadSheet.brush
01/27/1992 15:00
596
SpreadSheet.brush
distantsuns1.brush
01/21/1992 23:00
500
distantsuns1.brush
dock.config
05/25/1992 10:00
507
dp4.brush
01/27/1992 15:00
500
dp4.brush
pagestream2.2.brush
01/18/1992 00:00
500
pagestream2.2.brush
provector.brush
12/03/1991 14:00
500
provector.brush
provector.brush.info
05/25/1992 04:00
236
qt.brush
01/27/1992 15:00
596
qt.brush
shell.brush
01/27/1992 15:00
596
shell.brush
writenow.brush
01/18/1992 09:00
580
writenow.brush
Albert_Mangarelli.brushes
01/27/1992 15:00
5712
Albert_Mangarelli.brushes
DCTV.brushes
04/18/1992 01:00
14848
DCTV.brushes
Default.info
05/28/1992 13:00
628
Dock_Image_Grid.ilbm
05/19/1992 05:00
40758
Dock_Image_Grid.ilbm
Dock_Image_Grid_16.ilbm
01/27/1992 15:00
74378
Dock_Image_Grid_16.ilbm
François_Pinault.brushes
05/27/1992 14:00
19870
François_Pinault.brushes
François_Pinault.ilbm
05/27/1992 17:00
60606
François_Pinault.ilbm
François_Pinault_16.brush
05/27/1992 12:00
22862
François_Pinault_16.brush
Jon_Anderson1_16.ilbm
04/16/1992 23:00
87444
Jon_Anderson1_16.ilbm
Jon_Anderson2_16.ilbm
04/16/1992 23:00
99416
Jon_Anderson2_16.ilbm
Jorg_Kasper.brushes
02/25/1992 10:00
11126
Jorg_Kasper.brushes
Lawrence_Olsen_8.brushes
01/27/1992 16:00
5126
Lawrence_Olsen_8.brushes
MacIcons.ilbm
01/27/1992 15:00
31428
MacIcons.ilbm
MainDock.info
07/21/1992 14:00
628
Marcel_Durufle.brushes
01/27/1992 15:00
10442
Marcel_Durufle.brushes
Mike_Loader.brushes
05/19/1992 04:00
11730
Mike_Loader.brushes
Pat_Seguin_8.ilbm
01/27/1992 16:00
26194
Pat_Seguin_8.ilbm
Richard_Ames.brushes
01/27/1992 16:00
4412
Richard_Ames.brushes
Rob_Hayes.brushes
03/22/1992 13:00
2964
Rob_Hayes.brushes
Robert_Sum.brushes
01/27/1992 16:00
3432
Robert_Sum.brushes
Steve_Chambers.brushes
05/19/1992 01:00
3008
Steve_Chambers.brushes
The_Z.brushes
01/27/1992 15:00
6922
The_Z.brushes
Tim_Doherty.brushes
01/27/1992 16:00
3116
Tim_Doherty.brushes
W-P_Denhnick.brushes
01/27/1992 16:00
51928
W-P_Denhnick.brushes
Wes_Popham.brushes
01/27/1992 16:00
4280
Wes_Popham.brushes
Ørnulf_Mejdell.brushes
01/27/1992 16:00
15894
Ørnulf_Mejdell.brushes
Non-Interlace
MainDock
AmigaVision.brush
01/27/1992 17:00
380
AmigaVision.brush
Calculator.brush
01/27/1992 17:00
380
Calculator.brush
PageStream2.1.brush
01/27/1992 17:00
380
PageStream2.1.brush
SpreadSheet.brush
01/27/1992 17:00
380
SpreadSheet.brush
The_Art_Department.brush
01/27/1992 17:00
380
The_Art_Department.brush
default.brush
01/27/1992 17:00
380
default.brush
dock.config
05/27/1992 02:00
378
dp4.brush
05/26/1992 22:00
284
dp4.brush
opus.brush
05/26/1992 23:00
284
opus.brush
shell.brush
01/27/1992 17:00
380
shell.brush
default
default.brush
01/27/1992 17:00
380
default.brush
default.brush.info
01/27/1992 17:00
221
dock.config
01/27/1992 17:00
48
Claude_Girolet.brushes
05/27/1992 09:00
9796
Claude_Girolet.brushes
Dan_Weiss.brushes
05/17/1992 13:00
1978
Dan_Weiss.brushes
Dock_Image_Grid.ilbm
05/27/1992 00:00
19594
Dock_Image_Grid.ilbm
Jorg_Kasper.brushes
02/25/1992 10:00
3660
Jorg_Kasper.brushes
MainDock.info
05/28/1992 14:00
628
Mark_Wetzel.brushes
05/17/1992 16:00
900
Mark_Wetzel.brushes
default.info
05/28/1992 14:00
628
Interlace.info
05/28/1992 14:00
628
Non-Interlace.info
05/28/1992 15:00
628
.info
11/05/2017 03:00
51
AmiDock
01/27/1992 18:00
32660
AmiDock.info
01/05/1993 16:00
364
Disk.info
01/05/1993 13:00
388
Dock.info
01/05/1993 15:00
628
Usage
05/26/1992 03:00
3141
                        How to use AmiDock
                        
There are two ways to use AmiDock:

1) From the the CLI enter 'amidock' and the CLI prompt and press return.
   This will cause AmiDock to be loaded into memory and begin executing.
   The first thing AmiDock does is to look in the DOCK: directory that you
   assigned before you ran AmiDock (usually in the startup-sequence).
   AmiDock will also use the DOCK: assignment if you ran it from the 
   WorkBench by double clicking on its icon, or under WB2.0 by placing 
   it in the WBStartup drawer.
    
   The DOCK: assignment must be made so that it specifies a directory where
   a 'dock.config' file is located and must be done before you run AmiDock.
    
   Example: assign DOCK: work:dock/interlace/maindock
    
   For this example to work a dock.config file must be in the directory
   'work:dock/interlace/maindock'.


2) The second way to run AmiDock eliminates the need for the DOCK:
   assignment. All that you need to do is to give the path to the dock.config 
   file as the first argument to AmiDock when you run it from the CLI.  
   This method only works from a CLI (or shell). It will not work from the 
   WorkBench, to run AmiDock from the WorkBench see #1 above.
   
   Example: amidock work:dock/interlace/maindock
   
   Remember a dock.config file must be in that directory for AmiDock to
   function properly.
   
   Running AmiDock in this fashion makes it possible to have more than one
   AmiDock program running using different dock.config files for it's setup.
   This is also the method you would use to run AmiDock from AmiDock.
   

NEW for version 1.4:
When you run AmiDock and it cannot find a dock.config file AmiDock will 
put up an error message stating that it cannot find its dock.config file.
If this happens be sure that the dock.config file is in the directory 
specified as a argument or by the assignment DOCK:.


To run AmiDock from the startup-sequence add the following lines to your 
startup-sequence:

assign DOCK: 
amidock


To run more than one AmiDock from your startup-sequence add these lines:

assign DOCK: 
amidock
amidock 
amidock 
amidock 
(etc. as many times as you want)


If you are using Workbench 2.04 or higher you can run AmiDock by placing
it into the WBStartup drawer.  Remember to add the 'DONOTWAIT' tool type
to the icon using the 'Information' item from the the 'Icon' menu in
Workbench. If you do not do this when booting the machine Workbench will
put up a requester stating that 'AmiDock has not returned - Should I wait
some more?'.  If it does this, answer 'no' and add the tool type 'DONOTWAIT'.
See the Workbench manual for more information.


You can run as many as you want to like this, just remember that each 
different AmiDock needs its own dock.config file (put them in separate 
directories) and each brush used by a particular dock needs to be located 
with each and every dock.config file that uses it.
Usage.info
01/05/1993 16:00
361
arp.library
01/27/1992 15:00
17100
palette16.ilbm
01/27/1992 15:00
106
palette16.ilbm