2014-03-08 22:32:32 +00:00
|
|
|
## Default hotkeys
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
### General description
|
|
|
|
|
|
|
|
The hotkeys, as you can set them in `Config.ini`, are noted in the format
|
|
|
|
`<modifier><key>::<function>(<argument>)`.
|
|
|
|
Possible modifiers are the following:
|
|
|
|
|
|
|
|
* `!` (Alt)
|
|
|
|
* `^` (Ctrl, Control)
|
|
|
|
* `#` (LWin, left Windows)
|
2014-03-08 22:32:32 +00:00
|
|
|
* `+` (Shift)
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2014-03-24 19:02:31 +00:00
|
|
|
You will have to press all keys of a hotkey at the same time beginning with the
|
|
|
|
modifier for calling the associated function, e. g. `#^q` means pressing the
|
|
|
|
left 'Windows key' and the 'Control key' and the 'Q key' (`Win+Ctrl+Q`) for
|
|
|
|
quitting bug.n.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
### Window management
|
|
|
|
|
|
|
|
`#Down::View_activateWindow(+1)`
|
|
|
|
> Activate the next window in the active view.
|
|
|
|
|
|
|
|
`#Up::View_activateWindow(-1)`
|
|
|
|
> Activate the previous window in the active view.
|
|
|
|
|
2015-01-27 23:02:37 +00:00
|
|
|
`#+Down::View_shuffleWindow(0, +1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Move the active window to the next position in the window list of the view.
|
|
|
|
|
2015-01-27 23:02:37 +00:00
|
|
|
`#+Up::View_shuffleWindow(0, -1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Move the active window to the previous position in the window list of the view.
|
|
|
|
|
2015-01-27 23:02:37 +00:00
|
|
|
`#+Enter::View_shuffleWindow(1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Move the active window to the first position in the window list of the view.
|
2015-01-27 23:02:37 +00:00
|
|
|
You may also move the active window to any other absolute position in the
|
|
|
|
window list by using the first parameter.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#c::Manager_closeWindow()`
|
|
|
|
> Close the active window.
|
|
|
|
|
2015-01-25 18:16:30 +00:00
|
|
|
`#+d::Window_toggleDecor()`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Show / Hide the title bar of the active window.
|
|
|
|
|
2015-01-25 19:28:40 +00:00
|
|
|
`#+f::View_toggleFloatingWindow()`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Toggle the floating status of the active window (i. e. dis- / regard it when
|
|
|
|
tiling).
|
|
|
|
|
|
|
|
`#+m::Manager_moveWindow()`
|
|
|
|
> Move the active window by key (only floating windows).
|
|
|
|
|
|
|
|
`#+s::Manager_sizeWindow()`
|
|
|
|
> Resize the active window by key (only floating windows).
|
|
|
|
|
|
|
|
`#+x::Manager_maximizeWindow()`
|
|
|
|
> Move and resize the active window to the size of the work area (only floating
|
|
|
|
windows).
|
|
|
|
|
|
|
|
`#i::Manager_getWindowInfo()`
|
|
|
|
> Get information for the active window (id, title, class, process name, style,
|
|
|
|
geometry, tags and floating state).
|
|
|
|
|
|
|
|
`#+i::Manager_getWindowList()`
|
|
|
|
> Get a window list for the active view (id, title and class).
|
|
|
|
|
|
|
|
`!Down::View_moveWindow(0, +1)`
|
|
|
|
> Manually move the active window to the next area in the layout.
|
|
|
|
|
|
|
|
`!Up::View_moveWindow(0, -1)`
|
|
|
|
> Manually move the active window to the previous area in the layout.
|
|
|
|
|
|
|
|
`!+Enter::Manager_maximizeWindow()`
|
|
|
|
> Move and resize the active window to the size of the work area (only floating
|
|
|
|
windows).
|
|
|
|
|
|
|
|
`!<n>::View_moveWindow(<n>)`
|
|
|
|
> Manually move the active window to the n<sup><small>th</small></sup> area in
|
|
|
|
the layout (n = 1..9).
|
|
|
|
|
|
|
|
`!0::View_moveWindow(10)`
|
|
|
|
> Manually move the active window to the n<sup><small>th</small></sup> area in
|
|
|
|
the layout.
|
|
|
|
|
|
|
|
`!BackSpace::View_toggleStackArea()`
|
|
|
|
> Toggle the stack area of the layout. If the stack area is disabled, the
|
|
|
|
master area takes up the whole view.
|
|
|
|
|
|
|
|
### Window debugging
|
2014-03-08 22:32:32 +00:00
|
|
|
|
2014-03-07 00:16:32 +00:00
|
|
|
`#^i::Debug_logViewWindowList()`
|
|
|
|
> Dump window information on the windows of the active view to the log.
|
|
|
|
|
|
|
|
`#+^i::Debug_logManagedWindowList()`
|
|
|
|
> Dump window information on the contents of the managed window list (floating
|
|
|
|
and tiled windows of all views) to the log.
|
|
|
|
|
|
|
|
`#^h::Debug_logHelp()`
|
|
|
|
> Print a description of the formatting (column headings) used in the previous
|
2014-03-07 00:30:21 +00:00
|
|
|
two log messages (`Manager_logViewWindowList` and
|
|
|
|
`Manager_logManagedWindowList`) to the log.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2015-01-27 21:33:13 +00:00
|
|
|
`#^d::Debug_setLogLevel(0, -1)`
|
|
|
|
> Decrement the debug log level. Show fewer debug messages. You may also set
|
|
|
|
the debug log level to an absolute value by using the first parameter.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2015-01-27 21:33:13 +00:00
|
|
|
`#^+d::Debug_setLogLevel(0, +1)`
|
|
|
|
> Increment the debug log level. Show more debug messages. You may also set
|
|
|
|
the debug log level to an absolute value by using the first parameter.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
### Layout management
|
2014-03-08 22:32:32 +00:00
|
|
|
|
2014-03-07 00:16:32 +00:00
|
|
|
`#Tab::View_setLayout(-1)`
|
2015-01-27 21:13:03 +00:00
|
|
|
> Set the previously set layout. You may also use `View_setLayout(0, +1)` for
|
|
|
|
setting the next or `View_setLayout(0, -1)` for setting the previous layout in
|
|
|
|
the layout array.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#f::View_setLayout(3)`
|
2014-03-07 00:39:01 +00:00
|
|
|
> Set the 3<sup><small>rd</small></sup> defined layout (i. e. floating layout
|
|
|
|
in the default configuration).
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#m::View_setLayout(2)`
|
2014-03-07 00:39:01 +00:00
|
|
|
> Set the 2<sup><small>nd</small></sup> defined layout (i. e. monocle layout in
|
|
|
|
the default configuration).
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#t::View_setLayout(1)`
|
2014-03-07 00:39:01 +00:00
|
|
|
> Set the 1<sup><small>st</small></sup> defined layout (i. e. tile layout in
|
|
|
|
the default configuration).
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#Left::View_setLayoutProperty("MFactor", 0, -0.05)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Reduce the size of the master area in the active view (only for the "tile"
|
2015-01-27 20:59:12 +00:00
|
|
|
layout). You may also set an additional parameter for accelerating the third
|
|
|
|
one. E. g. with `#Left::View_setLayoutProperty("MFactor", 0, -0.05, 2)` the
|
|
|
|
first step, by which the master area is reduced, is -0.0016% and will be
|
|
|
|
doubled with consecutive calls until it reaches -0.05%.
|
|
|
|
With the second parameter you may set an absolute value, e. g.
|
|
|
|
'View_setLayoutProperty("MFactor", 0.5, 0)' splits the view in half.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#Right::View_setLayoutProperty("MFactor", 0, +0.05)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Enlarge the size of the master area in the active view (only for the "tile"
|
2015-01-27 20:59:12 +00:00
|
|
|
layout). You may also set a additional parameter for accelerating the third
|
|
|
|
one. E. g. with `#Right::View_setLayoutProperty("MFactor", 0, +0.05, 0.5)` the
|
|
|
|
first step, by which the master area is reduced, is 0.05%, but with consecutive
|
|
|
|
calls it will be halved until it reaches 0.0016%.
|
|
|
|
With the second parameter you may set an absolute value, e. g.
|
|
|
|
'View_setLayoutProperty("MFactor", 0.67, 0)' makes the master area two thirds
|
|
|
|
and the stacking area one third the size of the view.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^t::View_setLayoutProperty("Axis", 0, +1, 1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Rotate the layout axis (i. e. 2 -> 1 = vertical layout, 1 -> 2 = horizontal
|
|
|
|
layout, only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^Enter::View_setLayoutProperty("Axis", 0, +2, 1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Mirror the layout axis (i. e. -1 -> 1 / 1 -> -1 = master on the left / right
|
|
|
|
side, -2 -> 2 / 2 -> -2 = master at top / bottom, only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^Tab::View_setLayoutProperty("Axis", 0, +1, 2)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Rotate the master axis (i. e. 3 -> 1 = x-axis = horizontal stack, 1 -> 2 =
|
|
|
|
y-axis = vertical stack, 2 -> 3 = z-axis = monocle, only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^+Tab::View_setLayoutProperty("Axis", 0, +1, 3)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Rotate the stack axis (i. e. 3 -> 1 = x-axis = horizontal stack, 1 -> 2 =
|
|
|
|
y-axis = vertical stack, 2 -> 3 = z-axis = monocle, only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^Up::View_setLayoutProperty("MY", 0, +1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Increase the master Y dimension by 1, i.e. increase the number of windows in
|
|
|
|
the master area by X. Maximum of 9 (only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^Down::View_setLayoutProperty("MY", 0, -1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Decrease the master Y dimension by 1, i.e. decrease the number of windows in
|
|
|
|
the master area by X. Minimum of 1 (only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^Right::View_setLayoutProperty("MX", 0, +1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Increase the master X dimension by 1, i. e. increase the number of windows in
|
|
|
|
the master area by Y. Maximum of 9 (only for the "tile" layout).
|
|
|
|
|
2015-01-26 21:51:19 +00:00
|
|
|
`#^Left::View_setLayoutProperty("MX", 0, +1)`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Decrease the master X dimension by 1, i. e. decrease the number of windows in
|
|
|
|
the master area by Y. Minimum of 1 (only for the "tile" layout).
|
|
|
|
|
2015-01-27 20:30:10 +00:00
|
|
|
`#+Left::View_setLayoutProperty("GapWidth", 0, -2)`
|
|
|
|
> Decrease the gap between windows in "monocle" and "tile" layout.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
2015-01-27 20:30:10 +00:00
|
|
|
`#+Right::View_setLayoutProperty("GapWidth", 0, +2)`
|
|
|
|
> Increase the gap between windows in "monocle" and "tile" layout.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
### View / Tag management
|
2014-03-08 22:32:32 +00:00
|
|
|
|
2014-03-07 00:16:32 +00:00
|
|
|
`#+n::View_toggleMargins()`
|
|
|
|
> Toggle the view margins, which are set by the configuration variable
|
2014-03-07 00:21:59 +00:00
|
|
|
`Config_viewMargins`.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#BackSpace::Monitor_activateView(-1)`
|
|
|
|
> Activate the previously activated view. You may also use
|
2014-03-07 00:30:21 +00:00
|
|
|
`Monitor_activateView(<)` or `Monitor_activateView(>)` for activating the
|
2014-03-07 00:16:32 +00:00
|
|
|
previous or next adjacent view.
|
|
|
|
|
|
|
|
`#+0::Monitor_setWindowTag(0)`
|
2014-03-07 00:34:54 +00:00
|
|
|
> Tag the active window with all tags (n = 1..`Config_viewCount`). You may also
|
2014-03-07 00:30:21 +00:00
|
|
|
use `Monitor_setWindowTag(<)` or `Monitor_setWindowTag(>)` for setting the tag
|
2014-03-07 00:16:32 +00:00
|
|
|
of the previous or next adjacent to the current view.
|
|
|
|
|
|
|
|
`#<n>::Monitor_activateView(<n>)`
|
2014-03-07 00:34:54 +00:00
|
|
|
> Activate the n<sup><small>th</small></sup> view (n = 1..`Config_viewCount`).
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#+<n>::Monitor_setWindowTag(<n>)`
|
|
|
|
> Tag the active window with the n<sup><small>th</small></sup> tag (n =
|
2014-03-07 00:34:54 +00:00
|
|
|
1..`Config_viewCount`).
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#^<n>::Monitor_toggleWindowTag(<n>)`
|
2014-03-07 00:34:54 +00:00
|
|
|
> Add / Remove the n<sup><small>th</small></sup> tag (n = 1..`Config_viewCount`)
|
2014-03-07 00:16:32 +00:00
|
|
|
for the active window, if it is not / is already set.
|
|
|
|
|
|
|
|
### Monitor management
|
2014-03-08 22:32:32 +00:00
|
|
|
|
2014-03-07 00:16:32 +00:00
|
|
|
`#.::Manager_activateMonitor(+1)`
|
|
|
|
> Activate the next monitor in a multi-monitor environment.
|
|
|
|
|
|
|
|
`#,::Manager_activateMonitor(-1)`
|
|
|
|
> Activate the previous monitor in a multi-monitor environment.
|
|
|
|
|
|
|
|
`#+.::Manager_setWindowMonitor(+1)`
|
|
|
|
> Set the active window to the active view on the next monitor in a
|
|
|
|
multi-monitor environment.
|
|
|
|
|
|
|
|
`#+,::Manager_setWindowMonitor(-1)`
|
|
|
|
> Set the active window to the active view on the previous monitor in a
|
|
|
|
multi-monitor environment.
|
|
|
|
|
|
|
|
`#^+.::Manager_setViewMonitor(+1)`
|
|
|
|
> Set all windows of the active view on the active view of the next monitor in
|
|
|
|
a multi-monitor environment.
|
|
|
|
|
|
|
|
`#^+,::Manager_setViewMonitor(-1)`
|
|
|
|
> Set all windows of the active view on the active view of the previous monitor
|
|
|
|
in a multi-monitor environment.
|
|
|
|
|
|
|
|
### GUI management
|
2014-03-08 22:32:32 +00:00
|
|
|
|
2014-03-07 00:16:32 +00:00
|
|
|
`#+Space::Monitor_toggleBar()`
|
|
|
|
> Hide / Show the bar (bug.n status bar) on the active monitor.
|
|
|
|
|
|
|
|
`#Space::Monitor_toggleTaskBar()`
|
|
|
|
> Hide / Show the task bar.
|
|
|
|
|
|
|
|
`#y::Bar_toggleCommandGui()`
|
|
|
|
> Open the command GUI for executing programmes or bug.n functions.
|
|
|
|
|
|
|
|
`#+y::Monitor_toggleNotifyIconOverflowWindow()`
|
|
|
|
> Toggle the overflow window of the 'notify icons'.
|
|
|
|
|
|
|
|
`!+y::View_traceAreas()`
|
|
|
|
> Indicate the areas of the "tile" layout.
|
|
|
|
|
|
|
|
### Administration
|
|
|
|
|
2014-03-07 00:30:21 +00:00
|
|
|
`#^e::Run, edit %Config_filePath%`
|
2014-03-07 00:16:32 +00:00
|
|
|
> Open the configuration file in the standard text editor.
|
|
|
|
|
|
|
|
`#^s::Config_UI_saveSession()`
|
|
|
|
> Save the current state of monitors, views, layouts to the configuration file.
|
|
|
|
|
|
|
|
`#^r::Main_reload()`
|
|
|
|
> Reload bug.n (i. e. the configuration and its dependent settings) without
|
|
|
|
deleting the window lists of bug.n and restoring windows.
|
2014-03-07 00:21:59 +00:00
|
|
|
- It does not reset internal configuration variables, the tray icon or menu,
|
2014-03-07 00:34:54 +00:00
|
|
|
hotkeys (unless defined in `Config.ini`), individual window settings like
|
2014-03-07 00:30:21 +00:00
|
|
|
`Config_showBorder` (since windows might be hidden) or hiding the title bar, the
|
2014-03-07 00:16:32 +00:00
|
|
|
monitor count or views.
|
2014-03-07 00:21:59 +00:00
|
|
|
- It does not reload the monitor configuration and therefor does not recognize
|
2014-03-07 00:16:32 +00:00
|
|
|
any changes in the number of monitors.
|
2014-03-07 00:21:59 +00:00
|
|
|
- It does not reload functions.
|
|
|
|
- Changed rules are only applied to new windows.
|
2014-03-07 00:16:32 +00:00
|
|
|
|
|
|
|
`#^+r::Reload`
|
|
|
|
> Reload bug.n (i. e. the whole script), which resets the configuration, the
|
|
|
|
bar, the monitor configuration and window lists of bug.n. It is like Quitting
|
|
|
|
and restarting bug.n.
|
|
|
|
|
|
|
|
`#^q::ExitApp`
|
|
|
|
> Quit bug.n, restore the default Windows UI and show all windows.
|