Cynosphere/bug.n
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
bug.n/README.md
joten 4aa875c4f8 finetuned README
2014-03-07 00:15:19 +01:00

5.3 KiB
Raw Blame History

bug.n -- Tiling Window Manager

bug.n is a tiling window manager add-on for Microsoft Windows. It is written in the scripting language AutoHotkey.

What it can do

  • Provide layouts for resizing and moving windows, utilizing all available screen estate and customizable to your specific needs and workflow
  • Provide views (i. e. virtual desktops) for showing only those windows, which you need to do your work.
  • Dynamically resize and move your windows, applying a specified layout, without you having to care about moving them all by mouse
  • Increase the available screen estate by hiding and therewith freeing up the space occupied by
    • the Microsoft Windows Taskbar and
    • the title bar for every single window
  • and replacing all with a single slim status bar (-- but bug.n is not a shell replacement)
  • Show window management information in the status bar:
    • active window title
    • active layout
    • overview of the views used
  • Show system information in the status bar:
    • time and date
    • CPU and memory usage
    • disk and network load
    • battery level
  • Store your settings, i. e. which windows and layout were set on a specific view
  • Support multiple monitors

What it enables you to do

  • You can resize and move windows specified by the active layout and initialized by hotkey.
  • You can toggle the visibility of the Windows Taskbar.
  • You can toggle the visibility of the Windows title bar of the active window.
  • You can change the layout for the tiling window management suitable to your needs.
    • Tile: Lay out all windows like tiles on a master area, which can be further split up, and a stacking area, where remaining windows can be stacked or shown side by side.
    • Monocle: All windows are maximized and only one is shown at any time.
    • Floating: Windows are not dynamically tiled.
  • You can further customize the layouts for each view.
  • You can move windows to another view (virtual desktop) by tagging them with a number.
  • You can share windows between views by tagging them with more than one number.
  • You can move between views, hiding the windows, you do not want to see, and showing those, you want to see, by pressing a simple hotkey.

Installing and running bug.n

Requirements

  • Microsoft Windows 2000 or higher
  • AutoHotkey (if running bug.n from source as a script)

There is no installation wizard for bug.n. If you downloaded the repository from GitHub as a zip file and unpacked it, you should be able to run either the executbale as it is or the main script (src\Main.ahk) with AutoHotkey.

bug.n stores the session data (configuration, layout, window states and log) to the user's APPDATA directory, e. g. C:\Users\joten\AppData\Roaming\bug.n.

Please see the documentation or the Wiki for more information on installing and running, customizing and using bug.n and for a list of changes made with the current version, in particular the changes in the user interface (configuration variables and hotkeys).

License

bug.n is licensed under the GNU General Public License version 3. Please see the LICENSE file for the full license text.

Credits

bug.n and its documentation is written by Joshua Fuhs and joten, but some source was copied from the AutoHotkey forum (http://www.autohotkey.com/forum). These are explicitly marked in the source code at the end of the appropriate section. Additionally the following listing summarizes these sources (of ideas or code):

Patch ideas

  • pitkali (http://pitkali.info/bugn):
    • Sync window arrays on fussy events and unknown window ids
    • Dialog detection upon manage
    • Regular expression support in rules
    • Window information handling patches
      • memory leaks
      • flickering windows

Ideas or concepts

Code snippets