window-sweaters README

The project's README from github.com/saragordic/window-sweaters. As one markdown file: README.md.

Window Sweaters

A little Mac app I made to give my windows sweaters. 🧶 Knitted borders, colours inspired by your favourite apps, and a cosier desktop.

Four overlapping windows edged with knitted borders in green, blue and rust colourways

Get it

You can just send this repo to your coding agent and ask it to install Window Sweaters for you:

Install Window Sweaters on my Mac: https://github.com/saragordic/window-sweaters

Or install it yourself with Homebrew:

brew trust saragordic/tap
brew install --cask saragordic/tap/window-sweaters

Then open Window Sweaters from your Applications folder.

You can also grab the latest ZIP from Releases, unzip it, and drag Window Sweaters.app into Applications.

If macOS blocks it, open System Settings → Privacy & Security → Open Anyway after trying to launch it. The app isn't notarized by Apple yet. Apple's instructions explain this step.

Make yourself cosy

Click the yarn icon in your menu bar to change the style, pattern, border width, and stitch size. You can also pause the sweaters or quit from there.

To leave an app bare, open Apps and untick it. Its windows lose their sweater straight away, everything else stays as it is, and it stays off until you tick it again, even after a restart. Only want sweaters on a few apps? Choose Turn Off for All Apps, then tick the ones you like. Apps you open later start off too.

By App gives each app its own sweater. Zigzag gives them all a softer, matching cream zigzag in colours taken from their icons. Try both and see what you like.

If macOS asks for Accessibility access, enable Window Sweaters in System Settings → Privacy & Security → Accessibility so it can follow which window is focused.

The sweaters

Custom sweaters for 37 apps, and counting! Almost 40 little colourways, with colours picked by hand. These are just a few of my favourites:

Eight apps shown in By App and Zigzag styles, with enlarged yarn details

Shown above in By App and Zigzag. Here’s everyone we’ve knitted for so far:

See every sweater and its close-up stitches in the catalogue, or download the By App PDF.

The 37 custom sweaters keep their hand-picked colours and patterns. Other apps borrow colours from their own icons, softened into yarn, and get a two-colour zigzag, picnic or twinkle sweater in By App mode. The pattern stays the same for each app. If an icon has no usable colour, the app keeps a stable colour chosen from its name.

Icons are sampled locally in the background when needed. While the colour is being prepared, the border uses its usual fallback. Zigzag uses icon colours for every app, the 37 custom ones included, with a cream zigzag, or a deeper shade of the app’s colour on pale apps. Colours you set in apps.conf always win. Other shared patterns keep their own contrast yarns, with each app’s own base colour.

A little work in progress

I built this on my Mac and use it myself, but there are still rough edges. Borders hide while you resize a window and return when you're done.

The app is built for macOS 13 or later, on Apple Silicon and Intel. I've tested it on Apple Silicon with macOS 26; older macOS versions and Intel Macs haven't had the same hands-on testing. It uses private macOS window APIs, so system updates may affect how it works.

If something looks wrong, open an issue and tell me your macOS version, Mac model, and whether you're using another screen. Reproduction steps help a lot.

Build it yourself

You'll need Apple's Command Line Tools (xcode-select --install) and Python 3.

git clone https://github.com/saragordic/window-sweaters.git
cd window-sweaters
./scripts/build-app.sh
python3 scripts/install-local.py

This builds outputs/Window Sweaters.app, installs it in ~/Applications, and opens it. The installer backs up any previous local installation before replacing it.

Your own colourways

If you'd like to experiment, edit these files and restart the app:

~/Library/Application Support/Knit Borders/apps.conf
~/Library/Application Support/Knit Borders/charts/

The folder still uses the app's original name so existing settings keep working. For example, an app rule looks like this:

Claude = #D58561 atelier-claude

Names match app-name prefixes, ignoring capitalisation; the longest match wins. You can also put your own PNG charts in the charts folder to replace built-in patterns.

If you like setting things up from the command line, Window Sweaters also runs an optional shell script at startup, if you have one at ~/.config/window-sweaters/sweatersrc or ~/.sweatersrc.

Taking it off

Quit Window Sweaters from the yarn icon first. Then, if you installed it with Homebrew:

brew uninstall --zap --cask window-sweaters

--zap also removes your saved colourways. Leave it off to keep them for later.

If you installed it by hand, drag Window Sweaters.app to the Trash, then delete these if you want everything gone:

~/Library/Application Support/Knit Borders
~/Library/Preferences/local.knitborders.app.plist

macOS remembers the Accessibility permission separately, so remove Window Sweaters from System Settings → Privacy & Security → Accessibility too.

Contributing

make test       # run the tests
make catalogue  # render the sweater collection
make bench     # benchmark the renderer

See CONTRIBUTING.md for more details.

Credits and license

Built on JankyBorders by Felix Kratz, with thanks. Released under GPL-3.0. See NOTICE.md for attribution.

window-sweaters (saragordic/window-sweaters)

Searching Database…

803 ·GitHub
Window-sweaters
What is this?Window Sweaters is a playful macOS menu-bar app that wraps your app windows in knitted sweater borders, with colours inspired by your favourite apps.
Is it a normal app I install, or does it modify macOS somehow?It's a normal menu-bar app with a yarn icon for all settings. Under the hood it draws borders around windows using private macOS window APIs, and it's built on JankyBorders, so macOS updates may occasionally affect it.
How do I get it on my Mac?Ask your coding agent to install it from this repo, install it yourself with Homebrew, or grab the latest ZIP from Releases and drag Window Sweaters.app into Applications. Then just open it from your Applications folder.
Will macOS let it run right away?Not always: the app isn't notarized by Apple yet, so macOS may block the first launch — approve it via System Settings → Privacy & Security → Open Anyway. It also asks for Accessibility permission so it can follow which window is focused.
Will it run on my Mac?It needs macOS 13 or later and runs on both Apple Silicon and Intel. Only Apple Silicon on macOS 26 has been hands-on tested, so Intel and older macOS versions are less proven.
Does it send anything of mine anywhere?Nothing in the README suggests network use: app icons are sampled locally in the background to pick yarn colours, and colours you set yourself in apps.conf always win.
Which apps come with ready-made sweaters?37 apps so far: Apple's Finder, Safari, Mail, Messages, Notes, Calendar, Terminal and more; work tools like Notion, Slack, Zoom and Teams; coding and AI apps like Cursor, VS Code, Claude, ChatGPT, Codex and Ghostty; design tools Figma, Photoshop and Illustrator; Office apps; plus Spotify, Chrome, Firefox, Telegram, WhatsApp and Discord.
Can I design my own colourways?Yes — edit the app's config to set per-app colours (rules match app-name prefixes and the longest match wins) and drop your own PNG knitting charts into the charts folder to replace built-in patterns. There's also an optional startup shell script at ~/.config/window-sweaters/sweatersrc or ~/.sweatersrc.
What is it built on, and how is it licensed?It's built on JankyBorders by Felix Kratz and released under GPL-3.0, with attribution in NOTICE.md. The author made it for their own Mac and shares it as a small open-source project.
What are similar projects?BetterDisplay, rooms, pliss, Sapphire, Ice, OpenYoink, Doll, boring.notch
Which topics is it in?window-management, menubar-app, fun, menubar, mac, objective-c, accessibility, macos-app, homebrew, app, c, customization
Creator
saragordic
Size
40.8 MB
Stars
803
Updated
CommitSep 21Releasev1.5.0Sep 18
Age
1mo
Commits · 90 Days