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


Credits
~~~~~~~
Two additional toolbars (toolbar and toolbar_HD) are now included. Thanks to
Artur Bardowski for his submission!


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.

wizard.library is required (included)

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

For XAD support, XAD must be installed, with XADUnFile in the system path.


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 requires wizard.library to be installed; copy this to LIBS: if you
don't already have it (the Installer script will do this for you).

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.8 (24.09.2024)
- Removed unintended dependencies on jpeg.library and zlib.library
- Fixed crash when handling v0.4 prefs file in some cases
- Added wizard.library to DrawerGenie archive
- Removed some unwanted debug output
- Added suitable planar icon imagery (thanks to EctoOne)

0.7 (16.09.2024)
- Added palette-remapping for toolbar graphics
- Added support for user-defined toolbar graphics
- Added support for XAD un-archiver
- Added support for transparency in icon imagery
- Added option to set polling frequency
- Added support for AISS (incomplete)
- Fixed many bugs throughout, including:
  - Created archives only contained one selected icon
  - Misaligned dropdown menus
  - Misaligned options in Prefs window

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]               101821  311164  32.7% -lh5- 7b8f Sep 24 23:02 DrawerGenie/DrawerGenie
[unknown]                 6563   18916  34.7% -lh5- 3dbf Sep 27 20:32 DrawerGenie/DrawerGenie.guide
[unknown]                 1976    2518  78.5% -lh5- c582 Sep 24 22:40 DrawerGenie/DrawerGenie.guide.info
[unknown]                 1763    2749  64.1% -lh5- b0a6 Sep 24 22:40 DrawerGenie/DrawerGenie.info
[unknown]                 1896    4169  45.5% -lh5- 3c7d Sep 27 20:29 DrawerGenie/DrawerGenie.readme
[unknown]                 1847    2791  66.2% -lh5- 19e2 Sep 24 22:40 DrawerGenie/DrawerGenie.readme.info
[unknown]                41759  102892  40.6% -lh5- ef7d Sep 16 21:34 DrawerGenie/DrawerGenieCopy
[unknown]                34011   75608  45.0% -lh5- ca97 Sep 16 21:33 DrawerGenie/DrawerGenieLha
[unknown]                34028   75692  45.0% -lh5- 6ef0 Sep 16 21:33 DrawerGenie/DrawerGenieXad
[unknown]                  839    1662  50.5% -lh5- 5fce Sep 24 23:23 DrawerGenie/History.txt
[unknown]                 1845    2791  66.1% -lh5- 13f5 Sep 24 22:40 DrawerGenie/History.txt.info
[unknown]                  950    2607  36.4% -lh5- 7876 Sep 25 09:03 DrawerGenie/InstallDrawerGenie
[unknown]                 1606    2964  54.2% -lh5- b749 Sep 25 09:00 DrawerGenie/InstallDrawerGenie.info
[unknown]                 2378    3782  62.9% -lh5- 1e21 Apr  5  2024 DrawerGenie/Toolbars/default.iff
[unknown]                 2560    4422  57.9% -lh5- 2e04 Apr  5  2024 DrawerGenie/Toolbars/toolbar.iff
[unknown]                 6077   15086  40.3% -lh5- 5d72 Feb 27  2024 DrawerGenie/Toolbars/toolbar_HD.iff
[unknown]                88839  224240  39.6% -lh5- ca22 Jan 15  2006 DrawerGenie/wizard.library
[unknown]                 1375    1718  80.0% -lh5- 9221 Sep 24 22:40 DrawerGenie.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        18 files  332133  855771  38.8%            Oct  1 03:46