Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FelixKratz/JankyBorders
A lightweight window border system for macOS
https://github.com/FelixKratz/JankyBorders
border customization fast lightweight macos tiling-window-manager window-border yabai
Last synced: 11 days ago
JSON representation
A lightweight window border system for macOS
- Host: GitHub
- URL: https://github.com/FelixKratz/JankyBorders
- Owner: FelixKratz
- License: gpl-3.0
- Created: 2023-11-02T16:14:50.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-16T11:06:44.000Z (3 months ago)
- Last Synced: 2024-08-16T12:27:57.207Z (3 months ago)
- Topics: border, customization, fast, lightweight, macos, tiling-window-manager, window-border, yabai
- Language: C
- Homepage:
- Size: 3.21 MB
- Stars: 920
- Watchers: 5
- Forks: 19
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# JankyBorders
*JankyBorders* is a lightweight tool designed to add colored borders to
user windows on macOS 14.0+. It enhances the user experience by visually
highlighting the currently focused window without relying on the accessibility
API, thereby being faster than comparable tools.
## Usage
### Install
The binary can be made available by installing it through Homebrew:
```bash
brew tap FelixKratz/formulae
brew install borders
```
For a comprehensive overview of all available options and commands, consult the
man page: `man borders`. A rendered version of the man page is available in the
[Wiki](https://github.com/FelixKratz/JankyBorders/wiki/Man-Page).
### Bootstrap with yabai
For example, if you are using `yabai`, you could add:
```bash
borders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0 &
```
to the very end of your `yabairc`. This will start the borders with the
specified options along with yabai.
### Bootstrap with AeroSpace
You could add:
```toml
after-startup-command = [
'exec-and-forget borders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0'
]
```
to you `aerospace.toml`. This will start borders with the specified options
along with AeroSpace.
### Bootstrap with brew
If you want to run this as a separate service, you could use:
```bash
brew services start borders
```
### Configuring the appearance
You can either configure the appearance directly when starting the borders
process (as shown in "Bootstrap with yabai") or use a configuration file.
The appearance can be adapted at any point in time.
#### Using a configuration file (Optional)
If the primary `borders` process is started without any arguments (or launched
as a service by brew), it will search for a file at
`~/.config/borders/bordersrc` and execute it on launch if found.
An example configuration file could look like this:
`~/.config/borders/bordersrc`
```bash
#!/bin/bash
options=(
style=round
width=6.0
hidpi=off
active_color=0xffe2e2e3
inactive_color=0xff414550
)
borders "${options[@]}"
```
#### Updating the border properties during runtime
If a `borders` process is already running, invoking a new `borders` instance
with any combination of the available options will update the properties of
the already running instance.
## Documentation
Local documentation is available as `man borders` and as a rendered version in
the [Wiki](https://github.com/FelixKratz/JankyBorders/wiki/Man-Page).