bug.n/README.md

135 lines
5.6 KiB
Markdown

# ct"wm" (Cyn's tiling "window manager") (working title)
Personal fork of bug.n
## Changes
### Bar
* Disabled shebang
* Icon support
* Time and date can be combined and clicked on to change between states
* MusicBee integration via MusicBeeIPC plugin
* Proper text resizing
* Clicking items no longer repositions mouse cursor
* Bar elements no longer have progress element
* Time has optional binary clock mode
* `Config_verticalBarPos` set to `tray` now attaches itself to first toolbar window
* This needs to be reworked, and the rest of the bar needs to be split to a second toolbar
* `Config_verticalBarPos` set to `tray` will set styles on the taskbar (temporary hybrid classic theme workaround)
### Config
* Renamed `Config_readinMemoryUsage` to `Config_readinRam`
* Added `Config_readinMusic`, only supports MusicBee currently
* Added `Config_readinTimeBinary` for enabling binary clock
* Removed `Config_readinDiskLoad` and `Config_readinNetworkLoad`
* Added `Config_barItemSpacing`, `Config_barIconSpacing` and `Config_iconFontYOffset`
* Added `Config_barIcons`: `<time>;<date>;<ram>;<cpu>;<battery>;<volume>;<music>`
* Added `Config_combineDateAndTime`
* Added `Config_readinTitle`
### ResourceMonitor
* RAM is now in MB
* Different CPU load getting functions
### Window
* Implement [GH-283](https://github.com/fuhsjr00/bug.n/pull/283)
<details>
<summary><h2>bug.n README</h2></summary>
## bug.n &ndash; Tiling Window Management
bug.n is a
[tiling window manager](https://en.wikipedia.org/wiki/Tiling_window_manager)
add-on for the Explorer shell of Microsoft Windows. It is written in the
scripting language [AutoHotkey](https://www.autohotkey.com/download/).
### 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 and volume 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.
### What it can look like
![Screenshot of bug.n with the default configuration.](https://github.com/fuhsjr00/bug.n/wiki/Configuration-examples/default_01.png "Screenshot of bug.n with the default configuration.")
### Installing and running bug.n
##### Requirements
* Microsoft Windows 2000 or higher
* [AutoHotkey](https://www.autohotkey.com/download/) 1.1.10 or higher (if running
bug.n from source as a script)
You may either
[download the stable version of bug.n](https://github.com/fuhsjr00/bug.n/releases/latest)
from the repository, or
[download the current development version](https://github.com/fuhsjr00/bug.n/archive/master.zip)
as the repository itself. Either way, you will have a `zip` file including an
executable (`bugn.exe`), the source (`src\*`) and documentation (`doc\*`)
files.
There is no installation process for bug.n. Unpack the `zip` file, and you
should be able to run either the executable as it is or the main script
(`src\Main.ahk`) with [AutoHotkey](https://www.autohotkey.com/download/).
### Documentation
Please see the [documentation](./doc) for more information on
[installing and running](./doc/Installing_and_running.md),
[customizing](./doc/Customization.md) and [using](./doc/Usage.md) bug.n and for
a list of [changes](./doc/CHANGES.md) made with the current version, in
particular the changes in the user interface
([configuration variables](./doc/Default_configuration.md) and
[hotkeys](./doc/Default_hotkeys.md)).
Please see the [CREDITS file](./doc/CREDITS.md) for a list of people and projects,
which contributed to bug.n.
### License
bug.n is licensed under the GNU General Public License version 3. Please see
the [LICENSE file](./LICENSE.md) for the full license text.
### Development
Currently, there are two branches:
* `master`, the current stable version (v9), which is no longer actively developed or maintained;
* `X`, a development version (v10), which is a rewrite of bug.n and in alpha stage, but development is dormant.
</details>