{"id":19953902,"url":"https://github.com/lycuid/clubar","last_synced_at":"2025-08-23T17:34:55.246Z","repository":{"id":45836144,"uuid":"432520779","full_name":"lycuid/clubar","owner":"lycuid","description":"A minialistic statusbar, inspired by xmobar and dwm's statusbar.","archived":false,"fork":false,"pushed_at":"2024-09-10T17:25:45.000Z","size":511,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-03T19:39:43.483Z","etag":null,"topics":["c","cluless","statusbar","x11","xorg"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lycuid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-27T17:11:21.000Z","updated_at":"2024-11-20T21:20:27.000Z","dependencies_parsed_at":"2024-06-08T14:57:54.023Z","dependency_job_id":"4ea2f675-d747-4470-a02b-be5bca37890f","html_url":"https://github.com/lycuid/clubar","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/lycuid/clubar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycuid%2Fclubar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycuid%2Fclubar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycuid%2Fclubar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycuid%2Fclubar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lycuid","download_url":"https://codeload.github.com/lycuid/clubar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lycuid%2Fclubar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271759732,"owners_count":24816266,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","cluless","statusbar","x11","xorg"],"created_at":"2024-11-13T01:18:09.688Z","updated_at":"2025-08-23T17:34:55.203Z","avatar_url":"https://github.com/lycuid.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"cluless statusbar\n-----------------\nA minialistic, lightweight, customizable statusbar (formerly *xdbar*), inspired by [xmobar](https://xmobar.org/) and [dwm](https://dwm.suckless.org/)'s statusbar, for X11 Desktops (wayland in progress), that are compatible with [EWMH](https://specifications.freedesktop.org/wm-spec/latest/) specifications.\n\nRendering styled/clickable text, is inspired by xmobar's approach of wrapping text in XML like *tags*.  \nPopulating statusbar is inspired by dwm statusbar's approach of using the root window's `WM_NAME` attribute text.\n\n![dark.png](https://raw.githubusercontent.com/lycuid/assets/master/clubar/dark.png)\n\n----\n\n![light.png](https://raw.githubusercontent.com/lycuid/assets/master/clubar/light.png)\n\nDescription\n-----------\n```txt\n  + - - - - - - - - - - - - - - - - - margin - - - - - - - - - - - - - - - - - +\n  ¦ +------------------------------------------------------------------------+ ¦\n  ¦ | + - - - - - - - - - - - - - - - padding - - - - - - - - - - - - - - -+ | ¦\n  ¦ | ¦stdin                                                        WM_NAME¦ | ¦\n  ¦ | +- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + | ¦\n  ¦ +------------------------------------------------------------------------+ ¦\n  +- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +\n```\n- ***margin*** is the empty space outside of the bar window.\n- ***padding*** is the space between the bar window edges and the drawing region.\n- ***stdin*** text is typically provided by the window manager.\n- ***WM_NAME*** (of the root window) can be set using the `xsetroot` command.\n\n**Setting `WM_NAME`**\n- [slstatus](https://tools.suckless.org/slstatus)\n- [smolprog](https://github.com/lycuid/smolprog/) *(my personal script)*\n- Custom script example:\n```bash\n#!/bin/bash\nwhile true; do\n  xsetroot -name \"$(whoami)@$(hostname) on $(uname -o) | $(date)\"\n  sleep 1\ndone\n```\nUsage\n-----\n```txt\nUSAGE: clubar [OPTIONS]...\nOPTIONS:\n  -h, --help      print this help message.\n  -v, --version   print version.\n  -t, --topbar    window position (top/bottom edge of the screen).\n  -c file, --config[=file]\n                  filepath for runtime configs (supports: lua).\n  -g values, --geometry[=values]\n                  window geometry as 'x,y,width,height' (eg: '0,0,1280,720').\n  -p values, --padding[=values]\n                  window padding as 'left,right,top,bot' (eg: '0,0,10,10').\n  -m values, --margin[=values]\n                  window margin as 'left,right,top,bot' (eg: '0,0,10,10').\n  -f color, --foreground[=color]\n                  set default foreground color.\n  -b color, --background[=color]\n                  set default background color.\n  --fonts[=values]\n                  comma seperated fonts (eg: 'arial-10,monospace-10:bold').\nSIGNALS:\n  USR1: toggle window visibility (e.g. pkill -USR1 clubar).\n  USR2: Reload configurations from external config file without reloading.\n```\nRequirements\n------------\n  - ***free***, ***libre*** and ***open source*** Operating System (currently doesn't support \\*BSD).\n  - gnu make\n  - libx11\n  - libxft\n\n**Optional**\n  - pkg-config  (if not installed, update `config.mk` accordingly).\n  - lua         (required if using `luaconfig` plugin).\n\nBuild\n-----\n**Default build**\n```sh\nmake\n```\n**Build with plugins enabled**\n```sh\nmake PLUGINS=\"luaconfig xrmconfig ...\"\n```\n**Install**\n```sh\nsudo make install\n```\n\n**Available Plugins** \n(Note: plugins are just space seperated c filenames, from [plugins](/src/clubar/plugins/) directory, without file extension, see [examples](/examples).)\n\n- **luaconfig**: runtime config support with lua source file.\n- **xrmconfig**: runtime config support with X Resources.\n\nStyling text\n------------\n**Template for styling text**\n```text\n\u003cTag:Mod1|Mod2|...|Modn=Value\u003e Text \u003c/Tag\u003e\n```\n\n| Tag     | Modifiers                 | Value       | Description                                       |\n|---------|---------------------------|-------------|---------------------------------------------------|\n| Fn      | -                         | Number      | Index of 'fonts' array from configs (default: 0)  |\n| Fg      | -                         | Color       | Valid color name                                  |\n| Bg      | -                         | Color       | Valid color name                                  |\n| Box     | Left, Right, Top, Bottom  | Color:Size  | valid color name and size (default: 0) in pixels  |\n| BtnL    | Shift, Ctrl, Super, Alt   | Command     | Raw command                                       |\n| BtnM    | Shift, Ctrl, Super, Alt   | Command     | Raw command                                       |\n| BtnR    | Shift, Ctrl, Super, Alt   | Command     | Raw command                                       |\n| ScrlU   | Shift, Ctrl, Super, Alt   | Command     | Raw command                                       |\n| ScrlD   | Shift, Ctrl, Super, Alt   | Command     | Raw command                                       |\n\nExamples\n--------\n```xml\n\u003cFn=1\u003e\u003cFg=#131313\u003e Colored \u003c/Fg\u003e text with \u003cBg=#c6c6c6\u003e background\u003c/Bg\u003e\u003c/Fn\u003e.\n```\n```xml\n\u003cBox:Bottom=#ffffff:1\u003e underlined \u003c/Box\u003e text.\n\u003cBox:Top|Bottom|Left|Right=#ffffff:1\u003e Boxed in \u003c/Box\u003e text.\n```\n```xml\n\u003cBtnL=systemctl reboot\u003e reboot \u003c/BtnL\u003e\n\u003cBtnL:Ctrl|Shift=sudo -A reboot now\u003e reboot w/ confirmation \u003c/BtnL\u003e\n```\n```xml\n\u003cScrlU:Ctrl=amixer sset Master 5%+\u003e\n  \u003cScrlD:Ctrl=amixer sset Master 5%-\u003e\n    volume\n  \u003c/ScrlD\u003e\n\u003c/ScrlU\u003e\n```\n\nLicence:\n--------\n[GPLv3](https://gnu.org/licenses/gpl.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flycuid%2Fclubar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flycuid%2Fclubar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flycuid%2Fclubar/lists"}