{"id":15039563,"url":"https://github.com/felixkratz/sketchybar","last_synced_at":"2025-05-12T15:32:59.242Z","repository":{"id":38187533,"uuid":"395684015","full_name":"FelixKratz/SketchyBar","owner":"FelixKratz","description":"A highly customizable macOS status bar replacement","archived":false,"fork":false,"pushed_at":"2025-02-25T11:34:28.000Z","size":16383,"stargazers_count":8463,"open_issues_count":32,"forks_count":120,"subscribers_count":22,"default_branch":"master","last_synced_at":"2025-04-23T17:19:48.106Z","etag":null,"topics":["bar","customization","darwin","macos","ricing","shell-scripts","sketchybar","status","statusbar","tiling-window-manager","ui","yabai"],"latest_commit_sha":null,"homepage":"https://felixkratz.github.io/SketchyBar/","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.md","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},"funding":{"ko_fi":"felixkratz"}},"created_at":"2021-08-13T14:28:04.000Z","updated_at":"2025-04-23T10:00:02.000Z","dependencies_parsed_at":"2024-03-17T21:42:55.180Z","dependency_job_id":"7d2d2261-d220-49f7-b908-98b198bac8a0","html_url":"https://github.com/FelixKratz/SketchyBar","commit_stats":null,"previous_names":[],"tags_count":98,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FSketchyBar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FSketchyBar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FSketchyBar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FelixKratz%2FSketchyBar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FelixKratz","download_url":"https://codeload.github.com/FelixKratz/SketchyBar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253766101,"owners_count":21960844,"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":["bar","customization","darwin","macos","ricing","shell-scripts","sketchybar","status","statusbar","tiling-window-manager","ui","yabai"],"created_at":"2024-09-24T20:43:18.531Z","updated_at":"2025-05-12T15:32:59.218Z","avatar_url":"https://github.com/FelixKratz.png","language":"C","funding_links":["https://ko-fi.com/felixkratz"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/Sbar.svg\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://felixkratz.github.io/SketchyBar/setup\"\u003eInstall\u003c/a\u003e\n\u003cspan\u003e • \u003c/span\u003e\n\u003ca href=\"https://felixkratz.github.io/SketchyBar/config/bar\"\u003eDocumentation\u003c/a\u003e \n\u003cspan\u003e • \u003c/span\u003e \n\u003ca href=\"https://github.com/FelixKratz/SketchyBar/discussions/47?sort=top\"\u003eSetups\u003c/a\u003e\n\u003cspan\u003e • \u003c/span\u003e \n\u003ca href=\"https://github.com/FelixKratz/SketchyBar/discussions/12?sort=top\"\u003ePlugins\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://opensource.org/licenses/\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-GPL%20v3-blue.svg\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/FelixKratz/SketchyBar/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/FelixKratz/SketchyBar.svg?style=flat\u0026color=orange\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/FelixKratz/SketchyBar/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/commits-since/FelixKratz/SketchyBar/latest.svg?color=orange\"\u003e\u003c/a\u003e\n\u003ca href=\"https://en.wikipedia.org/wiki/Free_and_open-source_software\"\u003e\u003cimg src=\"https://img.shields.io/badge/FOSS-100%25-green.svg?style=flat\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\nThis bar project aims to create a highly flexible, customizable, fast and powerful status bar replacement for people that like playing with\nshell scripts.\n\u003c/p\u003e\n\n![](images/example.png)\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/FelixKratz/SketchyBar/discussions/47?sort=top\"\u003eMore Setups\u003c/a\u003e\n\u003c/p\u003e\n\n\n\n## Features\n* Full *configurability* at any time\n* Dynamic *animation* system\n* Powerful *scripting* and *event* system\n* Optimized to be *fast* and *efficient*\n* Interactive *mouse* support\n* Support for displaying macOS menu bar apps (*aliases*)\n* Can draw arbitrary *graphs*\n* On-demand *popup* menus\n\nThe main design principle of this project is that *all* elements of the bar can\nbe added, removed and freely changed at any point in time. Thus, the\nconfiguration of the bar is not *static*, rather it is possible to adapt the\nappearance of the bar completely dynamically with the help of a powerful\nevent-driven scripting system at any point in time using the highly\nconfigurable basic building blocks SketchyBar offers.\n\n## Getting Started\nRefer to the installation guide in the [documentation](https://felixkratz.github.io/SketchyBar/setup) to get the program set up.\nOnce this is sorted you can start to become familiar with the syntax of sketchybar by going through the default [*sketchybarrc*](https://github.com/FelixKratz/SketchyBar/blob/master/sketchybarrc) file and the default [*plugin scripts*](https://github.com/FelixKratz/SketchyBar/blob/master/plugins),\nwhich are located in `~/.config/sketchybar/` and look like this:\n\n![](images/default.png)\n\nAll commands and options are explained in detail in the relevant sections\nof the configuration [documentation](https://felixkratz.github.io/SketchyBar/config/bar). You can try the commands directly from\nthe commandline to see which affect they have and how they alter the bar. Once you have become familiar with the syntax you can\nlook for a config to start from [here](https://github.com/FelixKratz/SketchyBar/discussions/47?sort=top) or start from scratch and customize\neverything to your liking.\n\nYou might also enjoy looking at the [Tips \u0026 Tricks](https://felixkratz.github.io/SketchyBar/config/tricks) section\nfor some further tips on your journey. If you are searching for functional items you might want to check the\n[plugins](https://github.com/FelixKratz/SketchyBar/discussions/12?sort=top) section if someone has already created what you are looking for.\n\nShould you encounter things not working as you expect them to, please *do not* hesitate to open an [issue](https://github.com/FelixKratz/SketchyBar/issues), as\nthis is either a bug or a documentation problem and relevant in any case.\n\n## Documentation\nFor the full documentation of all commands and properties please refer to the [website](https://felixkratz.github.io/SketchyBar/config/bar).\n\nIf questions remain, feel free to consult the [Q\u0026A](https://github.com/FelixKratz/SketchyBar/discussions/categories/q-a) section.\n\n## Supporting\n*You* can support this project is many ways:\n- By *creating* issues and pull-requests if you encounter problems\n- By *sharing* your [plugins](https://github.com/FelixKratz/SketchyBar/discussions/12) and [setups](https://github.com/FelixKratz/SketchyBar/discussions/47)\n- By *starring* the project on GitHub\n- If this project has value to you, consider quantifying it and *donating* to a charity of your choice. If you want to let me know about your donation, you\ncan contact me via [email](mailto:felix.kratz@tu-dortmund.de?Subject=Donation).\n- If you want to support me directly, you can do so via [ko-fi](https://ko-fi.com/felixkratz)\n\n## Credits\nThis project was forked from *[spacebar](https://github.com/cmacrae/spacebar)* and completely reimagined and rewritten. \u003cbr\u003e\nThe original idea is based on the status bar that was included in *[yabai](https://github.com/koekeishiya/yabai)* before getting removed.\n\n\n## Related Projects\n- [SbarLua](https://github.com/FelixKratz/SbarLua): A Lua API for SketchyBar\n- [sketchybar-app-font](https://github.com/kvndrsslr/sketchybar-app-font): A symbol font for SketchyBar\n- [SketchyBarHelper](https://github.com/FelixKratz/SketchyBarHelper): A header for C/C++ to directly communicate with SketchyBar\n\n## Some animation examples\n\nhttps://user-images.githubusercontent.com/22680421/211198711-45318f04-e96f-4aa1-a0ba-c7f30f050902.mp4\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixkratz%2Fsketchybar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelixkratz%2Fsketchybar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixkratz%2Fsketchybar/lists"}