From 6aad7838f7c4f68cae89eb831c8926a11b43f8eb Mon Sep 17 00:00:00 2001 From: Felix Kratz Date: Wed, 15 Jun 2022 22:54:43 +0200 Subject: [PATCH] fix up docs for 2.7.0 --- 404.html | 8 ++--- ...5ec0b.796aec39.js => 1a25ec0b.76fad0a9.js} | 2 +- ...b3326.69140aaf.js => 1e567163.b44eb5fd.js} | 2 +- ...f8bbe.1cc5fa2c.js => 22ff8bbe.a93c44e6.js} | 2 +- assets/js/2c8facf9.086bd6b2.js | 1 - assets/js/2c8facf9.cb051c16.js | 1 + assets/js/37f332e7.8d8fd410.js | 1 - assets/js/37f332e7.f2ce1d5e.js | 1 + ...7b3ea.85e9fd66.js => 3847b3ea.dd7b3621.js} | 2 +- assets/js/4ee9b86f.619883c0.js | 1 + assets/js/4ee9b86f.be07cac0.js | 1 - assets/js/73510e92.5d2f9eb6.js | 1 - assets/js/73510e92.83a6f9fa.js | 1 + ...0a585.a13f955c.js => 8a2af467.89c0722f.js} | 2 +- assets/js/935f2afb.423cc590.js | 1 + assets/js/935f2afb.d52d55eb.js | 1 - assets/js/9392bc75.71d2d47a.js | 1 + assets/js/9392bc75.fea2e67f.js | 1 - assets/js/db7c2498.25eec24b.js | 1 + assets/js/db7c2498.b5e9c31a.js | 1 - assets/js/dc9b5e88.68935aac.js | 1 - assets/js/dc9b5e88.c27c6a54.js | 1 + assets/js/f4bf9ed0.1ead9b6a.js | 1 + assets/js/f4bf9ed0.b4a6fe5c.js | 1 - assets/js/main.57bc4bb7.js | 2 ++ ...CENSE.txt => main.57bc4bb7.js.LICENSE.txt} | 0 assets/js/main.ed487d95.js | 2 -- assets/js/runtime~main.3cddce57.js | 1 + assets/js/runtime~main.62b88c98.js | 1 - config/animations.html | 15 ++++---- config/bar.html | 23 +++++++------ config/components.html | 34 +++++++++++++------ config/events.html | 22 ++++++------ config/items.html | 18 +++++----- config/popups.html | 12 +++---- config/querying.html | 10 +++--- config/tricks.html | 23 +++++++------ config/types.html | 10 +++--- credits.html | 8 ++--- features.html | 8 ++--- index.html | 8 ++--- picker.html | 8 ++--- setup.html | 8 ++--- 43 files changed, 132 insertions(+), 117 deletions(-) rename assets/js/{1a25ec0b.796aec39.js => 1a25ec0b.76fad0a9.js} (97%) rename assets/js/{eecb3326.69140aaf.js => 1e567163.b44eb5fd.js} (60%) rename assets/js/{22ff8bbe.1cc5fa2c.js => 22ff8bbe.a93c44e6.js} (56%) delete mode 100644 assets/js/2c8facf9.086bd6b2.js create mode 100644 assets/js/2c8facf9.cb051c16.js delete mode 100644 assets/js/37f332e7.8d8fd410.js create mode 100644 assets/js/37f332e7.f2ce1d5e.js rename assets/js/{3847b3ea.85e9fd66.js => 3847b3ea.dd7b3621.js} (98%) create mode 100644 assets/js/4ee9b86f.619883c0.js delete mode 100644 assets/js/4ee9b86f.be07cac0.js delete mode 100644 assets/js/73510e92.5d2f9eb6.js create mode 100644 assets/js/73510e92.83a6f9fa.js rename assets/js/{1910a585.a13f955c.js => 8a2af467.89c0722f.js} (60%) create mode 100644 assets/js/935f2afb.423cc590.js delete mode 100644 assets/js/935f2afb.d52d55eb.js create mode 100644 assets/js/9392bc75.71d2d47a.js delete mode 100644 assets/js/9392bc75.fea2e67f.js create mode 100644 assets/js/db7c2498.25eec24b.js delete mode 100644 assets/js/db7c2498.b5e9c31a.js delete mode 100644 assets/js/dc9b5e88.68935aac.js create mode 100644 assets/js/dc9b5e88.c27c6a54.js create mode 100644 assets/js/f4bf9ed0.1ead9b6a.js delete mode 100644 assets/js/f4bf9ed0.b4a6fe5c.js create mode 100644 assets/js/main.57bc4bb7.js rename assets/js/{main.ed487d95.js.LICENSE.txt => main.57bc4bb7.js.LICENSE.txt} (100%) delete mode 100644 assets/js/main.ed487d95.js create mode 100644 assets/js/runtime~main.3cddce57.js delete mode 100644 assets/js/runtime~main.62b88c98.js diff --git a/404.html b/404.html index dceab68..5a133ce 100644 --- a/404.html +++ b/404.html @@ -5,13 +5,13 @@ Page Not Found | SketchyBar - - + +
Skip to main content

Page Not Found

We could not find what you were looking for.

Please contact the owner of the site that linked you to the original URL and let them know their link is broken.

- - + + \ No newline at end of file diff --git a/assets/js/1a25ec0b.796aec39.js b/assets/js/1a25ec0b.76fad0a9.js similarity index 97% rename from assets/js/1a25ec0b.796aec39.js rename to assets/js/1a25ec0b.76fad0a9.js index dc1c3fb..86135fc 100644 --- a/assets/js/1a25ec0b.796aec39.js +++ b/assets/js/1a25ec0b.76fad0a9.js @@ -1 +1 @@ -"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[19],{3905:function(e,t,n){n.d(t,{Zo:function(){return c},kt:function(){return f}});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=r.createContext({}),l=function(e){var t=r.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},c=function(e){var t=l(e.components);return r.createElement(p.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,p=e.parentName,c=s(e,["components","mdxType","originalType","parentName"]),m=l(n),f=a,d=m["".concat(p,".").concat(f)]||m[f]||u[f]||i;return n?r.createElement(d,o(o({ref:t},c),{},{components:n})):r.createElement(d,o({ref:t},c))}));function f(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var s={};for(var p in t)hasOwnProperty.call(t,p)&&(s[p]=t[p]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var l=2;l=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var p=r.createContext({}),l=function(e){var t=r.useContext(p),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},c=function(e){var t=l(e.components);return r.createElement(p.Provider,{value:t},e.children)},u={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},m=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,p=e.parentName,c=s(e,["components","mdxType","originalType","parentName"]),m=l(n),f=a,d=m["".concat(p,".").concat(f)]||m[f]||u[f]||i;return n?r.createElement(d,o(o({ref:t},c),{},{components:n})):r.createElement(d,o({ref:t},c))}));function f(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=m;var s={};for(var p in t)hasOwnProperty.call(t,p)&&(s[p]=t[p]);s.originalType=e,s.mdxType="string"==typeof e?e:a,o[1]=s;for(var l=2;l=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=n.createContext({}),c=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},l=function(e){var t=c(e.components);return n.createElement(s.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,i=e.originalType,s=e.parentName,l=u(e,["components","mdxType","originalType","parentName"]),f=c(r),m=a,y=f["".concat(s,".").concat(m)]||f[m]||p[m]||i;return r?n.createElement(y,o(o({ref:t},l),{},{components:r})):n.createElement(y,o({ref:t},l))}));function m(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=r.length,o=new Array(i);o[0]=f;var u={};for(var s in t)hasOwnProperty.call(t,s)&&(u[s]=t[s]);u.originalType=e,u.mdxType="string"==typeof e?e:a,o[1]=u;for(var c=2;c\n")),(0,i.kt)("p",null,"The output is a json structure containing relevant information about the configuration of the item."),(0,i.kt)("h3",{id:"default-properties"},"Default Properties"),(0,i.kt)("p",null,"Information about the current defaults."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --query defaults\n")),(0,i.kt)("h3",{id:"event-properties"},"Event Properties"),(0,i.kt)("p",null,"Information about the events."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --query events\n")),(0,i.kt)("h3",{id:"macos-menu-bar-item-names-for-use-with-aliases"},"macOS Menu Bar Item Names (for use with aliases)"),(0,i.kt)("p",null,"The names of the menu bar items in the default macOS bar:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --query default_menu_items\n")))}m.isMDXComponent=!0}}]); \ No newline at end of file +"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[233],{3905:function(e,t,r){r.d(t,{Zo:function(){return l},kt:function(){return m}});var n=r(7294);function a(e,t,r){return t in e?Object.defineProperty(e,t,{value:r,enumerable:!0,configurable:!0,writable:!0}):e[t]=r,e}function i(e,t){var r=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),r.push.apply(r,n)}return r}function o(e){for(var t=1;t=0||(a[r]=e[r]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,r)&&(a[r]=e[r])}return a}var s=n.createContext({}),c=function(e){var t=n.useContext(s),r=t;return e&&(r="function"==typeof e?e(t):o(o({},t),e)),r},l=function(e){var t=c(e.components);return n.createElement(s.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},f=n.forwardRef((function(e,t){var r=e.components,a=e.mdxType,i=e.originalType,s=e.parentName,l=u(e,["components","mdxType","originalType","parentName"]),f=c(r),m=a,y=f["".concat(s,".").concat(m)]||f[m]||p[m]||i;return r?n.createElement(y,o(o({ref:t},l),{},{components:r})):n.createElement(y,o({ref:t},l))}));function m(e,t){var r=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=r.length,o=new Array(i);o[0]=f;var u={};for(var s in t)hasOwnProperty.call(t,s)&&(u[s]=t[s]);u.originalType=e,u.mdxType="string"==typeof e?e:a,o[1]=u;for(var c=2;c\n")),(0,i.kt)("p",null,"The output is a JSON structure containing relevant information about the configuration of the item."),(0,i.kt)("h3",{id:"default-properties"},"Default Properties"),(0,i.kt)("p",null,"Information about the current defaults."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --query defaults\n")),(0,i.kt)("h3",{id:"event-properties"},"Event Properties"),(0,i.kt)("p",null,"Information about the events."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --query events\n")),(0,i.kt)("h3",{id:"macos-menu-bar-item-names-for-use-with-aliases"},"macOS Menu Bar Item Names (for use with aliases)"),(0,i.kt)("p",null,"The names of the menu bar items in the default macOS bar:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --query default_menu_items\n")))}m.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/2c8facf9.086bd6b2.js b/assets/js/2c8facf9.086bd6b2.js deleted file mode 100644 index 8b1d0aa..0000000 --- a/assets/js/2c8facf9.086bd6b2.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[958],{3905:function(t,e,n){n.d(e,{Zo:function(){return m},kt:function(){return N}});var r=n(7294);function a(t,e,n){return e in t?Object.defineProperty(t,e,{value:n,enumerable:!0,configurable:!0,writable:!0}):t[e]=n,t}function i(t,e){var n=Object.keys(t);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(t);e&&(r=r.filter((function(e){return Object.getOwnPropertyDescriptor(t,e).enumerable}))),n.push.apply(n,r)}return n}function o(t){for(var e=1;e=0||(a[n]=t[n]);return a}(t,e);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(t);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(t,n)&&(a[n]=t[n])}return a}var d=r.createContext({}),p=function(t){var e=r.useContext(d),n=e;return t&&(n="function"==typeof t?t(e):o(o({},e),t)),n},m=function(t){var e=p(t.components);return r.createElement(d.Provider,{value:e},t.children)},c={inlineCode:"code",wrapper:function(t){var e=t.children;return r.createElement(r.Fragment,{},e)}},k=r.forwardRef((function(t,e){var n=t.components,a=t.mdxType,i=t.originalType,d=t.parentName,m=l(t,["components","mdxType","originalType","parentName"]),k=p(n),N=a,g=k["".concat(d,".").concat(N)]||k[N]||c[N]||i;return n?r.createElement(g,o(o({ref:e},m),{},{components:n})):r.createElement(g,o({ref:e},m))}));function N(t,e){var n=arguments,a=e&&e.mdxType;if("string"==typeof t||a){var i=n.length,o=new Array(i);o[0]=k;var l={};for(var d in e)hasOwnProperty.call(e,d)&&(l[d]=e[d]);l.originalType=t,l.mdxType="string"==typeof t?t:a,o[1]=l;for(var p=2;p= ... =\n")),(0,i.kt)("p",null,"where possible settings are:"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0x44000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xffff0000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the bars border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"position")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"top"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"bottom")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"top")),(0,i.kt)("td",{parentName:"tr",align:null},"Position of the bar on the screen")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"height")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"25")),(0,i.kt)("td",{parentName:"tr",align:null},"Height of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"margin")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Margin around the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset of the bar from its default position")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"corner_radius")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Corner radius of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Border width of the bars border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"blur_radius")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Blur radius applied to the background of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_left")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding between the left bar border and the leftmost item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding between the right bar border and the rightmost item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"notch_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"200")),(0,i.kt)("td",{parentName:"tr",align:null},"The width of the notch to be accounted for on the internal display")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"notch_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Additional ",(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")," exclusively applied to notched screens (Only on HEAD)")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"display")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"main"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"all")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"all")),(0,i.kt)("td",{parentName:"tr",align:null},"Display to show the bar on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"hidden")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"current")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If all / the current bar is hidden")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"topmost")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the bar should be drawn on top of ",(0,i.kt)("inlineCode",{parentName:"td"},"everything"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"font_smoothing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If fonts should be smoothened")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"shadow")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the bar should draw a shadow")))))}N.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/2c8facf9.cb051c16.js b/assets/js/2c8facf9.cb051c16.js new file mode 100644 index 0000000..29b5b1b --- /dev/null +++ b/assets/js/2c8facf9.cb051c16.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[958],{3905:function(e,t,n){n.d(t,{Zo:function(){return m},kt:function(){return N}});var r=n(7294);function a(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);t&&(r=r.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,r)}return n}function o(e){for(var t=1;t=0||(a[n]=e[n]);return a}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(r=0;r=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(a[n]=e[n])}return a}var d=r.createContext({}),p=function(e){var t=r.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):o(o({},t),e)),n},m=function(e){var t=p(e.components);return r.createElement(d.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return r.createElement(r.Fragment,{},t)}},k=r.forwardRef((function(e,t){var n=e.components,a=e.mdxType,i=e.originalType,d=e.parentName,m=l(e,["components","mdxType","originalType","parentName"]),k=p(n),N=a,g=k["".concat(d,".").concat(N)]||k[N]||c[N]||i;return n?r.createElement(g,o(o({ref:t},m),{},{components:n})):r.createElement(g,o({ref:t},m))}));function N(e,t){var n=arguments,a=t&&t.mdxType;if("string"==typeof e||a){var i=n.length,o=new Array(i);o[0]=k;var l={};for(var d in t)hasOwnProperty.call(t,d)&&(l[d]=t[d]);l.originalType=e,l.mdxType="string"==typeof e?e:a,o[1]=l;for(var p=2;p= ... =\n")),(0,i.kt)("p",null,"where possible settings are:"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0x44000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xffff0000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the bars border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"position")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"top"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"bottom")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"top")),(0,i.kt)("td",{parentName:"tr",align:null},"Position of the bar on the screen")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"height")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"25")),(0,i.kt)("td",{parentName:"tr",align:null},"Height of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"margin")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Margin around the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset of the bar from its default position")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"corner_radius")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Corner radius of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Border width of the bars border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"blur_radius")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Blur radius applied to the background of the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_left")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding between the left bar border and the leftmost item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding between the right bar border and the rightmost item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"notch_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"200")),(0,i.kt)("td",{parentName:"tr",align:null},"The width of the notch to be accounted for on the internal display")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"notch_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Additional ",(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")," exclusively applied to notched screens")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"display")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"main"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"all")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"all")),(0,i.kt)("td",{parentName:"tr",align:null},"Display to show the bar on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"hidden")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"current")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If all / the current bar is hidden")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"topmost")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the bar should be drawn on top of ",(0,i.kt)("inlineCode",{parentName:"td"},"everything"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"font_smoothing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If fonts should be smoothened")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"shadow")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the bar should draw a shadow")))),(0,i.kt)("p",null,"You can find the nomenclature for all the types ",(0,i.kt)("a",{parentName:"p",href:"https://felixkratz.github.io/SketchyBar/config/types"},"here"),".\nIf you are looking for colors, check out the ",(0,i.kt)("a",{parentName:"p",href:"https://felixkratz.github.io/SketchyBar/config/tricks#color-picker"},"color picker"),"."))}N.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/37f332e7.8d8fd410.js b/assets/js/37f332e7.8d8fd410.js deleted file mode 100644 index 5ca00be..0000000 --- a/assets/js/37f332e7.8d8fd410.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[785],{3905:function(e,t,n){n.d(t,{Zo:function(){return m},kt:function(){return c}});var a=n(7294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var d=a.createContext({}),o=function(e){var t=a.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):l(l({},t),e)),n},m=function(e){var t=o(e.components);return a.createElement(d.Provider,{value:t},e.children)},k={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},N=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,d=e.parentName,m=p(e,["components","mdxType","originalType","parentName"]),N=o(n),c=r,g=N["".concat(d,".").concat(c)]||N[c]||k[c]||i;return n?a.createElement(g,l(l({ref:t},m),{},{components:n})):a.createElement(g,l({ref:t},m))}));function c(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,l=new Array(i);l[0]=N;var p={};for(var d in t)hasOwnProperty.call(t,d)&&(p[d]=t[d]);p.originalType=e,p.mdxType="string"==typeof e?e:r,l[1]=p;for(var o=2;o \n")),(0,i.kt)("p",null,"where the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," should not contain whitespaces (or must be quoted), it can be used to further configure the item.\nThe ",(0,i.kt)("inlineCode",{parentName:"p"},"")," is the placement in the bar and can be either ",(0,i.kt)("em",{parentName:"p"},"left"),", ",(0,i.kt)("em",{parentName:"p"},"right")," or ",(0,i.kt)("em",{parentName:"p"},"center"),". The items will appear in the bar in the order\nin which they are added, but can be moved later on."),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"th"},"")))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"center"),", (",(0,i.kt)("inlineCode",{parentName:"td"},"q"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"e")," ",(0,i.kt)("a",{parentName:"td",href:"https://github.com/FelixKratz/SketchyBar/issues/120"},"#120"),")")))),(0,i.kt)("h3",{id:"changing-item-properties"},"Changing item properties"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --set = ... =\n")),(0,i.kt)("p",null,"where the ",(0,i.kt)("em",{parentName:"p"},"name")," is used to target the item with this name.\n(The ",(0,i.kt)("em",{parentName:"p"},"name")," can be a regular expression inside of two '/': ",(0,i.kt)("em",{parentName:"p"},"/\\","/"),")"),(0,i.kt)("p",null,"A list of properties available to the ",(0,i.kt)("em",{parentName:"p"},"set")," command is listed below (components might have additional properties, see the respective component section for them):"),(0,i.kt)("h3",{id:"geometry-properties"},"Geometry Properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"position")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"center")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Position of the item in the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"associated_space")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Spaces to show this item on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"associated_display")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Displays to show this item on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"ignore_association")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"Ignores all space / display associations while on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset applied to the item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")," or ",(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:null},"Makes the ",(0,i.kt)("em",{parentName:"td"},"item")," use a fixed ",(0,i.kt)("em",{parentName:"td"},"width")," given in points")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"align")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"center"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"left")),(0,i.kt)("td",{parentName:"tr",align:null},"Aligns the ",(0,i.kt)("inlineCode",{parentName:"td"},"item")," content in its container when it has a fixed ",(0,i.kt)("inlineCode",{parentName:"td"},"width")," larger than the content width")))),(0,i.kt)("h3",{id:"drawing-properties"},"Drawing properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"on")),(0,i.kt)("td",{parentName:"tr",align:null},"If the item should be drawn into the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"lazy")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"Changes do not trigger a redraw of the bar, item is refreshed when the bar is redrawn anyways")))),(0,i.kt)("h3",{id:"icon-properties"},"Icon properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"icon")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Icon of the item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"icon.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Icons support all ",(0,i.kt)("em",{parentName:"td"},"text")," properties")))),(0,i.kt)("h3",{id:"label-properties"},"Label properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"label")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Label of the item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"label.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Labels support all ",(0,i.kt)("em",{parentName:"td"},"text")," properties")))),(0,i.kt)("h3",{id:"scripting-properties"},"Scripting properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"script")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Script to run on an ",(0,i.kt)("inlineCode",{parentName:"td"},"event"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"click_script")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Script to run on a mouse click (Difference to ",(0,i.kt)("inlineCode",{parentName:"td"},"mouse.clicked")," event: ",(0,i.kt)("a",{parentName:"td",href:"https://github.com/FelixKratz/SketchyBar/discussions/109"},"#109"),")")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"update_freq")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"1")),(0,i.kt)("td",{parentName:"tr",align:null},"Time in seconds between routine script executions")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"updates")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"when_shown")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"on")),(0,i.kt)("td",{parentName:"tr",align:null},"If and when the item updates e.g. via script execution")))),(0,i.kt)("h3",{id:"text-properties"},"Text properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"on")),(0,i.kt)("td",{parentName:"tr",align:null},"If the text is rendered")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"highlight")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the text uses the ",(0,i.kt)("inlineCode",{parentName:"td"},"highlight_color")," or the regular ",(0,i.kt)("inlineCode",{parentName:"td"},"color"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xffffffff")),(0,i.kt)("td",{parentName:"tr",align:null},"Color used to render the text")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"highlight_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xff000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Highlight color of the text (e.g. for active space icon")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_left")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the left of the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the right of the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset applied to the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"font")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"::")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"Hack Nerd Font:Bold:14.0")),(0,i.kt)("td",{parentName:"tr",align:null},"The font to be used for the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")," or ",(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:null},"Makes the ",(0,i.kt)("inlineCode",{parentName:"td"},"text")," use a fixed ",(0,i.kt)("inlineCode",{parentName:"td"},"width")," given in points")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"align")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"center"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"left")),(0,i.kt)("td",{parentName:"tr",align:null},"Aligns the ",(0,i.kt)("inlineCode",{parentName:"td"},"text")," in its container when it has a fixed ",(0,i.kt)("inlineCode",{parentName:"td"},"width")," larger than the content width")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"background.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Texts support all ",(0,i.kt)("inlineCode",{parentName:"td"},"background")," properties")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"shadow.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Texts support all ",(0,i.kt)("inlineCode",{parentName:"td"},"shadow")," properties")))),(0,i.kt)("h3",{id:"background-properties"},"Background properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the ",(0,i.kt)("inlineCode",{parentName:"td"},"background")," should be rendered")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0x00000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Fill color of the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0x00000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the backgrounds border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Width of the background border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"height")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Overrides the ",(0,i.kt)("inlineCode",{parentName:"td"},"height")," of the background")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"corner_radius")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Corner radius of the background")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_left")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the left of the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the right of the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset applied to the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"image")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"The path to a png or jpeg image file")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"image.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Backgrounds support all ",(0,i.kt)("inlineCode",{parentName:"td"},"image")," properties")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"shadow.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Backgrounds support all ",(0,i.kt)("inlineCode",{parentName:"td"},"shadow")," properties")))),(0,i.kt)("h3",{id:"image-properties"},"Image properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the image should draw")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"scale")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"The scale factor that should be applied to the image")))),(0,i.kt)("h3",{id:"shadow-properties"},"Shadow properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the shadow should be drawn")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xff000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the shadow")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"angle")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"30")),(0,i.kt)("td",{parentName:"tr",align:null},"Angle of the shadow")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"distance")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"5")),(0,i.kt)("td",{parentName:"tr",align:null},"Distance of the shadow")))),(0,i.kt)("h3",{id:"changing-the-default-values-for-all-further-items"},"Changing the default values for all further items"),(0,i.kt)("p",null,"It is possible to change the ",(0,i.kt)("em",{parentName:"p"},"defaults")," at every point in the configuration. All item created ",(0,i.kt)("em",{parentName:"p"},"after")," changing the defaults will\ninherit these properties from the default item."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --default = ... =\n")),(0,i.kt)("p",null,"this works for all item properties."),(0,i.kt)("h3",{id:"item-reordering"},"Item Reordering"),(0,i.kt)("p",null,"It is possible to reorder items by invoking"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --reorder ... \n")),(0,i.kt)("p",null,"where a new order can be supplied for arbitrary items. Only the specified items get reordered, by swapping them around, everything else stays the same. E.g. if you want to swap two items\nsimply call"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --reorder \n")),(0,i.kt)("h3",{id:"moving-items-to-specific-positions"},"Moving Items to specific positions"),(0,i.kt)("p",null,"It is possible to move items and order them next to a reference item."),(0,i.kt)("p",null,"Move Item ",(0,i.kt)("inlineCode",{parentName:"p"},"")," to appear ",(0,i.kt)("em",{parentName:"p"},"before")," item ",(0,i.kt)("inlineCode",{parentName:"p"},""),":"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --move before \n")),(0,i.kt)("p",null,"Move Item ",(0,i.kt)("inlineCode",{parentName:"p"},"")," to appear ",(0,i.kt)("em",{parentName:"p"},"after")," item ",(0,i.kt)("inlineCode",{parentName:"p"},""),":"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --move after \n")),(0,i.kt)("h3",{id:"item-cloning"},"Item Cloning"),(0,i.kt)("p",null,"It is possible to clone another item instead of adding a completely blank item"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --clone [optional: before/after]\n")),(0,i.kt)("p",null,"the new item will inherit ",(0,i.kt)("em",{parentName:"p"},"all")," properties of the parent item. The optional ",(0,i.kt)("em",{parentName:"p"},"before")," and ",(0,i.kt)("em",{parentName:"p"},"after")," modifiers can be used\nto move the item ",(0,i.kt)("em",{parentName:"p"},"before"),", or ",(0,i.kt)("em",{parentName:"p"},"after")," the parent, equivalently to a --move command."),(0,i.kt)("h3",{id:"renaming-items"},"Renaming Items"),(0,i.kt)("p",null,"It is possible to rename any item. The new name should obviously not be in use by another item:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --rename \n")),(0,i.kt)("h3",{id:"removing-items"},"Removing Items"),(0,i.kt)("p",null,"It is possible to remove any item by invoking, the item will be completely destroyed and removed from brackets "),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --remove \n")),(0,i.kt)("p",null,"the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," can again be a regex: ",(0,i.kt)("inlineCode",{parentName:"p"},"//"),"."))}c.isMDXComponent=!0},9847:function(e,t,n){t.Z=n.p+"assets/images/bar_item-5cca16299fe8addecdacb3808b574cff.svg"}}]); \ No newline at end of file diff --git a/assets/js/37f332e7.f2ce1d5e.js b/assets/js/37f332e7.f2ce1d5e.js new file mode 100644 index 0000000..ddb9cea --- /dev/null +++ b/assets/js/37f332e7.f2ce1d5e.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[785],{3905:function(e,t,n){n.d(t,{Zo:function(){return m},kt:function(){return c}});var a=n(7294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function i(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var d=a.createContext({}),o=function(e){var t=a.useContext(d),n=t;return e&&(n="function"==typeof e?e(t):l(l({},t),e)),n},m=function(e){var t=o(e.components);return a.createElement(d.Provider,{value:t},e.children)},k={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},N=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,i=e.originalType,d=e.parentName,m=p(e,["components","mdxType","originalType","parentName"]),N=o(n),c=r,g=N["".concat(d,".").concat(c)]||N[c]||k[c]||i;return n?a.createElement(g,l(l({ref:t},m),{},{components:n})):a.createElement(g,l({ref:t},m))}));function c(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=n.length,l=new Array(i);l[0]=N;var p={};for(var d in t)hasOwnProperty.call(t,d)&&(p[d]=t[d]);p.originalType=e,p.mdxType="string"==typeof e?e:r,l[1]=p;for(var o=2;o \n")),(0,i.kt)("p",null,"where the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," should not contain whitespaces (or must be quoted), it is later used to refer to this item in the configuration.\nThe ",(0,i.kt)("inlineCode",{parentName:"p"},"")," is the placement in the bar and can be either ",(0,i.kt)("inlineCode",{parentName:"p"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"right"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"center``or "),"q",(0,i.kt)("inlineCode",{parentName:"p"},"(which is left of the notch) and"),"e` (which is right of the notch).\nThe items will appear in the bar in the order in which they are added, but can be moved later on."),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"th"},"")),(0,i.kt)("th",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"th"},"")))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:null},(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"center"),", (",(0,i.kt)("inlineCode",{parentName:"td"},"q"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"e")," ",(0,i.kt)("a",{parentName:"td",href:"https://github.com/FelixKratz/SketchyBar/issues/120"},"#120"),")")))),(0,i.kt)("h3",{id:"changing-item-properties"},"Changing item properties"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --set = ... =\n")),(0,i.kt)("p",null,"where the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," is used to target the item.\n(The ",(0,i.kt)("inlineCode",{parentName:"p"},"")," can be a regular expression inside of two slashed: ",(0,i.kt)("inlineCode",{parentName:"p"},"//"),")"),(0,i.kt)("p",null,"A list of properties available to the ",(0,i.kt)("em",{parentName:"p"},"set")," command is listed below (components might have additional properties, see the respective component section for them):"),(0,i.kt)("h3",{id:"geometry-properties"},"Geometry Properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"on")),(0,i.kt)("td",{parentName:"tr",align:null},"If the item should be drawn into the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"position")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"center")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Position of the item in the bar")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"associated_space")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Spaces to show this item on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"associated_display")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Displays to show this item on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"ignore_association")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"Ignores all space / display associations while on")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset applied to the item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")," or ",(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:null},"Makes the ",(0,i.kt)("em",{parentName:"td"},"item")," use a fixed ",(0,i.kt)("em",{parentName:"td"},"width")," given in points")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"align")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"center"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"left")),(0,i.kt)("td",{parentName:"tr",align:null},"Aligns the ",(0,i.kt)("inlineCode",{parentName:"td"},"item")," content in its container when it has a fixed ",(0,i.kt)("inlineCode",{parentName:"td"},"width")," larger than the content width")))),(0,i.kt)("h3",{id:"icon-properties"},"Icon properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"icon")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Icon of the item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"icon.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Icons support all ",(0,i.kt)("em",{parentName:"td"},"text")," properties")))),(0,i.kt)("h3",{id:"label-properties"},"Label properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"label")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Label of the item")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"label.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Labels support all ",(0,i.kt)("em",{parentName:"td"},"text")," properties")))),(0,i.kt)("h3",{id:"scripting-properties"},"Scripting properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"script")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Script to run on an ",(0,i.kt)("inlineCode",{parentName:"td"},"event"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"click_script")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Script to run on a mouse click (Difference to ",(0,i.kt)("inlineCode",{parentName:"td"},"mouse.clicked")," event: ",(0,i.kt)("a",{parentName:"td",href:"https://github.com/FelixKratz/SketchyBar/discussions/109"},"#109"),")")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"update_freq")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"1")),(0,i.kt)("td",{parentName:"tr",align:null},"Time in seconds between routine script executions")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"updates")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},""),", ",(0,i.kt)("inlineCode",{parentName:"td"},"when_shown")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"on")),(0,i.kt)("td",{parentName:"tr",align:null},"If and when the item updates e.g. via script execution")))),(0,i.kt)("h3",{id:"text-properties"},"Text properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"on")),(0,i.kt)("td",{parentName:"tr",align:null},"If the text is rendered")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"highlight")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the text uses the ",(0,i.kt)("inlineCode",{parentName:"td"},"highlight_color")," or the regular ",(0,i.kt)("inlineCode",{parentName:"td"},"color"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xffffffff")),(0,i.kt)("td",{parentName:"tr",align:null},"Color used to render the text")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"highlight_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xff000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Highlight color of the text (e.g. for active space icon")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_left")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the left of the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the right of the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset applied to the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"font")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"::")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"Hack Nerd Font:Bold:14.0")),(0,i.kt)("td",{parentName:"tr",align:null},"The font to be used for the ",(0,i.kt)("inlineCode",{parentName:"td"},"text"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")," or ",(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"dynamic")),(0,i.kt)("td",{parentName:"tr",align:null},"Makes the ",(0,i.kt)("inlineCode",{parentName:"td"},"text")," use a fixed ",(0,i.kt)("inlineCode",{parentName:"td"},"width")," given in points")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"align")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"center"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"left"),", ",(0,i.kt)("inlineCode",{parentName:"td"},"right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"left")),(0,i.kt)("td",{parentName:"tr",align:null},"Aligns the ",(0,i.kt)("inlineCode",{parentName:"td"},"text")," in its container when it has a fixed ",(0,i.kt)("inlineCode",{parentName:"td"},"width")," larger than the content width")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"background.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Texts support all ",(0,i.kt)("inlineCode",{parentName:"td"},"background")," properties")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"shadow.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Texts support all ",(0,i.kt)("inlineCode",{parentName:"td"},"shadow")," properties")))),(0,i.kt)("h3",{id:"background-properties"},"Background properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the ",(0,i.kt)("inlineCode",{parentName:"td"},"background")," should be rendered")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0x00000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Fill color of the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0x00000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the backgrounds border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"border_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Width of the background border")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"height")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Overrides the ",(0,i.kt)("inlineCode",{parentName:"td"},"height")," of the background")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"corner_radius")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Corner radius of the background")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_left")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the left of the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"padding_right")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Padding to the right of the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"y_offset")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"Vertical offset applied to the ",(0,i.kt)("inlineCode",{parentName:"td"},"background"))),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"image")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"The path to a png or jpeg image file")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"image.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Backgrounds support all ",(0,i.kt)("inlineCode",{parentName:"td"},"image")," properties")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"shadow.")),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:"center"}),(0,i.kt)("td",{parentName:"tr",align:null},"Backgrounds support all ",(0,i.kt)("inlineCode",{parentName:"td"},"shadow")," properties")))),(0,i.kt)("h3",{id:"image-properties"},"Image properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the image should draw")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"scale")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0")),(0,i.kt)("td",{parentName:"tr",align:null},"The scale factor that should be applied to the image")))),(0,i.kt)("h3",{id:"shadow-properties"},"Shadow properties"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"drawing")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"off")),(0,i.kt)("td",{parentName:"tr",align:null},"If the shadow should be drawn")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xff000000")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the shadow")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"angle")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"30")),(0,i.kt)("td",{parentName:"tr",align:null},"Angle of the shadow")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"distance")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"5")),(0,i.kt)("td",{parentName:"tr",align:null},"Distance of the shadow")))),(0,i.kt)("h3",{id:"changing-the-default-values-for-all-further-items"},"Changing the default values for all further items"),(0,i.kt)("p",null,"It is possible to change the ",(0,i.kt)("em",{parentName:"p"},"defaults")," at every point in the configuration. All item created ",(0,i.kt)("em",{parentName:"p"},"after")," changing the defaults will\ninherit these properties from the default item."),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --default = ... =\n")),(0,i.kt)("p",null,"this works for all item properties."),(0,i.kt)("h3",{id:"item-reordering"},"Item Reordering"),(0,i.kt)("p",null,"It is possible to reorder items by invoking"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --reorder ... \n")),(0,i.kt)("p",null,"where a new order can be supplied for arbitrary items. Only the specified items get reordered, by swapping them around, everything else stays the same. E.g. if you want to swap two items\nsimply call"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --reorder \n")),(0,i.kt)("h3",{id:"moving-items-to-specific-positions"},"Moving Items to specific positions"),(0,i.kt)("p",null,"It is possible to move items and order them next to a reference item."),(0,i.kt)("p",null,"Move Item ",(0,i.kt)("inlineCode",{parentName:"p"},"")," to appear ",(0,i.kt)("em",{parentName:"p"},"before")," item ",(0,i.kt)("inlineCode",{parentName:"p"},""),":"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --move before \n")),(0,i.kt)("p",null,"Move Item ",(0,i.kt)("inlineCode",{parentName:"p"},"")," to appear ",(0,i.kt)("em",{parentName:"p"},"after")," item ",(0,i.kt)("inlineCode",{parentName:"p"},""),":"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --move after \n")),(0,i.kt)("h3",{id:"item-cloning"},"Item Cloning"),(0,i.kt)("p",null,"It is possible to clone another item instead of adding a completely blank item"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --clone [optional: before/after]\n")),(0,i.kt)("p",null,"the new item will inherit ",(0,i.kt)("em",{parentName:"p"},"all")," properties of the parent item. The optional ",(0,i.kt)("em",{parentName:"p"},"before")," and ",(0,i.kt)("em",{parentName:"p"},"after")," modifiers can be used\nto move the item ",(0,i.kt)("em",{parentName:"p"},"before"),", or ",(0,i.kt)("em",{parentName:"p"},"after")," the parent, equivalently to a --move command."),(0,i.kt)("h3",{id:"renaming-items"},"Renaming Items"),(0,i.kt)("p",null,"It is possible to rename any item. The new name should obviously not be in use by another item:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --rename \n")),(0,i.kt)("h3",{id:"removing-items"},"Removing Items"),(0,i.kt)("p",null,"It is possible to remove any item by invoking, the item will be completely destroyed and removed from brackets "),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --remove \n")),(0,i.kt)("p",null,"the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," can again be a regex: ",(0,i.kt)("inlineCode",{parentName:"p"},"//"),"."))}c.isMDXComponent=!0},2975:function(e,t,n){t.Z=n.p+"assets/images/bar_item-5cca16299fe8addecdacb3808b574cff.svg"}}]); \ No newline at end of file diff --git a/assets/js/3847b3ea.85e9fd66.js b/assets/js/3847b3ea.dd7b3621.js similarity index 98% rename from assets/js/3847b3ea.85e9fd66.js rename to assets/js/3847b3ea.dd7b3621.js index ddf7672..8786bd8 100644 --- a/assets/js/3847b3ea.85e9fd66.js +++ b/assets/js/3847b3ea.dd7b3621.js @@ -1 +1 @@ -"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[581],{3905:function(e,t,n){n.d(t,{Zo:function(){return c},kt:function(){return d}});var a=n(7294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function l(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function i(e){for(var t=1;t=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var s=a.createContext({}),u=function(e){var t=a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},c=function(e){var t=u(e.components);return a.createElement(s.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,l=e.originalType,s=e.parentName,c=o(e,["components","mdxType","originalType","parentName"]),m=u(n),d=r,h=m["".concat(s,".").concat(d)]||m[d]||p[d]||l;return n?a.createElement(h,i(i({ref:t},c),{},{components:n})):a.createElement(h,i({ref:t},c))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var l=n.length,i=new Array(l);i[0]=m;var o={};for(var s in t)hasOwnProperty.call(t,s)&&(o[s]=t[s]);o.originalType=e,o.mdxType="string"==typeof e?e:r,i[1]=o;for(var u=2;u ",(0,l.kt)("em",{parentName:"li"},"Dock & Menu Bar"),":\n",(0,l.kt)("img",{alt:"hide_macOS_bar",src:n(6657).Z,width:"453",height:"68"}))),(0,l.kt)("h3",{id:"compile-from-source"},"Compile from source"),(0,l.kt)("p",null,"It is easy to compile the project from source:"),(0,l.kt)("ul",null,(0,l.kt)("li",{parentName:"ul"},"Install xCode commandline tools:")),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"xcode-select --install\n")),(0,l.kt)("ul",null,(0,l.kt)("li",{parentName:"ul"},"Clone the repository:")),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"git clone https://github.com/FelixKratz/SketchyBar.git\n")),(0,l.kt)("ul",null,(0,l.kt)("li",{parentName:"ul"},"In the sketchybar folder run:")),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"make\n")),(0,l.kt)("p",null,"This will generate a universal binary with arm64 and x86 instructions. It is\npossible to generate an arm64/x86 only binary via:"),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"make arm64\n")),(0,l.kt)("p",null,"or"),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"make x86\n")),(0,l.kt)("p",null,"Compiling on older macOS (pre Big Sur) versions should always be done via ",(0,l.kt)("inlineCode",{parentName:"p"},"make x86"),"."),(0,l.kt)("h2",{id:"uninstall"},"Uninstall"),(0,l.kt)("p",null,"Uninstall via ",(0,l.kt)("inlineCode",{parentName:"p"},"brew"),":"),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"brew uninstall sketchybar\nbrew untap FelixKratz/formulae\n")))}d.isMDXComponent=!0},6657:function(e,t,n){t.Z=n.p+"assets/images/hide_menubar-dda81922d34dda138a2e5f03cfcdc645.png"}}]); \ No newline at end of file +"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[581],{3905:function(e,t,n){n.d(t,{Zo:function(){return c},kt:function(){return d}});var a=n(7294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function l(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function i(e){for(var t=1;t=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var l=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var s=a.createContext({}),u=function(e){var t=a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):i(i({},t),e)),n},c=function(e){var t=u(e.components);return a.createElement(s.Provider,{value:t},e.children)},p={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,l=e.originalType,s=e.parentName,c=o(e,["components","mdxType","originalType","parentName"]),m=u(n),d=r,h=m["".concat(s,".").concat(d)]||m[d]||p[d]||l;return n?a.createElement(h,i(i({ref:t},c),{},{components:n})):a.createElement(h,i({ref:t},c))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var l=n.length,i=new Array(l);i[0]=m;var o={};for(var s in t)hasOwnProperty.call(t,s)&&(o[s]=t[s]);o.originalType=e,o.mdxType="string"==typeof e?e:r,i[1]=o;for(var u=2;u ",(0,l.kt)("em",{parentName:"li"},"Dock & Menu Bar"),":\n",(0,l.kt)("img",{alt:"hide_macOS_bar",src:n(2943).Z,width:"453",height:"68"}))),(0,l.kt)("h3",{id:"compile-from-source"},"Compile from source"),(0,l.kt)("p",null,"It is easy to compile the project from source:"),(0,l.kt)("ul",null,(0,l.kt)("li",{parentName:"ul"},"Install xCode commandline tools:")),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"xcode-select --install\n")),(0,l.kt)("ul",null,(0,l.kt)("li",{parentName:"ul"},"Clone the repository:")),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"git clone https://github.com/FelixKratz/SketchyBar.git\n")),(0,l.kt)("ul",null,(0,l.kt)("li",{parentName:"ul"},"In the sketchybar folder run:")),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"make\n")),(0,l.kt)("p",null,"This will generate a universal binary with arm64 and x86 instructions. It is\npossible to generate an arm64/x86 only binary via:"),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"make arm64\n")),(0,l.kt)("p",null,"or"),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"make x86\n")),(0,l.kt)("p",null,"Compiling on older macOS (pre Big Sur) versions should always be done via ",(0,l.kt)("inlineCode",{parentName:"p"},"make x86"),"."),(0,l.kt)("h2",{id:"uninstall"},"Uninstall"),(0,l.kt)("p",null,"Uninstall via ",(0,l.kt)("inlineCode",{parentName:"p"},"brew"),":"),(0,l.kt)("pre",null,(0,l.kt)("code",{parentName:"pre",className:"language-bash"},"brew uninstall sketchybar\nbrew untap FelixKratz/formulae\n")))}d.isMDXComponent=!0},2943:function(e,t,n){t.Z=n.p+"assets/images/hide_menubar-dda81922d34dda138a2e5f03cfcdc645.png"}}]); \ No newline at end of file diff --git a/assets/js/4ee9b86f.619883c0.js b/assets/js/4ee9b86f.619883c0.js new file mode 100644 index 0000000..433205d --- /dev/null +++ b/assets/js/4ee9b86f.619883c0.js @@ -0,0 +1 @@ +"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[550],{3905:function(e,n,t){t.d(n,{Zo:function(){return s},kt:function(){return f}});var a=t(7294);function i(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function r(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);n&&(a=a.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,a)}return t}function o(e){for(var n=1;n=0||(i[t]=e[t]);return i}(e,n);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(i[t]=e[t])}return i}var p=a.createContext({}),c=function(e){var n=a.useContext(p),t=n;return e&&(t="function"==typeof e?e(n):o(o({},n),e)),t},s=function(e){var n=c(e.components);return a.createElement(p.Provider,{value:n},e.children)},m={inlineCode:"code",wrapper:function(e){var n=e.children;return a.createElement(a.Fragment,{},n)}},u=a.forwardRef((function(e,n){var t=e.components,i=e.mdxType,r=e.originalType,p=e.parentName,s=l(e,["components","mdxType","originalType","parentName"]),u=c(t),f=i,d=u["".concat(p,".").concat(f)]||u[f]||m[f]||r;return t?a.createElement(d,o(o({ref:n},s),{},{components:t})):a.createElement(d,o({ref:n},s))}));function f(e,n){var t=arguments,i=n&&n.mdxType;if("string"==typeof e||i){var r=t.length,o=new Array(r);o[0]=u;var l={};for(var p in n)hasOwnProperty.call(n,p)&&(l[p]=n[p]);l.originalType=e,l.mdxType="string"==typeof e?e:i,o[1]=l;for(var c=2;c"),", ",(0,r.kt)("inlineCode",{parentName:"p"},"")," and ",(0,r.kt)("inlineCode",{parentName:"p"},""),"\nvalues can be animated, by prepending the animation command in front of any\nregular ",(0,r.kt)("inlineCode",{parentName:"p"},"--set")," or ",(0,r.kt)("inlineCode",{parentName:"p"},"--bar")," command:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --animate \\\n --bar = ... = \\\n --set = ... =\n")),(0,r.kt)("p",null,"where the ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is any of the animation curves:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"linear"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"tanh"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"sin"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"exp"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"bounce"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"overshoot"))),(0,r.kt)("p",null,"and the ",(0,r.kt)("inlineCode",{parentName:"p"},"")," is a positive integer quantifying the number of animation\nsteps."),(0,r.kt)("p",null,"The animation system ",(0,r.kt)("em",{parentName:"p"},"always")," animates between all ",(0,r.kt)("em",{parentName:"p"},"current")," values and the\nvalues specified in a configuration command (i.e. ",(0,r.kt)("inlineCode",{parentName:"p"},"--bar")," or ",(0,r.kt)("inlineCode",{parentName:"p"},"--set")," commands)."),(0,r.kt)("h3",{id:"perform-multiple-animations-chained-together-only-on-head"},"Perform multiple animations chained together (Only on HEAD)"),(0,r.kt)("p",null,"If you want to chain two or more animations together, you can do so by simply\nchanging the property multiple times, e.g.:"),(0,r.kt)("pre",null,(0,r.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --animate sin 30 --bar y_offset=10 y_offset=0\n")),(0,r.kt)("p",null,"will animate the bar to the first offset and after that to the second offset.\nYou can chain together as main animations as you like and you can change the\nanimation function in between. This is a nice way to create custom animations\nwith key-frames. You can also make other properties wait with their animation\ntill another animation is finished, by simply setting the property that should\nwait to its current value in the first animation."))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/4ee9b86f.be07cac0.js b/assets/js/4ee9b86f.be07cac0.js deleted file mode 100644 index d2e3738..0000000 --- a/assets/js/4ee9b86f.be07cac0.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[550],{3905:function(e,n,t){t.d(n,{Zo:function(){return c},kt:function(){return f}});var a=t(7294);function r(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function i(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);n&&(a=a.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,a)}return t}function o(e){for(var n=1;n=0||(r[t]=e[t]);return r}(e,n);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(a=0;a=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(r[t]=e[t])}return r}var p=a.createContext({}),s=function(e){var n=a.useContext(p),t=n;return e&&(t="function"==typeof e?e(n):o(o({},n),e)),t},c=function(e){var n=s(e.components);return a.createElement(p.Provider,{value:n},e.children)},m={inlineCode:"code",wrapper:function(e){var n=e.children;return a.createElement(a.Fragment,{},n)}},u=a.forwardRef((function(e,n){var t=e.components,r=e.mdxType,i=e.originalType,p=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),u=s(t),f=r,d=u["".concat(p,".").concat(f)]||u[f]||m[f]||i;return t?a.createElement(d,o(o({ref:n},c),{},{components:t})):a.createElement(d,o({ref:n},c))}));function f(e,n){var t=arguments,r=n&&n.mdxType;if("string"==typeof e||r){var i=t.length,o=new Array(i);o[0]=u;var l={};for(var p in n)hasOwnProperty.call(n,p)&&(l[p]=n[p]);l.originalType=e,l.mdxType="string"==typeof e?e:r,o[1]=l;for(var s=2;s"),", ",(0,i.kt)("inlineCode",{parentName:"p"},"")," and ",(0,i.kt)("inlineCode",{parentName:"p"},""),"\nvalues can be animated, by prepending the animation command in front of any\nregular ",(0,i.kt)("inlineCode",{parentName:"p"},"--set")," or ",(0,i.kt)("inlineCode",{parentName:"p"},"--bar")," command:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --animate \\\n --bar = ... = \\\n --set = ... =\n")),(0,i.kt)("p",null,"where the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," is any of the animation curves:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("inlineCode",{parentName:"li"},"linear"),", ",(0,i.kt)("inlineCode",{parentName:"li"},"tanh"),", ",(0,i.kt)("inlineCode",{parentName:"li"},"sin"),", ",(0,i.kt)("inlineCode",{parentName:"li"},"exp"),", ",(0,i.kt)("inlineCode",{parentName:"li"},"bounce"),", ",(0,i.kt)("inlineCode",{parentName:"li"},"overshoot"))),(0,i.kt)("p",null,"and the ",(0,i.kt)("inlineCode",{parentName:"p"},"")," is a positive integer quantifying the number of animation\nsteps."),(0,i.kt)("p",null,"The animation system ",(0,i.kt)("em",{parentName:"p"},"always")," animates between all ",(0,i.kt)("em",{parentName:"p"},"current")," values and the\nvalues specified in a configuration command (i.e. ",(0,i.kt)("inlineCode",{parentName:"p"},"--bar")," or ",(0,i.kt)("inlineCode",{parentName:"p"},"--set")," commands)."),(0,i.kt)("h3",{id:"perform-multiple-animations-chained-together-only-on-head"},"Perform multiple animations chained together (Only on HEAD)"),(0,i.kt)("p",null,"If you want to chain two or more animations together, you can do so by simply\nchanging the property multiple times, e.g.:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --animate sin 30 --bar y_offset=10 y_offset=0\n")),(0,i.kt)("p",null,"will animate the bar to the first offset and after that to the second offset.\nYou can chain together as main animations as you like and you can change the\nanimation function in between. This is a nice way to create custom animations\nwith key-frames. You can also make other properties wait with their animation\ntill another animation is finished, by simply setting the property that should\nwait to its current value in the first animation."))}f.isMDXComponent=!0}}]); \ No newline at end of file diff --git a/assets/js/73510e92.5d2f9eb6.js b/assets/js/73510e92.5d2f9eb6.js deleted file mode 100644 index b46e7e0..0000000 --- a/assets/js/73510e92.5d2f9eb6.js +++ /dev/null @@ -1 +0,0 @@ -"use strict";(self.webpackChunksketchybar_site=self.webpackChunksketchybar_site||[]).push([[141],{3905:function(e,t,a){a.d(t,{Zo:function(){return c},kt:function(){return d}});var n=a(7294);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function i(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function o(e){for(var t=1;t=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var i=Object.getOwnPropertySymbols(e);for(n=0;n=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var l=n.createContext({}),p=function(e){var t=n.useContext(l),a=t;return e&&(a="function"==typeof e?e(t):o(o({},t),e)),a},c=function(e){var t=p(e.components);return n.createElement(l.Provider,{value:t},e.children)},m={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},u=n.forwardRef((function(e,t){var a=e.components,r=e.mdxType,i=e.originalType,l=e.parentName,c=s(e,["components","mdxType","originalType","parentName"]),u=p(a),d=r,h=u["".concat(l,".").concat(d)]||u[d]||m[d]||i;return a?n.createElement(h,o(o({ref:t},c),{},{components:a})):n.createElement(h,o({ref:t},c))}));function d(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var i=a.length,o=new Array(i);o[0]=u;var s={};for(var l in t)hasOwnProperty.call(t,l)&&(s[l]=t[l]);s.originalType=e,s.mdxType="string"==typeof e?e:r,o[1]=s;for(var p=2;p \n")),(0,i.kt)("p",null,"Additional graph properties:"),(0,i.kt)("table",null,(0,i.kt)("thead",{parentName:"table"},(0,i.kt)("tr",{parentName:"thead"},(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},""),(0,i.kt)("th",{parentName:"tr",align:"center"},"default"),(0,i.kt)("th",{parentName:"tr",align:null},"description"))),(0,i.kt)("tbody",{parentName:"table"},(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"graph.color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xcccccc")),(0,i.kt)("td",{parentName:"tr",align:null},"Color of the graph line")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"graph.fill_color")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0xcccccc")),(0,i.kt)("td",{parentName:"tr",align:null},"Fill color of the graph")),(0,i.kt)("tr",{parentName:"tbody"},(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"graph.line_width")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"")),(0,i.kt)("td",{parentName:"tr",align:"center"},(0,i.kt)("inlineCode",{parentName:"td"},"0.5")),(0,i.kt)("td",{parentName:"tr",align:null},"Width of the line in points")))),(0,i.kt)("p",null,"Push data points into the graph via:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --push \n")),(0,i.kt)("p",null,"where the ",(0,i.kt)("inlineCode",{parentName:"p"},"data point")," is a floating point number between 0 and 1."),(0,i.kt)("h3",{id:"space----associate-mission-control-spaces-with-an-item"},"Space -- Associate mission control spaces with an item"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --add space \n")),(0,i.kt)("p",null,"The space component overrides the definition of the following properties and they must be set to correctly associate a mission control space with this item:"),(0,i.kt)("ul",null,(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("em",{parentName:"li"},"associated_space"),": Which space this item represents"),(0,i.kt)("li",{parentName:"ul"},(0,i.kt)("em",{parentName:"li"},"associated_display"),": On which display the ",(0,i.kt)("em",{parentName:"li"},"associated_space")," is shown.\nThe space component has additional variables available in ",(0,i.kt)("em",{parentName:"li"},"scripts"),":")),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"$SELECTED\n$SID\n$DID\n")),(0,i.kt)("p",null,"where ",(0,i.kt)("em",{parentName:"p"},"$SELECTED")," has the value ",(0,i.kt)("em",{parentName:"p"},"true")," if the associated space is selected and ",(0,i.kt)("em",{parentName:"p"},"false")," if the selected space is not selected, while\n",(0,i.kt)("inlineCode",{parentName:"p"},"$SID")," holds the space id and ",(0,i.kt)("inlineCode",{parentName:"p"},"$DID")," the display id."),(0,i.kt)("p",null,"By default the space component invokes the following script:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --set $NAME icon.highlight=$SELECTED\n")),(0,i.kt)("p",null,"which you can freely configure to your liking by supplying a different script to the space component:"),(0,i.kt)("pre",null,(0,i.kt)("code",{parentName:"pre",className:"language-bash"},"sketchybar --set script=
-

Animations

Animating the bar (Experimental)โ€‹

In the current stable release v2.6.0 animations are still experimental. -The current HEAD improves speed and other animation properties drastically.

All transitions between <argb_hex>, <integer> and <positive_integer> +

Animations

Animating the barโ€‹

All transitions between <argb_hex>, <integer> and <positive_integer> values can be animated, by prepending the animation command in front of any regular --set or --bar command:

sketchybar --animate <curve> <duration> \
           --bar <property>=<value> ... <property>=<value> \
           --set <name> <property>=<value> ... <property>=<value>

where the <curve> is any of the animation curves:

  • linear, tanh, sin, exp, bounce, overshoot

and the <duration> is a positive integer quantifying the number of animation steps.

The animation system always animates between all current values and the @@ -21,8 +20,8 @@ You can chain together as main animations as you like and you can change the animation function in between. This is a nice way to create custom animations with key-frames. You can also make other properties wait with their animation till another animation is finished, by simply setting the property that should -wait to its current value in the first animation.

- - +wait to its current value in the first animation.

+ + \ No newline at end of file diff --git a/config/bar.html b/config/bar.html index c6a7ce3..39a666b 100644 --- a/config/bar.html +++ b/config/bar.html @@ -5,21 +5,22 @@ Bar Properties | SketchyBar - - + +
-

Bar Properties

Configuration of the barโ€‹

For an example configuration see the supplied default sketchybarrc. +

Bar Properties

Configuration of the barโ€‹

For an example configuration see the supplied default sketchybarrc. The configuration file resides in ~/.config/sketchybar/sketchybarrc and is a -regular script that gets executed when sketchybar launches, everything +regular script that gets executed when SketchyBar launches, everything persistent should be set up in this script.

It is possible to play with properties in the commandline and change -them while the bar is running, once you find a fitting -value you can include it in the sketchybarrc file such that the configuration -is restored on restart. While configuring sketchybar it can be helpful to stop -the brew service and run sketchybar from the commandline directly to see all -relevant error messages and warnings from the main program.

The global bar properties can be configured by invoking:

sketchybar --bar <setting>=<value> ... <setting>=<value>

where possible settings are:

<setting><value>defaultdescription
color<argb_hex>0x44000000Color of the bar
border_color<argb_hex>0xffff0000Color of the bars border
positiontop, bottomtopPosition of the bar on the screen
height<integer>25Height of the bar
margin<integer>0Margin around the bar
y_offset<integer>0Vertical offset of the bar from its default position
corner_radius<positive_integer>0Corner radius of the bar
border_width<positive_integer>0Border width of the bars border
blur_radius<positive_integer>0Blur radius applied to the background of the bar
padding_left<positive_integer>0Padding between the left bar border and the leftmost item
padding_right<positive_integer>0Padding between the right bar border and the rightmost item
notch_width<positive_integer>200The width of the notch to be accounted for on the internal display
notch_offset<positive_integer>0Additional y_offset exclusively applied to notched screens (Only on HEAD)
displaymain, allallDisplay to show the bar on
hidden<boolean>, currentoffIf all / the current bar is hidden
topmost<boolean>offIf the bar should be drawn on top of everything
font_smoothing<boolean>offIf fonts should be smoothened
shadow<boolean>offIf the bar should draw a shadow
- - +them on the fly while the bar is running, once you find a fitting +value you can include it in the sketchybarrc file, such that the configuration +is restored on restart. When configuring SketchyBar it can be helpful to stop +the brew service and run sketchybar from the commandline directly to see all +relevant error messages and warnings directly.

The global bar properties can be configured by invoking:

sketchybar --bar <setting>=<value> ... <setting>=<value>

where possible settings are:

<setting><value>defaultdescription
color<argb_hex>0x44000000Color of the bar
border_color<argb_hex>0xffff0000Color of the bars border
positiontop, bottomtopPosition of the bar on the screen
height<integer>25Height of the bar
margin<integer>0Margin around the bar
y_offset<integer>0Vertical offset of the bar from its default position
corner_radius<positive_integer>0Corner radius of the bar
border_width<positive_integer>0Border width of the bars border
blur_radius<positive_integer>0Blur radius applied to the background of the bar
padding_left<positive_integer>0Padding between the left bar border and the leftmost item
padding_right<positive_integer>0Padding between the right bar border and the rightmost item
notch_width<positive_integer>200The width of the notch to be accounted for on the internal display
notch_offset<positive_integer>0Additional y_offset exclusively applied to notched screens
displaymain, allallDisplay to show the bar on
hidden<boolean>, currentoffIf all / the current bar is hidden
topmost<boolean>offIf the bar should be drawn on top of everything
font_smoothing<boolean>offIf fonts should be smoothened
shadow<boolean>offIf the bar should draw a shadow

You can find the nomenclature for all the types here. +If you are looking for colors, check out the color picker.

+ + \ No newline at end of file diff --git a/config/components.html b/config/components.html index 18b1243..78bcfda 100644 --- a/config/components.html +++ b/config/components.html @@ -5,20 +5,32 @@ Special Components | SketchyBar - - + +
-

Special Components

Components -- Special Items with special propertiesโ€‹

Components are essentially items, but with special properties. -Currently there are the components (more details in the corresponding sections below):

  • graph: showing a graph,
  • space: representing a mission control space
  • bracket: brackets together other items
  • alias: a default menu bar item

Data Graph -- Draws an arbitrary graph into the barโ€‹

sketchybar --add graph <name> <position> <width in points>

Additional graph properties:

<property><value>defaultdescription
graph.color<argb_hex>0xccccccColor of the graph line
graph.fill_color<argb_hex>0xccccccFill color of the graph
graph.line_width<float>0.5Width of the line in points

Push data points into the graph via:

sketchybar --push <name> <data point>

where the data point is a floating point number between 0 and 1.

Space -- Associate mission control spaces with an itemโ€‹

sketchybar --add space <name> <position>

The space component overrides the definition of the following properties and they must be set to correctly associate a mission control space with this item:

  • associated_space: Which space this item represents
  • associated_display: On which display the associated_space is shown. -The space component has additional variables available in scripts:
$SELECTED
$SID
$DID

where $SELECTED has the value true if the associated space is selected and false if the selected space is not selected, while -$SID holds the space id and $DID the display id.

By default the space component invokes the following script:

sketchybar --set $NAME icon.highlight=$SELECTED

which you can freely configure to your liking by supplying a different script to the space component:

sketchybar --set <name> script=<script/path>

For performance reasons the space script is only run on change.

Item Bracket -- Group Items in e.g. colored sectionsโ€‹

It is possible to bracket together items via the command (see this discussion for an example):

sketchybar --add bracket <name> <first item name> ... <n-th item name>

The first item must always be the one listed earliest in the config. It is now possible to +

Special Components

Components -- Special Items with special propertiesโ€‹

Components are essentially items, but with special properties. +Currently there are the components (more details in the corresponding sections below):

  • graph: showing a graph,
  • space: representing a mission control space
  • bracket: brackets together other items
  • alias: an alias of a menu bar item from the macOS bar

Data Graph -- Draws an arbitrary graph into the barโ€‹

sketchybar --add graph <name> <position> <width in points>

Additional graph properties:

<property><value>defaultdescription
graph.color<argb_hex>0xccccccColor of the graph line
graph.fill_color<argb_hex>0xccccccFill color of the graph
graph.line_width<float>0.5Width of the line in points

Push data points into the graph via:

sketchybar --push <name> <data point>

where the data point is a floating point number between 0 and 1.

Graphs usually take the entire height of the bar as a drawing canvas, however, +if you set a background for the graph item and set a height for it, the graph +will draw inside of the background. With a background enabled, the graph can +also be moved via a y_offset, e.g.:

sketchybar --set <graph name> background.color=0xff00ff00 background.height=20 y_offset=2

Space -- Associate mission control spaces with an itemโ€‹

sketchybar --add space <name> <position>

The space component overrides the definition of the following properties and they must be set to correctly associate a mission control space with this item:

  • associated_space: Which space this item represents
  • associated_display: On which display the associated_space is shown.

The space component has additional variables available in scripts:

$SELECTED
$SID
$DID

where $SELECTED has the value true if the associated space is selected and +false if the associated space is not selected, while +$SID holds the space id and $DID the display id.

By default the space component invokes the following script:

sketchybar --set $NAME icon.highlight=$SELECTED

which you can freely configure to your liking by supplying a different script +to the space component:

sketchybar --set <name> script=<script/path>

For performance reasons the space script is only run on a change in the +$SELECTED variable, i.e. if the associated space has become active +or has resigned being active.

Item Bracket -- Group Items in e.g. colored sectionsโ€‹

It is possible to bracket together items via the command (see this discussion for an example):

sketchybar --add bracket <name> <first item name> ... <n-th item name>

The first item must always be the one listed earliest in the config. It is now possible to set properties for the bracket, just as for any item or component. Brackets currently only support all background features. -E.g., if I wanted a colored background around all my space components (which are named code, writing, reading and entertainment) I would set it up like this:

sketchybar --add bracket primary_spaces code                        \
                                        writing                     \
                                        reading                     \
                                        entertainment               \
                                                                    \
           --set         primary_spaces background.color=0xffffffff \
                                        background.corner_radius=4  \
                                        background.height=20

this draws a white background below all my space components. I plan to expand the capability of item brackets significantly in the future.

Item Alias -- Mirror items of the original macOS status bar into sketchybarโ€‹

It is possible to create an alias for default menu bar items (such as MeetingBar, etc.) in sketchybar. The default menu bar can be set to autohide and this should still work.

It is now possible to create an alias of a default menu bar item with the following syntax:

sketchybar --add alias <application_name> <position>

this operation requires screen capture permissions, which should be granted in the system preferences. -This will put the default item into sketchybar. -Aliases currently are not clickable but can be modified with all the options available for simple items.

The command can be overloaded by providing a window_owner and a window_name

sketchybar --add alias <window_owner>,<window_name> <position>

this way the default system items can also be slurped into sketchybar, e.g.:

  • "Control Center,Bluetooth"
  • "Control Center,WiFi"

Or the individual widgets of Stats:

  • "Stats,CPU_Mini"
  • etc...

All further default menu items currently available on your system can be found via the command:

sketchybar --query default_menu_items

You can override the color of an alias via the property:

sketchybar --set <name> alias.color=<rgba_hex>
- - +E.g., if I wanted a colored background around all my space components (which are named code, writing, reading and entertainment) I would set it up like this:

sketchybar --add bracket primary_spaces code                        \
                                        writing                     \
                                        reading                     \
                                        entertainment               \
                                                                    \
           --set         primary_spaces background.color=0xffffffff \
                                        background.corner_radius=4  \
                                        background.height=20

this draws a white background below all my space components.

Item Alias -- Mirror items of the original macOS status bar into sketchybarโ€‹

It is possible to create an alias for default menu bar items +(such as MeetingBar, etc.) in sketchybar. The default menu bar can be set to +autohide and this should still work.

To create an alias of a default menu bar item use the following syntax:

sketchybar --add alias <application_name> <position>

this operation requires screen capture permissions, which should be granted +in the system preferences.

This will put the default macOS menu bar item into sketchybar. If an +application has multiple menu bar widgets the command can be overloaded by +providing a window_owner and a window_name

sketchybar --add alias "<window_owner>,<window_name>" <position>

this way the default system items can also be aliased in sketchybar as well, +e.g.:

  • "Control Center,Bluetooth"
  • "Control Center,WiFi"
  • ...

Or the individual widgets of Stats:

  • "Stats,CPU_Mini"
  • etc...

All further macOS menu bar items currently available on your system can be +found via the command

sketchybar --query default_menu_items

where all items with their respective owner and name are listed.

You can override the color of an alias via the property:

sketchybar --set <name> alias.color=<argb_hex>

Aliases currently are not clickable but can be modified with all the options +available for simple items.

+ + \ No newline at end of file diff --git a/config/events.html b/config/events.html index 9992f48..b23e27d 100644 --- a/config/events.html +++ b/config/events.html @@ -5,20 +5,22 @@ Events & Scripting | SketchyBar - - + +
-

Events & Scripting

Events and Scriptingโ€‹

Any item can subscribe to arbitrary events, when the event happens, all items subscribed to the event will execute their script. -This can be used to create more reactive and performant items which react to events rather than polling for a change.

sketchybar --subscribe <name> <event> ... <event>

where the events are:

<event>description
front_app_switchedWhen the front application changes (not triggered if a different window of the same app is focused)
space_changeWhen the active mission control space changes
display_changeWhen the active display is changed
system_will_sleepWhen the system prepares to sleep
system_wokeWhen the system has awaken from sleep
mouse.enteredWhen the mouse enters over an item
mouse.exitedWhen the mouse leaves an item
mouse.clickedWhen an item is clicked

When an item is subscribed to these events the script is run and it gets passed the $SENDER variable, which holds exactly the above names, to distinguish between the different events. -It is thus possible to have a script that reacts to each event differently e.g. via a switch for the $SENDER variable in the script.

Alternatively a fixed update_freq can be --set, such that the event is routinely run to poll for change.

When an item invokes a script, the script has access to some environment variables, such as:

$NAME
$SENDER

Where $NAME is the name of the item that has invoked the script and $SENDER is the reason why the script is executed.

If an item is clicked the script has access to the additional variables:

$BUTTON
$MODIFIER

where the $BUTTON can be left, right or other and specifies the mouse button that was used to click the item, while the $MODIFIER is either shift, ctrl, alt or cmd and -specifies the modifier key held down while clicking the item.

Some events send additional information in the $INFO variable

All scripts are forced to terminate after 60 seconds and do not run while the system is sleeping.

Creating custom eventsโ€‹

This allows to define events which are triggered by a different application (see Trigger custom events). Items can also subscribe to these events for their script execution.

sketchybar --add event <name> [optional: <NSDistributedNotificationName>]

Optional: You can subscribe to the notifications sent to the NSDistributedNotificationCenter e.g. +

Events & Scripting

Events and Scriptingโ€‹

All items can subscribe to arbitrary events; when the event happens, +all items subscribed to the event will execute their script. +This can be used to create more reactive and performant items which react to +events rather than polling for a change.

sketchybar --subscribe <name> <event> ... <event>

where the events are:

<event>description
front_app_switchedWhen the front application changes (not triggered if a different window of the same app is focused)
space_changeWhen the active mission control space changes
display_changeWhen the active display is changed
system_will_sleepWhen the system prepares to sleep
system_wokeWhen the system has awaken from sleep
mouse.enteredWhen the mouse enters over an item
mouse.exitedWhen the mouse leaves an item
mouse.entered.globalWhen the mouse enters over any part of the bar
mouse.exited.globalWhen the mouse leaves all parts of the bar
mouse.clickedWhen an item is clicked

When an item is subscribed to these events the script is run and it gets passed the $SENDER variable, which holds exactly the above names to distinguish between the different events. +It is thus possible to have a script that reacts to each event differently e.g. via a switch for the $SENDER variable in the script.

Alternatively a fixed update_freq can be --set, such that the event is routinely run to poll for change, the $SENDER variable will in this case hold the value routine.

When an item invokes a script, the script has access to some environment variables, such as:

$NAME
$SENDER

Where $NAME is the name of the item that has invoked the script and $SENDER is the reason why the script is executed.

If an item is clicked the script has access to the additional variables:

$BUTTON
$MODIFIER

where the $BUTTON can be left, right or other and specifies the mouse button that was used to click the item, while the $MODIFIER is either shift, ctrl, alt or cmd and +specifies the modifier key held down while clicking the item.

Some events send additional information in the $INFO variable

All scripts are forced to terminate after 60 seconds and do not run while the system is sleeping.

Creating custom eventsโ€‹

This allows to define events which are triggered by arbitrary applications or manually (see Trigger custom events). +Items can also subscribe to these events for their script execution.

sketchybar --add event <name> [optional: <NSDistributedNotificationName>]

Optional: You can subscribe to the notifications sent to the NSDistributedNotificationCenter e.g. the notification Spotify sends on track change: com.spotify.client.PlaybackStateChanged (example), or the notification sent by the system when a bluetooth device connected, or disconnected: com.apple.bluetooth.state (example) -to create more responsive items. Custom events that subscribe to NSDistributedNotificationCenter notifications will receive additional notification information in the $INFO variable if available.

Triggering custom eventsโ€‹

This triggers a custom event that has been added before

sketchybar --trigger <event> [Optional: <envvar>=<value> ... <envvar>=<value>]

Optionaly you can add environment variables to the trigger command witch are passed to the script, e.g.:

sketchybar --trigger demo VAR=Test

will trigger the demo event and $VAR will be available as an environment variable in the scripts that this event invokes. -This could be used to link the powerful event system of yabai to sketchybar by triggering the custom action via a yabai event.

Forcing all shell scripts to run and the bar to refreshโ€‹

sketchybar --update
- - +to create more responsive items. Custom events that subscribe to NSDistributedNotificationCenter notifications will receive additional notification information in the $INFO variable if available.

Triggering custom eventsโ€‹

This triggers a custom event that has been added before

sketchybar --trigger <event> [Optional: <envvar>=<value> ... <envvar>=<value>]

Optionally you can add environment variables to the trigger command witch are passed to the script, e.g.:

sketchybar --trigger demo VAR=Test

will trigger the demo event and $VAR will be available as an environment variable in the scripts that this event invokes.

Forcing all shell scripts to run and the bar to refreshโ€‹

sketchybar --update
+ + \ No newline at end of file diff --git a/config/items.html b/config/items.html index eb328ff..ba448c3 100644 --- a/config/items.html +++ b/config/items.html @@ -5,19 +5,19 @@ Item Properties | SketchyBar - - + +
-

Item Properties

Items and their propertiesโ€‹

Items are the main building blocks of sketchybar and can be configured in a number of ways. Items have the following basic structure:

Item Structure

Adding items to sketchybarโ€‹

sketchybar --add item <name> <position>

where the <name> should not contain whitespaces (or must be quoted), it can be used to further configure the item. -The <position> is the placement in the bar and can be either left, right or center. The items will appear in the bar in the order -in which they are added, but can be moved later on.

<name><string>
<position>left, right, center, (q, e #120)

Changing item propertiesโ€‹

sketchybar --set <name> <property>=<value> ... <property>=<value>

where the name is used to target the item with this name. -(The name can be a regular expression inside of two '/': /\<regex>/)

A list of properties available to the set command is listed below (components might have additional properties, see the respective component section for them):

Geometry Propertiesโ€‹

<property><value>defaultdescription
positionleft, right, centerPosition of the item in the bar
associated_space<positive_integer list>0Spaces to show this item on
associated_display<positive_integer list>0Displays to show this item on
ignore_association<boolean>offIgnores all space / display associations while on
y_offset<integer>0Vertical offset applied to the item
width<positive_integer> or dynamicdynamicMakes the item use a fixed width given in points
aligncenter, left, rightleftAligns the item content in its container when it has a fixed width larger than the content width

Drawing propertiesโ€‹

<property><value>defaultdescription
drawing<boolean>onIf the item should be drawn into the bar
lazy<boolean>offChanges do not trigger a redraw of the bar, item is refreshed when the bar is redrawn anyways

Icon propertiesโ€‹

<property><value>defaultdescription
icon<string>Icon of the item
icon.<text_property>Icons support all text properties

Label propertiesโ€‹

<property><value>defaultdescription
label<string>Label of the item
label.<text_property>Labels support all text properties

Scripting propertiesโ€‹

<property><value>defaultdescription
script<path>, <string>Script to run on an event
click_script<path>, <string>Script to run on a mouse click (Difference to mouse.clicked event: #109)
update_freq<positive_integer>1Time in seconds between routine script executions
updates<boolean>, when_shownonIf and when the item updates e.g. via script execution

Text propertiesโ€‹

<text_property><value>defaultdescription
drawing<boolean>onIf the text is rendered
highlight<boolean>offIf the text uses the highlight_color or the regular color
color<argb_hex>0xffffffffColor used to render the text
highlight_color<argb_hex>0xff000000Highlight color of the text (e.g. for active space icon
padding_left<integer>0Padding to the left of the text
padding_right<integer>0Padding to the right of the text
y_offset<integer>0Vertical offset applied to the text
font<family>:<type>:<size>Hack Nerd Font:Bold:14.0The font to be used for the text
width<positive_integer> or dynamicdynamicMakes the text use a fixed width given in points
aligncenter, left, rightleftAligns the text in its container when it has a fixed width larger than the content width
background.<background_property>Texts support all background properties
shadow.<shadow_property>Texts support all shadow properties

Background propertiesโ€‹

<background_property><value>defaultdescription
drawing<boolean>offIf the background should be rendered
color<argb_hex>0x00000000Fill color of the background
border_color<argb_hex>0x00000000Color of the backgrounds border
border_width<positive_integer>0Width of the background border
height<positive_integer>0Overrides the height of the background
corner_radius<positive_integer>0Corner radius of the background
padding_left<integer>0Padding to the left of the background
padding_right<integer>0Padding to the right of the background
y_offset<integer>0Vertical offset applied to the background
image<path>The path to a png or jpeg image file
image.<image_property>Backgrounds support all image properties
shadow.<shadow_property>Backgrounds support all shadow properties

Image propertiesโ€‹

<image_property><value>defaultdescription
drawing<boolean>offIf the image should draw
scale<positive_integer>0The scale factor that should be applied to the image

Shadow propertiesโ€‹

<shadow_property><value>defaultdescription
drawing<boolean>offIf the shadow should be drawn
color<argb_hex>0xff000000Color of the shadow
angle<positive_integer>30Angle of the shadow
distance<positive_integer>5Distance of the shadow

Changing the default values for all further itemsโ€‹

It is possible to change the defaults at every point in the configuration. All item created after changing the defaults will +

Item Properties

Items and their propertiesโ€‹

Items are the main building blocks of SketchyBar and can be configured in a number of ways. Items have the following basic structure:

Item Structure

Adding items to SketchyBarโ€‹

sketchybar --add item <name> <position>

where the <name> should not contain whitespaces (or must be quoted), it is later used to refer to this item in the configuration. +The <position> is the placement in the bar and can be either left, right, center``or q(which is left of the notch) ande` (which is right of the notch). +The items will appear in the bar in the order in which they are added, but can be moved later on.

<name><string>
<position>left, right, center, (q, e #120)

Changing item propertiesโ€‹

sketchybar --set <name> <property>=<value> ... <property>=<value>

where the <name> is used to target the item. +(The <name> can be a regular expression inside of two slashed: /<regex>/)

A list of properties available to the set command is listed below (components might have additional properties, see the respective component section for them):

Geometry Propertiesโ€‹

<property><value>defaultdescription
drawing<boolean>onIf the item should be drawn into the bar
positionleft, right, centerPosition of the item in the bar
associated_space<positive_integer list>0Spaces to show this item on
associated_display<positive_integer list>0Displays to show this item on
ignore_association<boolean>offIgnores all space / display associations while on
y_offset<integer>0Vertical offset applied to the item
width<positive_integer> or dynamicdynamicMakes the item use a fixed width given in points
aligncenter, left, rightleftAligns the item content in its container when it has a fixed width larger than the content width

Icon propertiesโ€‹

<property><value>defaultdescription
icon<string>Icon of the item
icon.<text_property>Icons support all text properties

Label propertiesโ€‹

<property><value>defaultdescription
label<string>Label of the item
label.<text_property>Labels support all text properties

Scripting propertiesโ€‹

<property><value>defaultdescription
script<path>, <string>Script to run on an event
click_script<path>, <string>Script to run on a mouse click (Difference to mouse.clicked event: #109)
update_freq<positive_integer>1Time in seconds between routine script executions
updates<boolean>, when_shownonIf and when the item updates e.g. via script execution

Text propertiesโ€‹

<text_property><value>defaultdescription
drawing<boolean>onIf the text is rendered
highlight<boolean>offIf the text uses the highlight_color or the regular color
color<argb_hex>0xffffffffColor used to render the text
highlight_color<argb_hex>0xff000000Highlight color of the text (e.g. for active space icon
padding_left<integer>0Padding to the left of the text
padding_right<integer>0Padding to the right of the text
y_offset<integer>0Vertical offset applied to the text
font<family>:<type>:<size>Hack Nerd Font:Bold:14.0The font to be used for the text
width<positive_integer> or dynamicdynamicMakes the text use a fixed width given in points
aligncenter, left, rightleftAligns the text in its container when it has a fixed width larger than the content width
background.<background_property>Texts support all background properties
shadow.<shadow_property>Texts support all shadow properties

Background propertiesโ€‹

<background_property><value>defaultdescription
drawing<boolean>offIf the background should be rendered
color<argb_hex>0x00000000Fill color of the background
border_color<argb_hex>0x00000000Color of the backgrounds border
border_width<positive_integer>0Width of the background border
height<positive_integer>0Overrides the height of the background
corner_radius<positive_integer>0Corner radius of the background
padding_left<integer>0Padding to the left of the background
padding_right<integer>0Padding to the right of the background
y_offset<integer>0Vertical offset applied to the background
image<path>The path to a png or jpeg image file
image.<image_property>Backgrounds support all image properties
shadow.<shadow_property>Backgrounds support all shadow properties

Image propertiesโ€‹

<image_property><value>defaultdescription
drawing<boolean>offIf the image should draw
scale<positive_integer>0The scale factor that should be applied to the image

Shadow propertiesโ€‹

<shadow_property><value>defaultdescription
drawing<boolean>offIf the shadow should be drawn
color<argb_hex>0xff000000Color of the shadow
angle<positive_integer>30Angle of the shadow
distance<positive_integer>5Distance of the shadow

Changing the default values for all further itemsโ€‹

It is possible to change the defaults at every point in the configuration. All item created after changing the defaults will inherit these properties from the default item.

sketchybar --default <property>=<value> ... <property>=<value>

this works for all item properties.

Item Reorderingโ€‹

It is possible to reorder items by invoking

sketchybar --reorder <name> ... <name>

where a new order can be supplied for arbitrary items. Only the specified items get reordered, by swapping them around, everything else stays the same. E.g. if you want to swap two items simply call

sketchybar --reorder <item 1> <item 2>

Moving Items to specific positionsโ€‹

It is possible to move items and order them next to a reference item.

Move Item <name> to appear before item <reference name>:

sketchybar --move <name> before <reference name>

Move Item <name> to appear after item <reference name>:

sketchybar --move <name> after <reference name>

Item Cloningโ€‹

It is possible to clone another item instead of adding a completely blank item

sketchybar --clone <parent name> <name> [optional: before/after]

the new item will inherit all properties of the parent item. The optional before and after modifiers can be used -to move the item before, or after the parent, equivalently to a --move command.

Renaming Itemsโ€‹

It is possible to rename any item. The new name should obviously not be in use by another item:

sketchybar --rename <old name> <new name>

Removing Itemsโ€‹

It is possible to remove any item by invoking, the item will be completely destroyed and removed from brackets 

sketchybar --remove <name>

the <name> can again be a regex: /<regex>/.

- - +to move the item before, or after the parent, equivalently to a --move command.

Renaming Itemsโ€‹

It is possible to rename any item. The new name should obviously not be in use by another item:

sketchybar --rename <old name> <new name>

Removing Itemsโ€‹

It is possible to remove any item by invoking, the item will be completely destroyed and removed from brackets 

sketchybar --remove <name>

the <name> can again be a regex: /<regex>/.

+ + \ No newline at end of file diff --git a/config/popups.html b/config/popups.html index 8ca33c0..88c7f4a 100644 --- a/config/popups.html +++ b/config/popups.html @@ -5,15 +5,15 @@ Popup Menus | SketchyBar - - + +
-

Popup Menus

Simple Popup

Popup menus are a powerful way to make further items accessible in a small popup window below any bar item. -Every item has a popup available with the properties:

<property><value>defaultdescription
popup.drawing<boolean>offIf the popup should be rendered
popup.horizontal<boolean>offIf the popup should render horizontally
popup.height<positive_integer>bar heightThe vertical spacing between items in a popup
popup.y_offset<integer>0Vertical offset applied to the popup
popup.alignleft, right, centerleftAlignment of the popup with its parent item in the bar
popup.background.<background_property>Popups have a background and support all properties

Items can be added to a popup menu by setting the position of those items to popup.<name> where <name> is the name of the item containing the popup. +

Popup Menus

Simple Popup

Popup menus are a powerful way to make further items accessible in a small popup window below any bar item. +Every item has a popup available with the properties:

sketchybar --set <name> popup.<popup_property>=<value>
<popup_property><value>defaultdescription
drawing<boolean>offIf the popup should be rendered
horizontal<boolean>offIf the popup should render horizontally
height<positive_integer>bar heightThe vertical spacing between items in a popup
y_offset<integer>0Vertical offset applied to the popup
alignleft, right, centerleftAlignment of the popup with its parent item in the bar
background.<background_property>Popups have a background and support all properties

Items can be added to a popup menu by setting the position of those items to popup.<name> where <name> is the name of the item containing the popup. You can find a demo implementation of this here.

- - + + \ No newline at end of file diff --git a/config/querying.html b/config/querying.html index fd7b68c..52c0ade 100644 --- a/config/querying.html +++ b/config/querying.html @@ -5,13 +5,13 @@ Querying Information | SketchyBar - - + +
-

Querying Information

Queryingโ€‹

SketchyBar can be queried for information about a number of things.

Bar Propertiesโ€‹

Information about the bar can be queried via:

sketchybar --query bar

The output is a json structure containing relevant information about the configuration settings of the bar.

Item Propertiesโ€‹

Information about an item can be queried via:

sketchybar --query <name>

The output is a json structure containing relevant information about the configuration of the item.

Default Propertiesโ€‹

Information about the current defaults.

sketchybar --query defaults

Event Propertiesโ€‹

Information about the events.

sketchybar --query events

macOS Menu Bar Item Names (for use with aliases)โ€‹

The names of the menu bar items in the default macOS bar:

sketchybar --query default_menu_items
- - +

Querying Information

Queryingโ€‹

SketchyBar can be queried for information about a number of things.

Bar Propertiesโ€‹

Information about the bar can be queried via:

sketchybar --query bar

The output is a JSON structure containing relevant information about the configuration settings of the bar.

Item Propertiesโ€‹

Information about an item can be queried via:

sketchybar --query <name>

The output is a JSON structure containing relevant information about the configuration of the item.

Default Propertiesโ€‹

Information about the current defaults.

sketchybar --query defaults

Event Propertiesโ€‹

Information about the events.

sketchybar --query events

macOS Menu Bar Item Names (for use with aliases)โ€‹

The names of the menu bar items in the default macOS bar:

sketchybar --query default_menu_items
+ + \ No newline at end of file diff --git a/config/tricks.html b/config/tricks.html index 436710f..b8ee80f 100644 --- a/config/tricks.html +++ b/config/tricks.html @@ -5,20 +5,21 @@ Tips & Tricks | SketchyBar - - + +
-

Tips & Tricks

Batching of configuration commandsโ€‹

It is possible to batch commands together into a single call to sketchybar, this can be helpful to +

Tips & Tricks

Batching of configuration commandsโ€‹

It is possible to batch commands together into a single call to SketchyBar, this can be helpful to keep the configuration file a bit cleaner and also to reduce startup times. -Assume 5 individual configuration calls to sketchybar:

sketchybar --bar position=top
sketchybar --bar margin=5
sketchybar --add item demo left
sketchybar --set demo label=Hello
sketchybar --subscribe demo system_woke

after each configuration command the bar is redrawn (if needed), thus it is more perfomant to append these calls into a single command like so:

sketchybar --bar position=top           \
                 margin=5               \
           --add item demo left         \
           --set demo label=Hello       \
           --subscribe demo system_woke

The backslash at the end of the first 4 lines is the default bash way to join lines together and should not be followed by a whitespace.

Debugging Problemsโ€‹

If you are experiencing problems with the configuration of sketchybar it might be helpful to work through the following steps:

  • 1.) Start sketchybar directly from the commandline to see the verbose error/warning messages
  • 2.) Make sure you have no trailing whitespaces after the bash newline escape char \
  • 3.) Make sure your scripts are made executable via: chmod +x script.sh
  • 4.) Reduce the configuration to a minimal example and narrow down the problematic region
  • 5.) Try running erroneous scripts directly in the commandline
  • 6.) Query sketchybar for relevant properties and use them to deduce the problems root cause
  • 7.) Create an Issue on GitHub, a second pair of eyes might now be the only thing that helps

Color Pickerโ€‹

SketchyBar uses the argb hex color format, which means: 0xAARRGGBB encodes a -color.

Try the Picker!

Finding Iconsโ€‹

The default font sketchybar uses is the Hack Nerd Font which means all Nerdfont icons can be used. -Refer to the Nerdfont cheat-sheet to find new icons.

Additionally, it is possible to use other icons and glyphs from different fonts, such as the sf-symbols -from apple. Those symbols can be installed via brew:

brew install --cask sf-symbols

After installing this package, an app called SF Symbols will be available where you can find all the available icons. -Once you find a fitting icon, right click it, select Copy Symbol and paste it in the relevant configuration file.

Performance optimizationsโ€‹

SketchyBar can be configured to have a very small performance footprint. In the following I will highlight some optimizations that can be used to reduce the footprint further.

  • Batch together configuration commands where ever possible.
  • Set items to be lazy, e.g. I have an alias component in my bar that updates every 2 seconds, thus I set all non-reactive items to lazy=on, -and only the ones that should react to change instantaneously to lazy=off.
  • Set updates=when_shown for items that do not need to run their script if they are not rendered.
  • Reduce the update_freq of scripts and aliases and use event-driven scripting when ever possible.
  • Do not add aliases to apps that are not always running, otherwise sketchybar searches for them continously.
- - +Assume 5 individual configuration calls to SketchyBar:

sketchybar --bar position=top
sketchybar --bar margin=5
sketchybar --add item demo left
sketchybar --set demo label=Hello
sketchybar --subscribe demo system_woke

after each configuration command the bar is redrawn (if needed), thus it is +faster to append these calls into a single command like so:

sketchybar --bar position=top           \
                 margin=5               \
           --add item demo left         \
           --set demo label=Hello       \
           --subscribe demo system_woke

The backslash at the end of the first 4 lines is the default bash way to join lines together and should not be followed by a whitespace.

Debugging Problemsโ€‹

If you are experiencing problems with the configuration of SketchyBar it might be helpful to work through the following steps:

  • 1.) Start sketchybar directly from the commandline to see the verbose error/warning messages
  • 2.) Make sure you have no trailing whitespaces after the bash newline escape char \
  • 3.) Make sure your scripts are made executable via: chmod +x script.sh
  • 4.) Reduce the configuration to a minimal example and narrow down the problematic region
  • 5.) Try running erroneous scripts directly in the commandline
  • 6.) Query SketchyBar for relevant properties and use them to deduce the problems root cause
  • 7.) Create an Issue on GitHub, a second pair of eyes might now be the only thing that helps

Color Pickerโ€‹

SketchyBar uses the argb hex color format, which means: 0xAARRGGBB encodes a +color.

Try the Picker!

Finding Iconsโ€‹

The default font SketchyBar uses is the Hack Nerd Font which means all Nerdfont icons can be used. +Refer to the Nerdfont cheat-sheet to find new icons.

Additionally, it is possible to use other icons and glyphs from different fonts, +such as the sf-symbols from apple. +Those symbols can be installed via brew:

brew install --cask sf-symbols

After installing this package, an app called SF Symbols will be available where you can find all the available icons. +Once you find a fitting icon, right click it, select Copy Symbol and paste it in the relevant configuration file.

Performance optimizationsโ€‹

SketchyBar can be configured to have a very small performance footprint. In the following I will highlight some optimizations that can be used to reduce the footprint further.

  • Batch together configuration commands where ever possible.
  • Set updates=when_shown for items that do not need to run their script if they are not rendered.
  • Reduce the update_freq of scripts and aliases and use event-driven scripting when ever possible.
  • Do not add aliases to apps that are not always running, otherwise SketchyBar searches for them continuously.
+ + \ No newline at end of file diff --git a/config/types.html b/config/types.html index 1b4ec4b..b91d125 100644 --- a/config/types.html +++ b/config/types.html @@ -5,13 +5,13 @@ Type Nomenclature | SketchyBar - - + +
-

Type Nomenclature

Type nomenclatureโ€‹

typevalues
<boolean>on, off, yes, no, true, false, 1, 0, toggle
<argb_hex>Color as an 8 digit hex with alpha, red, green and blue channels
<path>An absolute file path
<string>Any UTF-8 string or symbol
<float>A floating point number
<integer>An integer
<positive_integer>A positive integer
<positive_integer list>A comma separated list of positive integers
- - +

Type Nomenclature

Type nomenclatureโ€‹

typevalues
<boolean>on, off, yes, no, true, false, 1, 0, toggle
<argb_hex>Color as an 8 digit hex with alpha, red, green and blue channels
<path>An absolute file path
<string>Any UTF-8 string or symbol
<float>A floating point number
<integer>An integer
<positive_integer>A positive integer
<positive_integer list>A comma separated list of positive integers
+ + \ No newline at end of file diff --git a/credits.html b/credits.html index e06852b..04bf4d2 100644 --- a/credits.html +++ b/credits.html @@ -5,14 +5,14 @@ Credits | SketchyBar - - + +

Credits

Creditsโ€‹

This project was forked from spacebar and completely reimagined and rewritten. The original idea is based on the status bar that was included in yabai before getting removed.

- - + + \ No newline at end of file diff --git a/features.html b/features.html index 811ccdb..e0b9fdf 100644 --- a/features.html +++ b/features.html @@ -5,8 +5,8 @@ Features | SketchyBar - - + +
@@ -20,7 +20,7 @@ of the bar possible and opens the possibility to create individualized bar confi These simple ingredients make items almost endlessly customizable and can be used to display arbitrary information and perform useful actions.

Some special features can not be accomplished with a simple item, this is where the components come into play. They basically are items with extra steps. They contain all the properties a regular item does, but they can do specialized tasks a simple item can not. For example, there is a graph component, which can be used to display graphs in the bar.

For more details on how the configuration works, see the configuration section.

Examplesโ€‹

examples

- - + + \ No newline at end of file diff --git a/index.html b/index.html index e0d8b25..64fd84e 100644 --- a/index.html +++ b/index.html @@ -5,13 +5,13 @@ SketchyBar ยท A highly customizable macOS statusbar replacement - - + +
- - + + \ No newline at end of file diff --git a/picker.html b/picker.html index 72de15d..81e301f 100644 --- a/picker.html +++ b/picker.html @@ -5,13 +5,13 @@ SketchyBar ยท A highly customizable macOS statusbar replacement - - + +
Try the Picker!
- - + + \ No newline at end of file diff --git a/setup.html b/setup.html index f0befad..17b7208 100644 --- a/setup.html +++ b/setup.html @@ -5,8 +5,8 @@ Setup | SketchyBar - - + +
@@ -22,7 +22,7 @@ You should of course vet the code from all plugins before executing them to make below the original macOS bar. You can do a few things to make SketchyBar visible:

  • Give SketchyBar a y_offset
sketchybar --bar y_offset=32
  • Hide the default macOS menu bar in System Preferences -> Dock & Menu Bar: hide_macOS_bar

Compile from sourceโ€‹

It is easy to compile the project from source:

  • Install xCode commandline tools:
xcode-select --install
  • Clone the repository:
git clone https://github.com/FelixKratz/SketchyBar.git
  • In the sketchybar folder run:
make

This will generate a universal binary with arm64 and x86 instructions. It is possible to generate an arm64/x86 only binary via:

make arm64

or

make x86

Compiling on older macOS (pre Big Sur) versions should always be done via make x86.

Uninstallโ€‹

Uninstall via brew:

brew uninstall sketchybar
brew untap FelixKratz/formulae
- - + + \ No newline at end of file