{"id":13501483,"url":"https://github.com/tobi-wan-kenobi/bumblebee-status","last_synced_at":"2025-05-14T00:04:35.996Z","repository":{"id":37769998,"uuid":"72353166","full_name":"tobi-wan-kenobi/bumblebee-status","owner":"tobi-wan-kenobi","description":"bumblebee-status is a modular, theme-able status line generator for the i3 window manager.","archived":false,"fork":false,"pushed_at":"2025-04-12T16:09:37.000Z","size":3662,"stargazers_count":1254,"open_issues_count":11,"forks_count":229,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-05-10T21:02:29.786Z","etag":null,"topics":["gruvbox","hacktoberfest","i3bar","i3wm","nord","powerline","solarized"],"latest_commit_sha":null,"homepage":"https://bumblebee-status.readthedocs.io/en/main/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tobi-wan-kenobi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2016-10-30T14:07:20.000Z","updated_at":"2025-05-09T14:50:52.000Z","dependencies_parsed_at":"2023-02-02T20:31:41.141Z","dependency_job_id":"4356b7c3-d57e-4207-8abb-dfa14352503c","html_url":"https://github.com/tobi-wan-kenobi/bumblebee-status","commit_stats":{"total_commits":2243,"total_committers":194,"mean_commits":"11.561855670103093","dds":0.7137761925991974,"last_synced_commit":"ad8b1802f5e893a3754f3a2e2c7d3e4c606412b2"},"previous_names":[],"tags_count":41,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobi-wan-kenobi%2Fbumblebee-status","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobi-wan-kenobi%2Fbumblebee-status/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobi-wan-kenobi%2Fbumblebee-status/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tobi-wan-kenobi%2Fbumblebee-status/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tobi-wan-kenobi","download_url":"https://codeload.github.com/tobi-wan-kenobi/bumblebee-status/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254043271,"owners_count":22004913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gruvbox","hacktoberfest","i3bar","i3wm","nord","powerline","solarized"],"created_at":"2024-07-31T22:01:39.015Z","updated_at":"2025-05-14T00:04:35.916Z","avatar_url":"https://github.com/tobi-wan-kenobi.png","language":"Python","funding_links":[],"categories":["Python","Projects","Packages","Tool"],"sub_categories":["Bars, Panels, and Widgets","Desktop Extension Tool"],"readme":"\u003cimg src=\"https://github.com/kellya/bumblebee-status-icon/blob/main/img/bumblebee_status_rtl.svg\" width=\"50\" style=\"display:inline-block\"\u003ebumblebee-status\n=====================================================\n\nlogo courtesy of [kellya](https://github.com/kellya) - thank you!\n\n[![Documentation Status](https://readthedocs.org/projects/bumblebee-status/badge/?version=main)](https://bumblebee-status.readthedocs.io/en/main/?badge=main)\n![Commits since release](https://img.shields.io/github/commits-since/tobi-wan-kenobi/bumblebee-status/latest)\n![AUR version (release)](https://img.shields.io/aur/version/bumblebee-status)\n![AUR version (git)](https://img.shields.io/aur/version/bumblebee-status-git)\n![PyPI version](https://img.shields.io/pypi/v/bumblebee-status)\n![Contributors](https://img.shields.io/github/contributors-anon/tobi-wan-kenobi/bumblebee-status)\n[![Tests](https://github.com/tobi-wan-kenobi/bumblebee-status/actions/workflows/autotest.yml/badge.svg?branch=main)](https://github.com/tobi-wan-kenobi/bumblebee-status/actions/workflows/autotest.yml)\n\n[![Code Climate](https://codeclimate.com/github/tobi-wan-kenobi/bumblebee-status/badges/gpa.svg)](https://codeclimate.com/github/tobi-wan-kenobi/bumblebee-status)\n[![Test Coverage](https://codeclimate.com/github/tobi-wan-kenobi/bumblebee-status/badges/coverage.svg)](https://codeclimate.com/github/tobi-wan-kenobi/bumblebee-status/coverage)\n[![Issue Count](https://codeclimate.com/github/tobi-wan-kenobi/bumblebee-status/badges/issue_count.svg)](https://codeclimate.com/github/tobi-wan-kenobi/bumblebee-status)\n[![CodeQL](https://github.com/tobi-wan-kenobi/bumblebee-status/actions/workflows/codeql-analysis.yml/badge.svg?branch=main)](https://github.com/tobi-wan-kenobi/bumblebee-status/actions/workflows/codeql-analysis.yml)\n![License](https://img.shields.io/github/license/tobi-wan-kenobi/bumblebee-status)\n\n**Many, many thanks to all contributors! I am still amazed by and deeply grateful for how many PRs this project gets.**\n\n[Click here for a list of available modules](https://bumblebee-status.readthedocs.io/en/main/modules.html)\n\n![Solarized Powerline](screenshots/themes/powerline-solarized.png)\n\nbumblebee-status is a modular, theme-able status line generator for the [i3 window manager](https://i3wm.org/).\n\nFocus is on:\n* ease of use, sane defaults (no mandatory configuration file)\n* [easy creation of custom themes](https://bumblebee-status.readthedocs.io/en/main/development/theme.html)\n* [easy creation of custom modules](https://bumblebee-status.readthedocs.io/en/main/development/module.html)\n\nI hope you like it and I appreciate any kind of feedback: bug reports, feature requests, etc. :)\n\nThanks a lot!\n\nRequired i3wm version: 4.12+ (in earlier versions, blocks won't have background colors)\n\nSupported Python versions: 3.4, 3.5, 3.6, 3.7, 3.8, 3.9\n\nSupported FontAwesome version: 4 (free version of 5 doesn't include some of the icons)\n\n---\n***NOTE***\n\nThe default branch for this project is `main`. If you are curious why: [ZDNet:github-master-alternative](https://www.zdnet.com/article/github-to-replace-master-with-alternative-term-to-avoid-slavery-references/)\n\n---\n\nExample usage:\n\n```\nbar {\n\tstatus_command \u003cpath\u003e/bumblebee-status -m cpu memory battery time \\\n\t\tpasink pasource -p time.format=\"%H:%M\" -t solarized\n}\n```\n\n# Documentation\nSee [the docs](https://bumblebee-status.readthedocs.io) for detailed documentation.\n\nSee [FAQ](https://bumblebee-status.readthedocs.io/en/main/FAQ.html) for. well, FAQs.\n\nOther resources:\n\n* A list of [available modules](https://bumblebee-status.readthedocs.io/en/main/modules.html)\n* [How to write a module](https://bumblebee-status.readthedocs.io/en/main/development/module.html)\n* [How to write a theme](https://bumblebee-status.readthedocs.io/en/main/development/theme.html)\n\n# Installation\n```\n# from git (development snapshot)\n$ git clone git://github.com/tobi-wan-kenobi/bumblebee-status\n\n# from AUR:\ngit clone https://aur.archlinux.org/bumblebee-status.git\ncd bumblebee-status\nmakepkg -sicr\n\n# from PyPI (thanks @tony):\n# will install bumblebee-status into ~/.local/bin/bumblebee-status\npip install --user bumblebee-status\n```\n\nThere is also a SlackBuild available here: [slackbuilds:bumblebee-status](http://slackbuilds.org/repository/14.2/desktop/bumblebee-status/) - many thanks to [@Tonus1](https://github.com/Tonus1)!\n\nAn ebuild, for Gentoo Linux, is available on [gallifrey overlay](https://github.com/fedeliallalinea/gallifrey/tree/master/x11-misc/bumblebee-status). Instructions for adding the overlay can be found [here](https://github.com/fedeliallalinea/gallifrey/blob/master/README.md).\n\nbumblebee-status is also avaliable in nixpkgs unstable channel- many thanks to [@augustebaum][https://github.com/augustebaum]!\n\nFor installing from nixpkgs, add the following snippet into your `configuration.nix`:\n\n```nix\n{\n  environment.systemPackages = with pkgs; [\n      (bumblebee-status.override{plugins = p:[p.cpu];})\n  ];\n}\n```\nreplace `[p.cpu]` with the list of plugins that you want to use.\n\n# Dependencies\n[Available modules](https://bumblebee-status.readthedocs.io/en/main/modules.html) lists the dependencies (Python modules and external executables)\nfor each module. If you are not using a module, you don't need the dependencies.\n\nSome themes (e.g. all ‘powerline’ themes) require Font Awesome http://fontawesome.io/ and a powerline-compatible font (powerline-fonts) https://github.com/powerline/fonts\n\n# Usage\n## Normal usage\nIn your i3wm configuration, modify the *status_command* for your i3bar like this:\n\n```bash\nbar {\n\tstatus_command \u003cpath to bumblebee-status/bumblebee-status\u003e \\\n\t\t-m \u003clist of modules\u003e \\\n\t\t-p \u003clist of module parameters\u003e \\\n\t\t-t \u003ctheme\u003e\n}\n```\n\nYou can retrieve a list of modules (and their parameters) and themes by entering:\n```bash\n$ cd bumblebee-status\n$ ./bumblebee-status -l themes\n$ ./bumblebee-status -l modules\n```\n\nTo change the update interval, use:\n```bash\n$ ./bumblebee-status -m \u003clist of modules\u003e -p interval=\u003cinterval in seconds\u003e\n```\n\nThe update interval can also be changed on a per-module basis, like this:\n```bash\n$ ./bumblebee-status -m cpu memory -p cpu.interval=5s memory.interval=1m\n```\n\nAll modules can be given \"aliases\" using `\u003cmodule name\u003e:\u003calias\u003e`, by which they can be parametrized, for example:\n\n```bash\n$ ./bumblebee-status -m disk:root disk:home -p root.path=/ home.path=/home\n```\n\nAs a simple example, this is what my i3 configuration looks like:\n\n```bash\nbar {\n\tfont pango:Inconsolata 10\n\tposition top\n\ttray_output none\n\tstatus_command ~/.i3/bumblebee-status/bumblebee-status -m nic disk:root cpu \\\n\t\tmemory battery date time pasink pasource dnf \\\n\t\t-p root.path=/ time.format=\"%H:%M CW %V\" date.format=\"%a, %b %d %Y\" \\\n\t\t-t solarized-powerline\n}\n\n```\n\nRestart i3wm and - that's it!\n\n# Examples\n\n[List of themes](https://bumblebee-status.readthedocs.io/en/main/themes.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobi-wan-kenobi%2Fbumblebee-status","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftobi-wan-kenobi%2Fbumblebee-status","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftobi-wan-kenobi%2Fbumblebee-status/lists"}