Scrolly plugin for Take Command / TCC / TCC/LE
beta version 0.99.11 2020-09-09
This plugin adds hotkeys to scroll backward and forward through the console window by commands.
To install this plugin, copy Scrolly.dll to a subdirectory named PlugIns within your Take Command program directory. (If you are using the 32-bit version of Take Command, copy Scrolly-x86.dll instead of Scrolly.dll.) It will be loaded automatically when TCC starts.
The syntax definitions in the following text use these conventions for clarity:
|indicates text which must be typed exactly as shown.|
|indicates optional text, which may be typed as shown or omitted.|
|Bold italic||names a required argument; a value must be supplied.|
|Regular italic||names an optional argument.|
|ellipsis…||after an argument means that more than one may be given.|
Only commands that were entered after this plugin was loaded are recognized.
You can use the
SCROLLY command to
set different keys.
/L /R /S /W:yn
|set the back (up) hotkey|
|restore the built-in plugin defaults|
|enable or disable the error sound|
|set the forward (down) hotkey|
|list all supported hotkeys|
|restore saved settings from the registry|
|save current settings to the registry|
|enable or disable wrap|
You can specify different hotkeys with
/F:. To see a list of all supported hotkeys, use
/L. (The list can vary between different versions of TCC, because the
plugin hotkey interface changed in version 24.) Note that some key combinations may
not be seen by the plugin — they might be used by the console, or by Take
Command. If your hotkey doesn’t work, try changing it back to its original
value, Ctrl-Alt-Up or Ctrl-Alt-Down.
The default behavior when scrolling above the first
command in the buffer, or below the last one, is to wrap around from top to bottom or
vice versa. You can disable this wrapping feature with
/W:Y to re-enable it.
By default, Scrolly plays a sound (the system
‘Default Beep’ sound) if any error occurs. The most likely errors are
trying to scroll above the first command in the console buffer, or below the last one,
while wrap is disabled. You can disable the error sound with
/E:Y to re-enable it.
Every time you press Enter, Scrolly marks the start of the current command line in the screen buffer. You can’t see the mark, but it’s there.
This is why only commands entered after the plugin was loaded are recognized: they are the only ones marked. For this reason, it doesn’t make sense to load and unload the plugin. Just put it in your PlugIns directory so it loads automatically at startup, and let it do its thing.
Scrolly will not load in transient or pipe shells. This is by design; Scrolly is only useful in interactive shells. Elsewhere, it would only waste memory.
This plugin displays an informational line when it initializes. The
message will be suppressed in transient or pipe shells. You can disable it
for all shells by defining an environment variable named
set /e /u noloadmsg=1
Scrolly is currently licensed only for testing purposes. I may make binaries and source code available under some free license once I consider it ready for use.