statusline

0.1.13 • Public • Published

statusline

This project is in development

Statusline is modular status line for use with i3bar, tmux, etc.

Screenshot

My config

Usage

Installation

sudo npm install -g statusline

Using within i3bar

In ~/.i3/config find status_command and set it to statusline i3status.

Configuration

Your default config will be stored in: ~/.statusline.conf when you run statusline i3config for the first time.

Features

  • Package manager (for installing packets inside users home, npm based)

Example block: https://github.com/statusline/statusline-block-time

To installe block, run:

statusline install block-time

Note: Do not type statusline- on the beggining of package name.

  • Block API for writing custom blocks (able to handle click events)

Blocks available so far: ip, load, time, date, battery

I was thinking about giving options object to package function and getting back object with default output and object for templating engine, for user defined text.

If you are developing block, keep in mind Promise may get replaced with EventEmmiter at a point in time...

  • Middleware API for writing middleware that can alter final output

  • Command API for creating output for different applications, for example tmux status...

Only i3status available. It is built in.

  • Config system

Something like this for now

{
    "blocks": [
        {
            "name": "battery",
            "backgroundColor": "#000",
            "color": "#fff",
            "customOptions": {
                "battery": "BAT0"
            }
        }
    ],
    "middleware": [
        {
            "middleware": "powerlineSeparator"
        }
    ]
}
  • Async rendering and error handling

Package naming

When creating package, it is important to follow naming convention.

NPM package name should be: statusline-[block/middleware/command]-name.

Credits

nemanjan00

Package Sidebar

Install

npm i statusline

Weekly Downloads

5

Version

0.1.13

License

MIT

Last publish

Collaborators

  • nemanjan00