{"id":27635076,"url":"https://github.com/felixkratz/jankyborders","last_synced_at":"2025-05-14T13:04:40.374Z","repository":{"id":205129669,"uuid":"713490206","full_name":"FelixKratz/JankyBorders","owner":"FelixKratz","description":"A lightweight window border system for macOS","archived":false,"fork":false,"pushed_at":"2024-12-17T14:13:55.000Z","size":3330,"stargazers_count":2026,"open_issues_count":40,"forks_count":35,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-04-23T19:50:10.900Z","etag":null,"topics":["border","customization","fast","lightweight","macos","tiling-window-manager","window-border","yabai"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FelixKratz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"ko_fi":"felixkratz"}},"created_at":"2023-11-02T16:14:50.000Z","updated_at":"2025-04-23T12:09:35.000Z","dependencies_parsed_at":"2023-11-19T14:28:32.175Z","dependency_job_id":"57c42395-ba81-430a-a43e-286191688f0b","html_url":"https://github.com/FelixKratz/JankyBorders","commit_stats":{"total_commits":85,"total_committers":3,"mean_commits":"28.333333333333332","dds":0.04705882352941182,"last_synced_commit":"abc416b077bd9e54d110d6d438218a6bff0f8ea7"},"previous_names":["felixkratz/jankyborders"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FJankyBorders","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FJankyBorders/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FJankyBorders/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FJankyBorders/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FelixKratz","download_url":"https://codeload.github.com/FelixKratz/JankyBorders/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149877,"owners_count":22022851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["border","customization","fast","lightweight","macos","tiling-window-manager","window-border","yabai"],"created_at":"2025-04-23T19:43:07.272Z","updated_at":"2025-05-14T13:04:40.300Z","avatar_url":"https://github.com/FelixKratz.png","language":"C","funding_links":["https://ko-fi.com/felixkratz"],"categories":[],"sub_categories":[],"readme":"# JankyBorders\n\n\u003cimg align=\"right\" width=\"50%\" src=\"images/screenshot.png\" alt=\"Screenshot\"\u003e\n\n*JankyBorders* is a lightweight tool designed to add colored borders to\nuser windows on macOS 14.0+. It enhances the user experience by visually\nhighlighting the currently focused window without relying on the accessibility\nAPI, thereby being faster than comparable tools.\n\n## Usage\n### Install\nThe binary can be made available by installing it through Homebrew:\n```bash\nbrew tap FelixKratz/formulae\nbrew install borders\n```\n\nFor a comprehensive overview of all available options and commands, consult the\nman page: `man borders`. A rendered version of the man page is available in the\n[Wiki](https://github.com/FelixKratz/JankyBorders/wiki/Man-Page).\n\n### Bootstrap with yabai\nFor example, if you are using `yabai`, you could add:\n```bash\nborders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0 \u0026\n```\nto the very end of your `yabairc`. This will start the borders with the\nspecified options along with yabai.\n\n### Bootstrap with AeroSpace\nYou could add:\n```toml\nafter-startup-command = [\n  'exec-and-forget borders active_color=0xffe1e3e4 inactive_color=0xff494d64 width=5.0'\n]\n```\nto you `aerospace.toml`. This will start borders with the specified options\nalong with AeroSpace.\n\n### Bootstrap with brew\nIf you want to run this as a separate service, you could use:\n```bash\nbrew services start borders\n```\n\n### Configuring the appearance\nYou can either configure the appearance directly when starting the borders\nprocess (as shown in \"Bootstrap with yabai\") or use a configuration file.\nThe appearance can be adapted at any point in time.\n\n#### Using a configuration file (Optional)\nIf the primary `borders` process is started without any arguments (or launched\nas a service by brew), it will search for a file at\n`~/.config/borders/bordersrc` and execute it on launch if found.\n\nAn example configuration file could look like this:\n`~/.config/borders/bordersrc`\n```bash\n#!/bin/bash\n\noptions=(\n\tstyle=round\n\twidth=6.0\n\thidpi=off\n\tactive_color=0xffe2e2e3\n\tinactive_color=0xff414550\n)\n\nborders \"${options[@]}\"\n```\n\n#### Updating the border properties during runtime\nIf a `borders` process is already running, invoking a new `borders` instance\nwith any combination of the available options will update the properties of\nthe already running instance.\n\n## Documentation\nLocal documentation is available as `man borders` and as a rendered version in\nthe [Wiki](https://github.com/FelixKratz/JankyBorders/wiki/Man-Page).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixkratz%2Fjankyborders","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelixkratz%2Fjankyborders","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixkratz%2Fjankyborders/lists"}