Short:        Cycle through windows/screens "Alt-Tab"
Author:       R. Eberle / Matteo Cortese
Uploader:     roman amigaalive de
Type:         util/cdity
Version:      0.8
Architecture: m68k-amigaos >= 2.0

rewincy is a commodity that allows you to cycle through
currently open windows and screens.

- cycle through windows and screens using your keyboard
- icon-like display of windows (currently very basic)
- highlight window while cycling
- zip active window (toggle size)
- commodity, works with Workbench 2.0 or higher
- cross-compiled with vbcc from linux, sources and makefile included

rewincy is based on Matteo Cortese's Altabber, and just like 
Altabber it's freeware. (see http://aminet.net/package/util/cdity/Altabber)

Changes from Altabber include: AmigaOS/Workbench2.x support, window activate
on cycle, window zip, improved cycling logic (window list only), "icon"-
display, new documentation (this readme file), no 68020 version


Installation
============

rewincy does not require installation, but can be installed
to run on system/workbench startup, if desired.

CLI:

Copy rewincy where desired.
Add a line "run >NIL: SYS:path/to/rewincy" (add CLI parameters
as desired, see "Configuration" below) to S:User-Startup
(replace "SYS:path/to/" with your path to rewincy)

Workbench:

Copy rewincy and it's icon to SYS:WBStartup folder.
Set icon tooltypes as desired (see "Configuration" below), and
make sure it's tooltype "DONOTWAIT" is set.



Usage
=====

CLI:

Enter "rewincy ?" to see command parameter template.
Run with "run" to detach from CLI. Hit Ctrl-C (when not detached), 
or "break" using process number, or re-run rewincy to stop rewincy.

Workbench:

Double-click icon to run, and again to stop.
Auto-run from WBStartup folder, if desired.

Being a commodity, you may stop rewincy via "Exchange", too.


Configuration
=============

You can set desired keys and other options.
Options can be specified as icon tooltypes (one-per-line),
or CLI parameters in AmigaDOS command template format.
Try "rewincy ?" in a CLI.

Key configuration: 

	NOTE: Workbench 2.x does not know "LAmiga" and "RAmiga"
	qualifiers, use "LCommand" and "RCommand" instead.

    WQ=WIN_QUAL/K
	
		Qualifier key string for window actions.
		Key-release brings window to front when cycling.
		Must be single qualifier key (e.g. "RAmiga", not "Amiga").
		Default value: "LCommand"

    WCK=WIN_CYCLE_KEY/K

		Key to cycle through windows, with window qualifier key held down.
		Must not be qualifier key only. (Combination with normal key allowed.)
		Default value: "Tab"

    WZK=WIN_ZIP_KEY/K

		Key to zip window (toggle size), with window qualifier key held down.
		Default value: "z"

    SQ=SCR_QUAL/K

		Qualifier key string for screen actions.
		Key-release brings screen to front when cycling.
		Must be single qualifier key (e.g. "RAmiga", not "Amiga").
		Default value: "LCommand"

    SCK=SCR_CYCLE_KEY/K

		Key to cycle through windows, with window qualifier key held down.
		Must not be qualifier key only. (Combination with normal key allowed.)
        Default: "LShift Tab"

	Keys and key combinations are described by strings like:
	"RAmiga", "LAlt", "LShift a", RAlt, Return, "Space", z, "i", ...
	Use quotes on commandline, if string contains spaces.
	(Note that not all combinations are possible. Try before permanent use.)
	Examples: WQ="RAmiga" WZK y SCR_QUAL "LAmiga" 

Other config options:

    COLOR1/N/K
    COLOR2/N/K

        COLOR1 is the pen used to write the "normal" titles; COLOR2 is the
        pen used to write the title of the currently active window/screen.
        Example:       COLOR1=1
                       COLOR2=7
        Default:       COLOR1=1 (usually black)
                       COLOR2=2 (usually white)

    AA=AUTOACTIVATE/S

        If set, attempt to activate first window on screen when bringing 
		a screen to front.
        (Not fully functional, sometimes fails to recognize the right window.)
        Example:       AA
        Default:       (not set)

    CX_PRIORITY/N/K

        Should be set to a low value, especially if you use the same
        qualifiers in other commodities' hotkeys.
        Example:       CX_PRIORITY=0
        Default value: -5


- - - - - - - - - -

Kudoz/Thanks/Credits to Matteo Cortese, Stephan Rupprecht
and contributors! (see http://aminet.net/package/util/cdity/Altabber)

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - 

check out http://amigaalive.de
check out http://arosalive.de

:-)