bug.n/doc/Default_hotkeys.md

496 lines
17 KiB
Markdown
Raw Normal View History

## 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
2015-05-28 21:11:29 +00:00
`Config_hotkey=<modifier><key>::<function>(<argument>)`; you may copy the
2015-03-15 16:56:14 +00:00
string from ` ` and use it as a template for a new line in `Config.ini`.
2014-03-07 00:16:32 +00:00
Possible modifiers are the following:
2015-03-15 16:56:14 +00:00
* `!` <kbd>Alt</kbd>
* `^` <kbd>Ctrl</kbd>, Control
* `#` <kbd>Win</kbd> / LWin, the left Windows key
* `+` <kbd>Shift</kbd>
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
2015-03-15 15:32:09 +00:00
left 'Windows key' and the 'Control key' and the 'Q key'
(<kbd>Win</kbd><kbd>Ctrl</kbd><kbd>Q</kbd>) for quitting bug.n.
2014-03-07 00:16:32 +00:00
### Window management
2015-05-28 21:11:29 +00:00
`Config_hotkey=#Down::View_activateWindow(0, +1)`
2014-03-07 00:16:32 +00:00
_Activate_ the _next_ window in the active view.
2019-04-07 19:11:56 +00:00
> You may also activate a window on an absolute position in the window list by
using the first parameter; e.g `View_activateWindow(1)` activates the first
window, which is the window in the master area, if you are using the default
settings for the tile layout.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#Up::View_activateWindow(0, -1)`
2014-03-07 00:16:32 +00:00
_Activate_ the _previous_ window in the active view.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+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-05-28 21:11:29 +00:00
`Config_hotkey=#+Up::View_shuffleWindow(0, -1)`
2014-03-07 00:16:32 +00:00
2019-04-07 19:11:56 +00:00
_Move_ the active window _to the previous position_ in the window list of the
view.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+Enter::View_shuffleWindow(1)`
2019-04-07 19:11:56 +00:00
_Move_ the active window _to the first position_ in the window list of the
view.
> 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
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#c::Manager_closeWindow()`
2014-03-07 00:16:32 +00:00
_Close_ the active window.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+d::Window_toggleDecor()`
2014-03-07 00:16:32 +00:00
_Show / Hide the title bar_ of the active window.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+f::View_toggleFloatingWindow()`
_Toggle_ the _floating status_ of the active window.
2019-04-07 19:11:56 +00:00
> The floating status effects the tiling of the active window (i.e. dis- /
regard it).
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^m::Manager_minimizeWindow()`
_Minimize_ the active window.
> This implicitly sets the window to be floating.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+m::Manager_moveWindow()`
2015-07-15 20:46:00 +00:00
_Move_ the active window _by key_.
2014-03-07 00:16:32 +00:00
> This implicitly sets the window to be floating.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+s::Manager_sizeWindow()`
2015-07-15 20:46:00 +00:00
_Resize_ the active window _by key_.
> This implicitly sets the window to be floating.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+x::Manager_maximizeWindow()`
2015-07-15 20:46:00 +00:00
_Move and resize_ the active window _to_ the size of the _work area_.
2014-03-07 00:16:32 +00:00
> This implicitly sets the window to be floating.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#i::Manager_getWindowInfo()`
Get information for the active window.
2019-04-07 19:11:56 +00:00
> The information being id, title, class, process name, style, geometry, tags
and floating state.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+i::Manager_getWindowList()`
_Get a window list_ for the active view.
2014-03-07 00:16:32 +00:00
> The list contains information about the window id, title and class.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=!Down::View_moveWindow(0, +1)`
2014-03-07 00:16:32 +00:00
Manually _move_ the active window _to the next area_ in the layout.
> This has only an effect, if dynamic tiling is disabled (`Config_dynamicTiling=0`).
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
`Config_hotkey=!Up::View_moveWindow(0, -1)`
Manually _move_ the active window _to the previous area_ in the layout.
2015-07-15 20:46:00 +00:00
2019-04-07 19:11:56 +00:00
> This has only an effect, if dynamic tiling is disabled
(`Config_dynamicTiling=0`).
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
`Config_hotkey=!+Enter::Manager_maximizeWindow()`
2015-07-15 20:46:00 +00:00
_Move and resize_ the active window _to_ the size of the _work area_.
2015-07-15 20:46:00 +00:00
> This implicitly sets the window to be floating.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
`Config_hotkey=!<n>::View_moveWindow(<n>)`
2014-03-07 00:16:32 +00:00
2019-04-07 19:11:56 +00:00
Manually _move_ the active window _to the n<sup><small>th</small></sup> area_
in the layout.
2019-04-07 19:11:56 +00:00
> &lt;n&gt; can be an integer between 1 and 9. This has only an effect, if
dynamic tiling is disabled (`Config_dynamicTiling=0`).
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=!BackSpace::View_toggleStackArea()`
2019-04-07 19:11:56 +00:00
Toggle the stack area of the layout.
> If the stack area is toggled off, the master area takes up the whole view and
the stack area cannot be used to position windows.
> This has only an effect, if dynamic tiling is disabled (`Config_dynamicTiling=0`).
2014-03-07 00:16:32 +00:00
### Window debugging
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^i::Debug_logViewWindowList()`
2014-03-07 00:16:32 +00:00
_Dump_ window information on the _windows of the active view_ to the log.
-------------------------------------------------------------------------------
2015-07-15 20:46:00 +00:00
`Config_hotkey=#^+i::Debug_logManagedWindowList()`
_Dump_ window information on the _managed windows_ to the log.
2019-04-07 19:11:56 +00:00
> The list of managed windows contains the floating and tiled windows of all
views.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^h::Debug_logHelp()`
_Print column headings_ to the log.
2014-03-07 00:16:32 +00:00
> The column headings give a description of the formatting used in the previous
two hotkeys being `Manager_logViewWindowList` and `Manager_logManagedWindowList`.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^d::Debug_setLogLevel(0, -1)`
2019-04-07 19:11:56 +00:00
Decrement the debug log level.
2019-04-07 19:11:56 +00:00
> This results in showing 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-05-28 21:11:29 +00:00
`Config_hotkey=#^+d::Debug_setLogLevel(0, +1)`
2019-04-07 19:11:56 +00:00
Increment the debug log level.
2019-04-07 19:11:56 +00:00
> This results in showing 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
2015-05-28 21:11:29 +00:00
`Config_hotkey=#Tab::View_setLayout(-1)`
2019-04-07 19:11:56 +00:00
Set the _previous_-ly set _layout_.
2019-04-07 19:11:56 +00:00
> 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
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#f::View_setLayout(3)`
2014-03-07 00:16:32 +00:00
Set the _floating layout_.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#m::View_setLayout(2)`
2014-03-07 00:16:32 +00:00
Set the _monocle layout_.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#t::View_setLayout(1)`
2014-03-07 00:16:32 +00:00
Set the _tile layout_.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#Left::View_setLayoutProperty(MFactor, 0, -0.05)`
2015-07-15 20:46:00 +00:00
_Reduce_ the size of _the master area_ in the active view.
> This has only an effect, if the tile layout is active.
2019-04-07 19:11:56 +00:00
> You may also set an additional parameter for accelerating the third one. E.g.
with `Config_hotkey=#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.
2015-03-15 16:56:14 +00:00
`View_setLayoutProperty(MFactor, 0.5, 0)` splits the view in half.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#Right::View_setLayoutProperty(MFactor, 0, +0.05)`
2015-07-15 20:46:00 +00:00
_Enlarge_ the size of _the master area_ in the active view.
> This has only an effect, if the tile layout is active.
2019-04-07 19:11:56 +00:00
> You may also set a additional parameter for accelerating the third one. E.g.
with `Config_hotkey=#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.
2015-03-15 16:56:14 +00:00
`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-05-28 21:11:29 +00:00
`Config_hotkey=#^t::View_setLayoutProperty(Axis, 0, +1, 1)`
Rotate the layout axis.
> I.e. 2 -> 1 = vertical layout, 1 -> 2 = horizontal layout.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^Enter::View_setLayoutProperty(Axis, 0, +2, 1)`
Mirror the layout axis.
2019-04-07 19:11:56 +00:00
> I.e. -1 -> 1 / 1 -> -1 = master on the left / right side,
-2 -> 2 / 2 -> -2 = master at top / bottom.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^Tab::View_setLayoutProperty(Axis, 0, +1, 2)`
Rotate the master axis.
2019-04-07 19:11:56 +00:00
> I.e. 3 -> 1 = x-axis = horizontal stack, 1 -> 2 = y-axis = vertical stack,
2 -> 3 = z-axis = monocle.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^+Tab::View_setLayoutProperty(Axis, 0, +1, 3)`
Rotate the stack axis.
2019-04-07 19:11:56 +00:00
> I.e. 3 -> 1 = x-axis = horizontal stack, 1 -> 2 = y-axis = vertical stack,
2 -> 3 = z-axis = monocle.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^Up::View_setLayoutProperty(MY, 0, +1)`
Increase the master Y dimension.
2019-04-07 19:11:56 +00:00
> This results in an increased number of windows in the master area by X.
Maximum of 9.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^Down::View_setLayoutProperty(MY, 0, -1)`
Decrease the master Y dimension.
2019-04-07 19:11:56 +00:00
> This results in a decreased number of windows in the master area by X.
Minimum of 1.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^Right::View_setLayoutProperty(MX, 0, +1)`
Increase the master X dimension.
2019-04-07 19:11:56 +00:00
> This results in an increased number of windows in the master area by Y.
Maximum of 9.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2016-06-22 13:48:38 +00:00
`Config_hotkey=#^Left::View_setLayoutProperty(MX, 0, -1)`
Decrease the master X dimension.
2019-04-07 19:11:56 +00:00
> This results in a decreased number of windows in the master area by Y.
Minimum of 1.
2014-03-07 00:16:32 +00:00
> This has only an effect, if the tile layout is active.
2015-07-15 20:46:00 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+Left::View_setLayoutProperty(GapWidth, 0, -2)`
2019-04-07 19:11:56 +00:00
_Decrease the gap between windows_ in "monocle" and "tile" layout.
2019-04-07 19:11:56 +00:00
> You may also set an absolute value for the gap width by using the first
parameter, e.g. `View_setLayoutProperty(GapWidth, 0, 0)` will eliminate the
gap and `View_setLayoutProperty(GapWidth, 20, 0)` will set it to 20px.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+Right::View_setLayoutProperty(GapWidth, 0, +2)`
_Increase the gap between windows_ in "monocle" and "tile" layout.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
`Config_hotkey=#^Backspace::View_resetTileLayout()`
_Reset the tile layout_.
2019-04-07 19:11:56 +00:00
> This resets the layout and tile layout properties of the currently active
view to the initial (default) values.
2014-03-07 00:16:32 +00:00
### View / Tag management
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+n::View_toggleMargins()`
Toggle the view margins.
> These are set by the configuration variable `Config_viewMargins`.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#BackSpace::Monitor_activateView(-1)`
2019-04-07 19:11:56 +00:00
Activate the previously activated view.
2019-04-07 19:11:56 +00:00
> You may also use `Monitor_activateView(0, -1)` or `Monitor_activateView(0, +1)`
for activating the previous or next adjacent view.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+0::Monitor_setWindowTag(10)`
2014-03-07 00:16:32 +00:00
2019-04-07 19:11:56 +00:00
Tag the active window with all tags.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#<n>::Monitor_activateView(<n>)`
2015-07-15 20:46:00 +00:00
Activate the n<sup><small>th</small></sup> view.
2014-03-07 00:16:32 +00:00
> &lt;n&gt; can be an integer between 1 and `Config_viewCount`.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+<n>::Monitor_setWindowTag(<n>)`
2015-07-15 20:46:00 +00:00
Tag the active window with the n<sup><small>th</small></sup> tag.
> &lt;n&gt; can be an integer between 1 and `Config_viewCount`.
2015-07-15 20:46:00 +00:00
2019-04-07 19:11:56 +00:00
> You may also use `Monitor_setWindowTag(0, -1)` or `Monitor_setWindowTag(0, +1)`
2015-07-15 20:46:00 +00:00
for setting the tag of the previous or next adjacent to the current view.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^<n>::Monitor_toggleWindowTag(<n>)`
2015-07-15 20:46:00 +00:00
Add / Remove the n<sup><small>th</small></sup> tag for the active window, if it
is not / is already set.
> &lt;n&gt; can be an integer between 1 and `Config_viewCount`.
2014-03-07 00:16:32 +00:00
### Monitor management
2015-05-28 21:11:29 +00:00
`Config_hotkey=#.::Manager_activateMonitor(0, +1)`
2019-04-07 19:11:56 +00:00
Activate the _next monitor_ in a multi-monitor environment.
> You may also activate a specific monitor by using the first parameter, e.g.
`Manager_activateMonitor(1)` will activate the first monitor.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#,::Manager_activateMonitor(0, -1)`
2014-03-07 00:16:32 +00:00
Activate the _previous monitor_ in a multi-monitor environment.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+.::Manager_setWindowMonitor(0, +1)`
_Set_ the active window's view _to_ the active view on _the next monitor_ in a
2019-04-07 19:11:56 +00:00
multi-monitor environment.
2019-04-07 19:11:56 +00:00
> You may also set the active window on a specific monitor by using the first
parameter, e.g. `Manager_setWindowMonitor(1)` will set the active window on
the first monitor.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+,::Manager_setWindowMonitor(0, -1)`
2014-03-07 00:16:32 +00:00
2019-04-07 19:11:56 +00:00
_Set_ the active window's view _to_ the active view on _the previous monitor_
in a multi-monitor environment.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^+.::Manager_setViewMonitor(0, +1)`
_Set all windows_ of the active view _on_ the active view of _the next monitor_
2019-04-07 19:11:56 +00:00
in a multi-monitor environment.
2014-03-07 00:16:32 +00:00
2019-04-07 19:11:56 +00:00
> You may also set all windows of the active view on a specific monitor by
using the first parameter, e.g. `Manager_setViewMonitor(1)` will set all
windows of the active view on the first monitor.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^+,::Manager_setViewMonitor(0, -1)`
2019-04-07 19:11:56 +00:00
_Set all windows_ of the active view _on_ the active view of
_the previous monitor_ in a multi-monitor environment.
2014-03-07 00:16:32 +00:00
### GUI management
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+Space::Monitor_toggleBar()`
2014-03-07 00:16:32 +00:00
_Hide / Show the bar_ (bug.n status bar) on the active monitor.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#Space::Monitor_toggleTaskBar()`
2014-03-07 00:16:32 +00:00
Hide / Show the task bar.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#y::Bar_toggleCommandGui()`
2014-03-07 00:16:32 +00:00
_Open the command GUI_ for executing programmes or bug.n functions.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#+y::Monitor_toggleNotifyIconOverflowWindow()`
2014-03-07 00:16:32 +00:00
Toggle the overflow window of the 'notify icons'.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=!+y::View_traceAreas()`
Indicate the areas of the "tile" layout.
2014-03-07 00:16:32 +00:00
### Administration
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^e::Run, edit <Config_filePath>`
2019-04-07 19:11:56 +00:00
Open the configuration file in the standard text editor.
2019-04-07 19:11:56 +00:00
> If you want to set this hotkey in `Config.ini`, you have to replace
`<Config_filePath>` with an explicit file path.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^s::Config_UI_saveSession()`
2014-03-07 00:16:32 +00:00
_Save the current state_ of monitors, views, layouts to the configuration file.
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^r::Reload`
_Reload_ bug.n (i.e. the whole script).
2019-04-07 19:11:56 +00:00
> This resets i.a. the configuration and internal variables of bug.n,
including the window lists. It is like Quitting and restarting bug.n.
If `Config_autoSaveSession` is not set to `off`, the window lists can be
restored and windows are put to their associated monitor and views.
2014-03-07 00:16:32 +00:00
-------------------------------------------------------------------------------
2015-05-28 21:11:29 +00:00
`Config_hotkey=#^q::ExitApp`
_Quit_ bug.n, restore the default Windows UI and show all windows.