This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

The ultimate DIY statusline generator for i3wm.


k5dstatus is in the early phases of development and will need some adjustments to get right. If you use k5dstatus, send me feedback!

k5dstatus is a statusline generator for i3 that you can use to display system information you may be interested in. i3 comes with i3status which has many limitations. It has no plugin interface. It has no support for events and relies on polling for all its information, which makes it surprisingly heavy on resources. It has a weird config file format that makes it difficult to configure.

Other projects have come along to make up for these weaknesses and many of them do a great job. k5dstatus is for users who want a more flexible statusline that can be achieved from editing options in a configuration file but without having to learn a complicated plugin api to create custom statusline entries.

This is accomplished by allowing users to update the statusline through interprocess communication using DBUS. k5dstatus exposes a DBUS service that you can use to update the statusline simply in pretty much any programming language and from any process (maybe even in a cron!).

  • No configuration file is required
  • Update the statusline from multiple processes
  • Update the statusline from any language (even from the command line!)
  • No complicated plugin api to learn

Relation to i3-dstatus

This project is a source fork and rewrite of i3-dstatus. It does not attempt to maintain compatibility or upstream pairing.


k5dstatus is on PyPI.

pip install k5dstatus

You’ll also need python-gobject and python-dbus from your package manager.


Use k5dstatus as your status command in your bar block like so:

bar {
    status_command k5dstatus clock


Generator scripts will look for ~/.k5dstatus.conf for configuration options. See k5dstatus.conf in the repo for an example. The configuration file should be a single YAML object. (More documentation to come).


Please report bugs, request feature, write documentation, and add generators to the k5dstatus/generators directory. k5dstatus is a community project so feedback is welcome!


This work is available under a FreeBSD License (see LICENSE).

Copyright © 2015, James Bliss

All rights reserved.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting