{"id":15148730,"url":"https://github.com/ryanflannery/oxbar","last_synced_at":"2025-07-23T02:04:18.785Z","repository":{"id":139296443,"uuid":"147897260","full_name":"ryanflannery/oxbar","owner":"ryanflannery","description":"configurable X11 status bar for OpenBSD (and xstatbar successor)","archived":false,"fork":false,"pushed_at":"2024-12-07T03:48:59.000Z","size":11197,"stargazers_count":48,"open_issues_count":9,"forks_count":2,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-06T22:51:21.675Z","etag":null,"topics":["bsd","cairo","openbsd","pango","statusbar","xcb"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ryanflannery.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2018-09-08T03:23:27.000Z","updated_at":"2025-02-11T13:14:19.000Z","dependencies_parsed_at":"2024-01-27T11:12:49.630Z","dependency_job_id":"4df857dd-e213-4793-bb5c-1fb340c9c986","html_url":"https://github.com/ryanflannery/oxbar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ryanflannery/oxbar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanflannery%2Foxbar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanflannery%2Foxbar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanflannery%2Foxbar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanflannery%2Foxbar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ryanflannery","download_url":"https://codeload.github.com/ryanflannery/oxbar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ryanflannery%2Foxbar/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266604004,"owners_count":23954724,"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-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["bsd","cairo","openbsd","pango","statusbar","xcb"],"created_at":"2024-09-26T13:22:11.015Z","updated_at":"2025-07-23T02:04:18.766Z","avatar_url":"https://github.com/ryanflannery.png","language":"C","funding_links":[],"categories":["Packages"],"sub_categories":["Bars, Panels, and Widgets"],"readme":"# oxbar\noxbar is a X11 status bar for OpenBSD showing various system stats.\nIt has a configurable display and works out-of-the-box on most modern window\nmanagers in an intuitive fashion.\noxbar supports FreeType font rendering and styling, true transparency \u0026 alpha\nblending on all UI components (including the root window), and a simple\nconfiguration format that can concisely support multiple themes.\n\nIt's motivated by the frequent complaints/threats I get about\nmy old xstatbar and its many hacks. Shaming works 'yo.\n\noxbar is released under an\n[ISC license](https://github.com/ryanflannery/oxbar/blob/master/LICENSE)\n\n![screenshot](images/fullscreen.png?raw=true)\n\n\n# features\n* True transparency support with a compositing window manager\n   * I recommend compton (in ports) over xcompmgr (in base)\n* FreeType fonts styled \u0026 rendered easily, with all font options\n* Fully configurable display via the command line or config file\n* Left/Right/Center aligned widgets, and any combination of those\n* Configuration file supports multiple themes that can be chosen at runtime\n* Types of stats supported:\n   * Battery/AC status, progress bar, time remaining\n   * Brightness level w/ progress bar (via Xrandr(3))\n   * Volume level w/ progress bar\n   * Number of processes\n   * Memory usage \u0026 breakdown\n   * CPUs usage \u0026 breakdown w/ or w/out charts\n   * WiFi signal strength\n   * Current date/time (is that a status?)\n   * Others forthcoming\n\n\n# more screenshots\noxbar's default look (with no options):\n![default](images/theme-default.png?raw=true)\n\nOther themes, all included in the file\n[sample.oxbar.conf](sample.oxbar.conf):\n\n**islands**: each widget is an island, with true transparency between\n![islands](images/theme-islands.png?raw=true)\n\n**islands-colorful**: like islands, but each widget is a different color\n![islands-colorful](images/theme-islands-colorful.png?raw=true)\n\n**minimal**: a dark, text only display\n![minimal](images/theme-minimal.png?raw=true)\n\n**pastels**: a pastel based theme with widgets tightly packed\n![pastels](images/theme-pastels.png?raw=true)\n\n**ryan**: what my setup looks like\n![ryan](images/theme-ryan.png?raw=true)\n\n**xstatbar**: looks just like it's predecessor\n![xstatbar](images/theme-xstatbar.png?raw=true)\n\n\n# installing\nThere is no port/package (yet), as oxbar is still under active development.\nTo build \u0026 install, you'll need to first install 2 dependencies, pango and\ncairo, and then clone this repo and run `make install`.\n\nRoughly:\n```bash\n $ doas pkg_add pango cairo      # install dependencies (as root)\n $ make                          # build oxbar\n $ doas make install             # install globally (as root)\n -or-\n $ PREFIX=~/local make install   # install local to a user (or anywhere)\n```\n\n\n# usage\nFull man page available here:\n[oxbar(1)](http://htmlpreview.github.io/?https://raw.githubusercontent.com/ryanflannery/oxbar/master/man/oxbar.html).\n\n`oxbar -H` also has a brief description of each command line flag.\nSee the sample configuration [sample.oxbar.conf](sample.oxbar.conf) for\nexamples, like the themes above.\n\n\n# i liked xstatbar's look\nYou can achieve that using the included sample configuration file, saved as\n`~/.oxbar.conf`, and run oxbar via:\n```bash\noxbar xstatbar\n```\n\n\n# outstanding stuff, prioritized\nSee the [TODO](TODO) file for various TODO's present throughout the code.\n\nIn addition, more long-term stuff I'd like to do, by my priority...\n* big refactor: make all widgets 100% config-driven... Basically, eliminate\n  the need for individual widget code in `widgets/` entirely, and make them\n  all configurable via a simple syntax. I know how to do most of this, and\n  easily from a configuration standpoint, but not all. My current thoughts\n  would make the configuration too verbose/lengthy, and impractical. Chew on\n  this more, I will...\n* gui: icons in the display could help condense it further\n* stats: add collector for hw.sensors \u0026 a related widget\n* stats: add a weather component...i like weather\n* when using compton, need '--shadow-exclude 'name = \"oxbar\"' to disable\n  shadow - how can i automate that?\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryanflannery%2Foxbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fryanflannery%2Foxbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fryanflannery%2Foxbar/lists"}