DrawerGenie
~~~~~~~~~~~
DrawerGenie is a commodity that lets you add a small toolbar to any Workbench
drawer window, offering useful file functions like cut/copy/paste, DOpus-style
source/destination copying and moving, back and parent functions, Lha archive
support and more.

DrawerGenie is an entry to the 2023 Amiga Tool Jam in the Commodity category.
Full sourcecode is available at https://github.com/daedalus2097/drawergenie


Warning
~~~~~~~
DrawerGenie is Beta software. It contains bugs, and while every effort has
been made to make the program as safe as possible, due to its integration with
workbench and its intended function of manipulating files and directories it's
possible that an unforeseen situation may cause unexpected data loss. Use it at
your own risk. 


Requirements
~~~~~~~~~~~~
DrawerGenie relies on many features of Workbench introduced with OS 3.5 
(workbench.library v44) and cannot be used with earlier versions of Workbench.
Note that OS 3.9, 3.1.4 and 3.2 all include suitable versions of Workbench, and
DrawerGenie can be used with these.

For Lha archive support, the Lha executable must be in the system path (usually
SYS:C).


Quickstart
~~~~~~~~~~
Double-click the DrawerGenie icon to start it. It will normally run quietly in
the background.
Double-click it again to open the Preferences window.
Press F1 to attach a toolbar to the active Workbench window. The toolbar will
move and resize to suit the window. Expand the Workbench window if necessary to
see more gadgets.
Click the gadgets in the toolbar to perform the corresponding action.
Hold down the Help key while clicking a gadget for brief pop-up help.


Installation
~~~~~~~~~~~~
Unpack DrawerGenie to a suitable location and run the Installer script. It can
also be installed manually by storing the unpacked drawer on your hard drive.
DrawerGenie needs to be able to find the other files in its drawer, so if you
move the executable away from these files, set the HOMEDIR icon tooltype to the
drawer containing the rest of the files. This can also be set in the program
preferences. If you used the included Installer script, this setting will be
set automatically. 

To have DrawerGenie start when the system boots, copy the DrawerGenie program
to WBStartup and set the HOMEDIR icon tooltype to the original drawer. The
Installer script will do this for you if you wish.


Usage
~~~~~
DrawerGenie can be started by opening its icon or automatically on boot. It
will normally start running silently in the background as a commodity, and can
be controlled and removed using the Workbench Exchange commodity or similar. To
add a toolbar to a Workbench drawer window, press F1 when the desired window is
active.

Running its icon a second time will open the Preferences window, as will issuing
a Show command from Exchange.


Changes
~~~~~~~
0.4 (06.11.2023)
- Added Sort by Type option
- Added support for popup items to be used in main toolbar
- Changed OS version check from exec to workbench to suit some hybrid 3.1 / 3.9
  installations
- Fixed occasional misalignment of gadgets in drop-downs
- Adjusted layout in preference and toolbar editing windows
- Added *experimental* option to adjust windows to accommodate toolbar
- Added HELP: to documentation search path
- Added workaround for icon-only files preventing file operations (fallback
  method using ARexx added)

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                69540  182848  38.0% -lh5- b33b Nov  6 17:52 DrawerGenie/DrawerGenie
[unknown]                 5221   15275  34.2% -lh5- ec92 Nov  6 19:23 DrawerGenie/DrawerGenie.guide
[unknown]                 1976    2518  78.5% -lh5- c582 Nov  6 19:23 DrawerGenie/DrawerGenie.guide.info
[unknown]                 1682    2228  75.5% -lh5- fb86 Nov  6 19:18 DrawerGenie/DrawerGenie.info
[unknown]                 1683    3587  46.9% -lh5- e829 Nov  6 19:17 DrawerGenie/DrawerGenie.readme
[unknown]                 1847    2791  66.2% -lh5- 19e2 Nov  6 19:17 DrawerGenie/DrawerGenie.readme.info
[unknown]                41757  102892  40.6% -lh5- 5399 Oct 29 19:30 DrawerGenie/DrawerGenieCopy
[unknown]                34017   75588  45.0% -lh5- bb6f Oct 29 19:28 DrawerGenie/DrawerGenieLha
[unknown]                  510     886  57.6% -lh5- d100 Nov  6 19:16 DrawerGenie/History.txt
[unknown]                 1845    2791  66.1% -lh5- 13f5 Nov  6 19:16 DrawerGenie/History.txt.info
[unknown]                  896    2439  36.7% -lh5- 7220 Nov  6 19:18 DrawerGenie/InstallDrawerGenie
[unknown]                 1601    2964  54.0% -lh5- bfd6 Nov  6 19:18 DrawerGenie/InstallDrawerGenie.info
[unknown]                 2512    5858  42.9% -lh5- 942b Nov  1 21:49 DrawerGenie/toolbar.iff
[unknown]                 1373    1718  79.9% -lh5- 026f Oct 31 20:34 DrawerGenie.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        14 files  166460  404383  41.2%            Nov  7 04:44