Welcome to bumblebee-status’s documentation!

bumblebee-status is a modular, theme-able status line generator for the i3 window manager.

Logo courtesy of [kellya](https://github.com/kellya) - thank you!

Focus is on:

• ease of use, sane defaults (no mandatory configuration file)

• custom modules: How to write a module

• custom themes: How to write a theme

I hope you like it and I appreciate any kind of feedback: bug reports, feature requests, etc. :)

Thanks a lot!

Required i3wm version	4.12+
Supported Python versions	3.8, 3.9, 3.10, 3.11
Supported FontAwesome versions	4 only
Per-module requirements	see List of modules

see FAQs for details on this

Example usage:

bar {
    status_command <path>/bumblebee-status \
     -m cpu memory battery time pasink pasource \
     -p time.format="%H:%M" \
     -t solarized
}

Thanks to [Sushants-Git](https://github.com/Sushants-Git), there is also a website where you can easily generate configurations: https://bumblebee-status-config-gen.netlify.app/

Contents

• Introduction
  • Installation
  • Dependencies
  • Usage
• Advanced usage
  • Intervals
  • Events
  • Update intervals
  • Errors
  • Automatically hiding modules
  • Scrolling widget text
  • Additional widget theme settings
  • Configuration files
• FAQs
  • The new version has broken my setup!
  • My bar doesn’t show any background colors
  • Some of the icons don’t render correctly
• List of modules
  • core
  • contrib
• List of available themes
• Developer’s Guide
  • General guidelines
  • How to write a module
  • How to write a theme
  • Testing guidelines
• API Reference
  • bumblebee_status package

Indices and tables

• Index

• Module Index

• Search Page