Skip to content

pablopunk/edges

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Edges

A lightweight window border tool for macOS, written in Rust. Inspired by JankyBorders.

screenshot

Install

brew install pablopunk/brew/edges

Usage

# Start as a background service (runs at login)
brew services start edges

# Or run directly
edges

Configuration

Create ~/.config/edges/edges.toml:

style = "round"
width = 6.0
active_color = "0xffe2e2e3"
inactive_color = "0xff414550"
# order = "below"
# hidpi = false

Changes take effect after restarting: brew services restart edges

CLI options

CLI args override the config file:

edges --width 6.0 --active-color 0xffe2e2e3 --inactive-color 0xff414550
edges --style square
edges --hidpi
Flag Description Default
--width <N> Border width in points 4.0
--style <S> round, square, or uniform round
--active-color <HEX> Focused window border (ARGB) 0xffe1e3e4
--inactive-color <HEX> Unfocused window border (ARGB) 0x00000000
--hidpi Enable HiDPI rendering off
--config <PATH> Config file path ~/.config/edges/edges.toml

Service management

brew services start edges   # start and enable at login
brew services stop edges    # stop
brew services restart edges # restart after config changes

Memory footprint

Edges is designed to be lightweight. Memory scales with the number of open windows and is fully reclaimed when windows close:

Open windows Footprint
5 ~70 MB
10 ~85 MB
20 ~100 MB

Most of the memory is macOS CoreAnimation backing stores for the overlay windows — the process's own heap usage is under 20 MB.

Requirements

  • macOS 14.0+
  • Accessibility permissions (System Settings → Privacy & Security)
  • Screen Recording permissions

Building from source

cargo build --release
./target/release/edges

License

MIT

Acknowledgments

About

Active window edges for macOS

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages