Cynosphere/bug.n
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Merge pull request #51 from ctjhoa/master

Browse source 
Fix #50
This commit is contained in:
fuhsjr00 2015-06-08 22:18:27 -04:00
commit 1ea9f9cd96
1 changed files with 65 additions and 65 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

130
doc/Default_hotkeys.md
View file

@ -3,7 +3,7 @@
### General description ### General description
The hotkeys, as you can set them in `Config.ini`, are noted in the format The hotkeys, as you can set them in `Config.ini`, are noted in the format
`Conifg_hotkey=<modifier><key>::<function>(<argument>)`; you may copy the `Config_hotkey=<modifier><key>::<function>(<argument>)`; you may copy the
string from ` ` and use it as a template for a new line in `Config.ini`. string from ` ` and use it as a template for a new line in `Config.ini`.
Possible modifiers are the following: Possible modifiers are the following:
@ -19,269 +19,269 @@ left 'Windows key' and the 'Control key' and the 'Q key'
### Window management ### Window management
`Conifg_hotkey=#Down::View_activateWindow(0, +1)` `Config_hotkey=#Down::View_activateWindow(0, +1)`
> Activate the next window in the active view. > Activate the next window in the active view.
`Conifg_hotkey=#Up::View_activateWindow(0, -1)` `Config_hotkey=#Up::View_activateWindow(0, -1)`
> Activate the previous window in the active view. > Activate the previous window in the active view.
`Conifg_hotkey=#+Down::View_shuffleWindow(0, +1)` `Config_hotkey=#+Down::View_shuffleWindow(0, +1)`
> Move the active window to the next position in the window list of the view. > Move the active window to the next position in the window list of the view.
`Conifg_hotkey=#+Up::View_shuffleWindow(0, -1)` `Config_hotkey=#+Up::View_shuffleWindow(0, -1)`
> Move the active window to the previous position in the window list of the view. > Move the active window to the previous position in the window list of the view.
`Conifg_hotkey=#+Enter::View_shuffleWindow(1)` `Config_hotkey=#+Enter::View_shuffleWindow(1)`
> Move the active window to the first position in the window list of the view. > 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 You may also move the active window to any other absolute position in the
window list by using the first parameter. window list by using the first parameter.
`Conifg_hotkey=#c::Manager_closeWindow()` `Config_hotkey=#c::Manager_closeWindow()`
> Close the active window. > Close the active window.
`Conifg_hotkey=#+d::Window_toggleDecor()` `Config_hotkey=#+d::Window_toggleDecor()`
> Show / Hide the title bar of the active window. > Show / Hide the title bar of the active window.
`Conifg_hotkey=#+f::View_toggleFloatingWindow()` `Config_hotkey=#+f::View_toggleFloatingWindow()`
> Toggle the floating status of the active window (i. e. dis- / regard it when > Toggle the floating status of the active window (i. e. dis- / regard it when
tiling). tiling).
`Conifg_hotkey=#^m::Manager_minimizeWindow()` `Config_hotkey=#^m::Manager_minimizeWindow()`
> Minimize the active window; this implicitly makes the window floating. > Minimize the active window; this implicitly makes the window floating.
`Conifg_hotkey=#+m::Manager_moveWindow()` `Config_hotkey=#+m::Manager_moveWindow()`
> Move the active window by key (only floating windows). > Move the active window by key (only floating windows).
`Conifg_hotkey=#+s::Manager_sizeWindow()` `Config_hotkey=#+s::Manager_sizeWindow()`
> Resize the active window by key (only floating windows). > Resize the active window by key (only floating windows).
`Conifg_hotkey=#+x::Manager_maximizeWindow()` `Config_hotkey=#+x::Manager_maximizeWindow()`
> Move and resize the active window to the size of the work area (only floating > Move and resize the active window to the size of the work area (only floating
windows). windows).
`Conifg_hotkey=#i::Manager_getWindowInfo()` `Config_hotkey=#i::Manager_getWindowInfo()`
> Get information for the active window (id, title, class, process name, style, > Get information for the active window (id, title, class, process name, style,
geometry, tags and floating state). geometry, tags and floating state).
`Conifg_hotkey=#+i::Manager_getWindowList()` `Config_hotkey=#+i::Manager_getWindowList()`
> Get a window list for the active view (id, title and class). > Get a window list for the active view (id, title and class).
`Conifg_hotkey=!Down::View_moveWindow(0, +1)` `Config_hotkey=!Down::View_moveWindow(0, +1)`
> Manually move the active window to the next area in the layout. > Manually move the active window to the next area in the layout.
`Conifg_hotkey=!Up::View_moveWindow(0, -1)` `Config_hotkey=!Up::View_moveWindow(0, -1)`
> Manually move the active window to the previous area in the layout. > Manually move the active window to the previous area in the layout.
`Conifg_hotkey=!+Enter::Manager_maximizeWindow()` `Config_hotkey=!+Enter::Manager_maximizeWindow()`
> Move and resize the active window to the size of the work area (only floating > Move and resize the active window to the size of the work area (only floating
windows). windows).
`Conifg_hotkey=!<n>::View_moveWindow(<n>)` `Config_hotkey=!<n>::View_moveWindow(<n>)`
> Manually move the active window to the n<sup><small>th</small></sup> area in > Manually move the active window to the n<sup><small>th</small></sup> area in
the layout (n = 1..9). the layout (n = 1..9).
`Conifg_hotkey=!0::View_moveWindow(10)` `Config_hotkey=!0::View_moveWindow(10)`
> Manually move the active window to the n<sup><small>th</small></sup> area in > Manually move the active window to the n<sup><small>th</small></sup> area in
the layout. the layout.
`Conifg_hotkey=!BackSpace::View_toggleStackArea()` `Config_hotkey=!BackSpace::View_toggleStackArea()`
> Toggle the stack area of the layout. If the stack area is disabled, the > Toggle the stack area of the layout. If the stack area is disabled, the
master area takes up the whole view. master area takes up the whole view.
### Window debugging ### Window debugging
`Conifg_hotkey=#^i::Debug_logViewWindowList()` `Config_hotkey=#^i::Debug_logViewWindowList()`
> Dump window information on the windows of the active view to the log. > Dump window information on the windows of the active view to the log.
`Conifg_hotkey=#+^i::Debug_logManagedWindowList()` `Config_hotkey=#+^i::Debug_logManagedWindowList()`
> Dump window information on the contents of the managed window list (floating > Dump window information on the contents of the managed window list (floating
and tiled windows of all views) to the log. and tiled windows of all views) to the log.
`Conifg_hotkey=#^h::Debug_logHelp()` `Config_hotkey=#^h::Debug_logHelp()`
> Print a description of the formatting (column headings) used in the previous > Print a description of the formatting (column headings) used in the previous
two log messages (`Manager_logViewWindowList` and two log messages (`Manager_logViewWindowList` and
`Manager_logManagedWindowList`) to the log. `Manager_logManagedWindowList`) to the log.
`Conifg_hotkey=#^d::Debug_setLogLevel(0, -1)` `Config_hotkey=#^d::Debug_setLogLevel(0, -1)`
> Decrement the debug log level. Show fewer debug messages. You may also set > 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. the debug log level to an absolute value by using the first parameter.
`Conifg_hotkey=#^+d::Debug_setLogLevel(0, +1)` `Config_hotkey=#^+d::Debug_setLogLevel(0, +1)`
> Increment the debug log level. Show more debug messages. You may also set > 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. the debug log level to an absolute value by using the first parameter.
### Layout management ### Layout management
`Conifg_hotkey=#Tab::View_setLayout(-1)` `Config_hotkey=#Tab::View_setLayout(-1)`
> Set the previously set layout. You may also use `View_setLayout(0, +1)` for > 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 setting the next or `View_setLayout(0, -1)` for setting the previous layout in
the layout array. the layout array.
`Conifg_hotkey=#f::View_setLayout(3)` `Config_hotkey=#f::View_setLayout(3)`
> Set the 3<sup><small>rd</small></sup> defined layout (i. e. floating layout > Set the 3<sup><small>rd</small></sup> defined layout (i. e. floating layout
in the default configuration). in the default configuration).
`Conifg_hotkey=#m::View_setLayout(2)` `Config_hotkey=#m::View_setLayout(2)`
> Set the 2<sup><small>nd</small></sup> defined layout (i. e. monocle layout in > Set the 2<sup><small>nd</small></sup> defined layout (i. e. monocle layout in
the default configuration). the default configuration).
`Conifg_hotkey=#t::View_setLayout(1)` `Config_hotkey=#t::View_setLayout(1)`
> Set the 1<sup><small>st</small></sup> defined layout (i. e. tile layout in > Set the 1<sup><small>st</small></sup> defined layout (i. e. tile layout in
the default configuration). the default configuration).
`Conifg_hotkey=#Left::View_setLayoutProperty(MFactor, 0, -0.05)` `Config_hotkey=#Left::View_setLayoutProperty(MFactor, 0, -0.05)`
> Reduce the size of the master area in the active view (only for the "tile" > Reduce the size of the master area in the active view (only for the "tile"
layout). You may also set an additional parameter for accelerating the third layout). You may also set an additional parameter for accelerating the third
one. E. g. with one. E. g. with
`Conifg_hotkey=#Left::View_setLayoutProperty(MFactor, 0, -0.05, 2)` the first `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 step, by which the master area is reduced, is -0.0016% and will be doubled with
consecutive calls until it reaches -0.05%. consecutive calls until it reaches -0.05%.
With the second parameter you may set an absolute value, e. g. With the second parameter you may set an absolute value, e. g.
`View_setLayoutProperty(MFactor, 0.5, 0)` splits the view in half. `View_setLayoutProperty(MFactor, 0.5, 0)` splits the view in half.
`Conifg_hotkey=#Right::View_setLayoutProperty(MFactor, 0, +0.05)` `Config_hotkey=#Right::View_setLayoutProperty(MFactor, 0, +0.05)`
> Enlarge the size of the master area in the active view (only for the "tile" > Enlarge the size of the master area in the active view (only for the "tile"
layout). You may also set a additional parameter for accelerating the third layout). You may also set a additional parameter for accelerating the third
one. E. g. with one. E. g. with
`Conifg_hotkey=#Right::View_setLayoutProperty(MFactor, 0, +0.05, 0.5)` the `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 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%. calls it will be halved until it reaches 0.0016%.
With the second parameter you may set an absolute value, e. g. With the second parameter you may set an absolute value, e. g.
`View_setLayoutProperty(MFactor, 0.67, 0)` makes the master area two thirds `View_setLayoutProperty(MFactor, 0.67, 0)` makes the master area two thirds
and the stacking area one third the size of the view. and the stacking area one third the size of the view.
`Conifg_hotkey=#^t::View_setLayoutProperty(Axis, 0, +1, 1)` `Config_hotkey=#^t::View_setLayoutProperty(Axis, 0, +1, 1)`
> Rotate the layout axis (i. e. 2 -> 1 = vertical layout, 1 -> 2 = horizontal > Rotate the layout axis (i. e. 2 -> 1 = vertical layout, 1 -> 2 = horizontal
layout, only for the "tile" layout). layout, only for the "tile" layout).
`Conifg_hotkey=#^Enter::View_setLayoutProperty(Axis, 0, +2, 1)` `Config_hotkey=#^Enter::View_setLayoutProperty(Axis, 0, +2, 1)`
> Mirror the layout axis (i. e. -1 -> 1 / 1 -> -1 = master on the left / right > 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). side, -2 -> 2 / 2 -> -2 = master at top / bottom, only for the "tile" layout).
`Conifg_hotkey=#^Tab::View_setLayoutProperty(Axis, 0, +1, 2)` `Config_hotkey=#^Tab::View_setLayoutProperty(Axis, 0, +1, 2)`
> Rotate the master axis (i. e. 3 -> 1 = x-axis = horizontal stack, 1 -> 2 = > 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). y-axis = vertical stack, 2 -> 3 = z-axis = monocle, only for the "tile" layout).
`Conifg_hotkey=#^+Tab::View_setLayoutProperty(Axis, 0, +1, 3)` `Config_hotkey=#^+Tab::View_setLayoutProperty(Axis, 0, +1, 3)`
> Rotate the stack axis (i. e. 3 -> 1 = x-axis = horizontal stack, 1 -> 2 = > 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). y-axis = vertical stack, 2 -> 3 = z-axis = monocle, only for the "tile" layout).
`Conifg_hotkey=#^Up::View_setLayoutProperty(MY, 0, +1)` `Config_hotkey=#^Up::View_setLayoutProperty(MY, 0, +1)`
> Increase the master Y dimension by 1, i.e. increase the number of windows in > 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). the master area by X. Maximum of 9 (only for the "tile" layout).
`Conifg_hotkey=#^Down::View_setLayoutProperty(MY, 0, -1)` `Config_hotkey=#^Down::View_setLayoutProperty(MY, 0, -1)`
> Decrease the master Y dimension by 1, i.e. decrease the number of windows in > 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). the master area by X. Minimum of 1 (only for the "tile" layout).
`Conifg_hotkey=#^Right::View_setLayoutProperty(MX, 0, +1)` `Config_hotkey=#^Right::View_setLayoutProperty(MX, 0, +1)`
> Increase the master X dimension by 1, i. e. increase the number of windows in > 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). the master area by Y. Maximum of 9 (only for the "tile" layout).
`Conifg_hotkey=#^Left::View_setLayoutProperty(MX, 0, +1)` `Config_hotkey=#^Left::View_setLayoutProperty(MX, 0, +1)`
> Decrease the master X dimension by 1, i. e. decrease the number of windows in > 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). the master area by Y. Minimum of 1 (only for the "tile" layout).
`Conifg_hotkey=#+Left::View_setLayoutProperty(GapWidth, 0, -2)` `Config_hotkey=#+Left::View_setLayoutProperty(GapWidth, 0, -2)`
> Decrease the gap between windows in "monocle" and "tile" layout. You may also > Decrease the gap between windows in "monocle" and "tile" layout. You may also
set an absolute value for the gap width by using the first parameter, e. g. 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, 0, 0)` will eliminate the gap and
`View_setLayoutProperty(GapWidth, 20, 0)` will set it to 20px. `View_setLayoutProperty(GapWidth, 20, 0)` will set it to 20px.
`Conifg_hotkey=#+Right::View_setLayoutProperty(GapWidth, 0, +2)` `Config_hotkey=#+Right::View_setLayoutProperty(GapWidth, 0, +2)`
> Increase the gap between windows in "monocle" and "tile" layout. > Increase the gap between windows in "monocle" and "tile" layout.
### View / Tag management ### View / Tag management
`Conifg_hotkey=#+n::View_toggleMargins()` `Config_hotkey=#+n::View_toggleMargins()`
> Toggle the view margins, which are set by the configuration variable > Toggle the view margins, which are set by the configuration variable
`Config_viewMargins`. `Config_viewMargins`.
`Conifg_hotkey=#BackSpace::Monitor_activateView(-1)` `Config_hotkey=#BackSpace::Monitor_activateView(-1)`
> Activate the previously activated view. You may also use > Activate the previously activated view. You may also use
`Monitor_activateView(0, -1)` or `Monitor_activateView(0, +1)` for activating `Monitor_activateView(0, -1)` or `Monitor_activateView(0, +1)` for activating
the previous or next adjacent view. the previous or next adjacent view.
`Conifg_hotkey=#+0::Monitor_setWindowTag(10)` `Config_hotkey=#+0::Monitor_setWindowTag(10)`
> Tag the active window with all tags (n = 1..`Config_viewCount`). You may also > Tag the active window with all tags (n = 1..`Config_viewCount`). You may also
use `Monitor_setWindowTag(0, -1)` or `Monitor_setWindowTag(0, +1)` for setting use `Monitor_setWindowTag(0, -1)` or `Monitor_setWindowTag(0, +1)` for setting
the tag of the previous or next adjacent to the current view. the tag of the previous or next adjacent to the current view.
`Conifg_hotkey=#<n>::Monitor_activateView(<n>)` `Config_hotkey=#<n>::Monitor_activateView(<n>)`
> Activate the n<sup><small>th</small></sup> view (n = 1..`Config_viewCount`). > Activate the n<sup><small>th</small></sup> view (n = 1..`Config_viewCount`).
`Conifg_hotkey=#+<n>::Monitor_setWindowTag(<n>)` `Config_hotkey=#+<n>::Monitor_setWindowTag(<n>)`
> Tag the active window with the n<sup><small>th</small></sup> tag (n = > Tag the active window with the n<sup><small>th</small></sup> tag (n =
1..`Config_viewCount`). 1..`Config_viewCount`).
`Conifg_hotkey=#^<n>::Monitor_toggleWindowTag(<n>)` `Config_hotkey=#^<n>::Monitor_toggleWindowTag(<n>)`
> Add / Remove the n<sup><small>th</small></sup> tag (n = 1..`Config_viewCount`) > Add / Remove the n<sup><small>th</small></sup> tag (n = 1..`Config_viewCount`)
for the active window, if it is not / is already set. for the active window, if it is not / is already set.
### Monitor management ### Monitor management
`Conifg_hotkey=#.::Manager_activateMonitor(0, +1)` `Config_hotkey=#.::Manager_activateMonitor(0, +1)`
> Activate the next monitor in a multi-monitor environment. You may also > Activate the next monitor in a multi-monitor environment. You may also
activate a specific monitor by using the first parameter, e. g. activate a specific monitor by using the first parameter, e. g.
`Manager_activateMonitor(1)` will activate the first monitor. `Manager_activateMonitor(1)` will activate the first monitor.
`Conifg_hotkey=#,::Manager_activateMonitor(0, -1)` `Config_hotkey=#,::Manager_activateMonitor(0, -1)`
> Activate the previous monitor in a multi-monitor environment. > Activate the previous monitor in a multi-monitor environment.
`Conifg_hotkey=#+.::Manager_setWindowMonitor(0, +1)` `Config_hotkey=#+.::Manager_setWindowMonitor(0, +1)`
> Set the active window's view to the active view on the next monitor in a > Set the active window's view to the active view on the next monitor in a
multi-monitor environment. You may also set the active window on a specific multi-monitor environment. You may also set the active window on a specific
monitor by using the first parameter, e. g. `Manager_setWindowMonitor(1)` will monitor by using the first parameter, e. g. `Manager_setWindowMonitor(1)` will
set the active window on the first monitor. set the active window on the first monitor.
`Conifg_hotkey=#+,::Manager_setWindowMonitor(0, -1)` `Config_hotkey=#+,::Manager_setWindowMonitor(0, -1)`
> Set the active window's view to the active view on the previous monitor in a > Set the active window's view to the active view on the previous monitor in a
multi-monitor environment. multi-monitor environment.
`Conifg_hotkey=#^+.::Manager_setViewMonitor(0, +1)` `Config_hotkey=#^+.::Manager_setViewMonitor(0, +1)`
> Set all windows of the active view on the active view of the next monitor in > Set all windows of the active view on the active view of the next monitor in
a multi-monitor environment. You may also set all windows of the active view on a multi-monitor environment. You may also set all windows of the active view on
a specific monitor by using the first parameter, e. g. a specific monitor by using the first parameter, e. g.
`Manager_setViewMonitor(1)` will set all windows of the active view on the `Manager_setViewMonitor(1)` will set all windows of the active view on the
first monitor. first monitor.
`Conifg_hotkey=#^+,::Manager_setViewMonitor(0, -1)` `Config_hotkey=#^+,::Manager_setViewMonitor(0, -1)`
> Set all windows of the active view on the active view of the previous monitor > Set all windows of the active view on the active view of the previous monitor
in a multi-monitor environment. in a multi-monitor environment.
### GUI management ### GUI management
`Conifg_hotkey=#+Space::Monitor_toggleBar()` `Config_hotkey=#+Space::Monitor_toggleBar()`
> Hide / Show the bar (bug.n status bar) on the active monitor. > Hide / Show the bar (bug.n status bar) on the active monitor.
`Conifg_hotkey=#Space::Monitor_toggleTaskBar()` `Config_hotkey=#Space::Monitor_toggleTaskBar()`
> Hide / Show the task bar. > Hide / Show the task bar.
`Conifg_hotkey=#y::Bar_toggleCommandGui()` `Config_hotkey=#y::Bar_toggleCommandGui()`
> Open the command GUI for executing programmes or bug.n functions. > Open the command GUI for executing programmes or bug.n functions.
`Conifg_hotkey=#+y::Monitor_toggleNotifyIconOverflowWindow()` `Config_hotkey=#+y::Monitor_toggleNotifyIconOverflowWindow()`
> Toggle the overflow window of the 'notify icons'. > Toggle the overflow window of the 'notify icons'.
`Conifg_hotkey=!+y::View_traceAreas()` `Config_hotkey=!+y::View_traceAreas()`
> Indicate the areas of the "tile" layout. > Indicate the areas of the "tile" layout.
### Administration ### Administration
`Conifg_hotkey=#^e::Run, edit <Config_filePath>` `Config_hotkey=#^e::Run, edit <Config_filePath>`
> Open the configuration file in the standard text editor. If you want to set > Open the configuration file in the standard text editor. If you want to set
this hotkey in `Config.ini`, you have to replace `<Config_filePath>` with an this hotkey in `Config.ini`, you have to replace `<Config_filePath>` with an
explicit file path. explicit file path.
`Conifg_hotkey=#^s::Config_UI_saveSession()` `Config_hotkey=#^s::Config_UI_saveSession()`
> Save the current state of monitors, views, layouts to the configuration file. > Save the current state of monitors, views, layouts to the configuration file.
`Conifg_hotkey=#^r::Reload` `Config_hotkey=#^r::Reload`
> Reload bug.n (i. e. the whole script), which resets i. a. the configuration > Reload bug.n (i. e. the whole script), which resets i. a. the configuration
and internal variables of bug.n, including the window lists. It is like and internal variables of bug.n, including the window lists. It is like
Quitting and restarting bug.n. Quitting and restarting bug.n.
If `Config_autoSaveSession` is not set to `off`, the window lists can be If `Config_autoSaveSession` is not set to `off`, the window lists can be
restored and windows are put to their associated monitor and views. restored and windows are put to their associated monitor and views.
`Conifg_hotkey=#^q::ExitApp` `Config_hotkey=#^q::ExitApp`
> Quit bug.n, restore the default Windows UI and show all windows. > Quit bug.n, restore the default Windows UI and show all windows.