bug.n/doc/Usage.md

3.8 KiB

Using bug.n

bug.n is mostly controlled with hotkeys. The available hotkeys are listed in the document "Default hotkeys". For a quick help there are the following hotkeys:

  • #y (Win+Y): Show the command GUI, which allows you to enter bug.n-functions.
  • #Space (Win+Space): Show / Hide the Windows Taskbar.
  • #^q (Win+Ctrl+Q): Quit bug.n and restore all windows and Windows UI elements.

The following functions can also be controlled with the mouse:

  • With a click on a tag (a number on the left end of the bug.n bar) you can change the view and show only the windows associated with that tag.
  • With a right-click on a tag you can tag the active window with that tag.
  • With a click on the layout symbol in the bug.n bar you can toggle the layout to the last one used.
  • With a right-click on the layout symbol you can set the layout to the next in the list.
  • A function can be selected from a list or entered in the command GUI, which is accessible by cklickig on #! on the right end of the bug.n bar.

You may also send commands to bug.n from another AutoHotkey script. The sent string is interpreted and executed by bug.n as one or more (separated by the newline character n</code>) either bug.n-functions (as used in the hotkey configuration) or AutoHotkey-commands (only RunorSend`). For example, you may use the following lines in an AutoHotkey script:

;; The following line is required.
DetectHiddenWindows, On

;; Syntax:
;; ControlSetText, Edit2, % "<function name>(<arguments>)", bug.n_BAR_0

;; 1st example:
;ControlSetText, Edit2, % "Monitor_activateView(4)", bug.n_BAR_0

;; 2nd example:
;ControlSetText, Edit2, % "Monitor_activateView(4)`nView_setLayout(3)", bug.n_BAR_0

;; 3rd example:
ControlSetText, Edit2, % "Monitor_activateView(4)`nRun, explorer.exe", bug.n_BAR_0

It might be necessary to put a Sleep, <delay in milliseconds>, e. g. Sleep, 200, between to consecutive ControlSetText to give bug.n time to recognize the next command.

Concepts

Layouts

bug.n provides three layouts.

  • tile: A master area for the main window(s) and a stacking area for the rest, all windows are shown at any time. This layout can be further changed in the following respects:
    • the dimensions of the master area (1x1 ... 2x3 ... 9x9)
    • the stacking direction of the master and stacking area (from left to right, from top to bottom or monocle)
    • the position of the master area (left, top, right or bottom) and accordingly the position of the stacking area
    • the witdh or height of the master area (depending on its position)
  • monocle: All windows are maximized and only one is shown at any time.
  • floating: Do not tile any window.

Please see the document "Default hotkeys" for a list of hotkeys and their associated functions, with which you can set and manipulate layouts.

Tagging

bug.n features an extended implementation of virtual desktops: tagging.

Windows are tagged with one or more numbers, which determine on which views they are shown. Selecting a view shows the windows tagged with the same number and hides all other windows.

Session management

bug.n features a session management, which is used for saving configuration variables, hotkeys and internal variables; it does not restore applications, you will have to run them manually. The configuration variables may include those listed in the document "Default configuration", hotkeys as listed in the document "Default hotkeys" and internal variables for the current state of bug.n, e. g. the active view (saved for each monitor), the layout and its configuration (saved for each view) and window states as they could be set by a rule.