dotfiles/awesome/awesome-wm-widgets/fs-widget
ngoomie 3e454a4b0e WM config stuff 2023-04-19 22:08:44 -06:00
..
README.md WM config stuff 2023-04-19 22:08:44 -06:00
fs-widget.lua WM config stuff 2023-04-19 22:08:44 -06:00
screenshot.png WM config stuff 2023-04-19 22:08:44 -06:00

README.md

Filesystem Widget

This widget shows file system disk space usage which is based on the df output. When clicked another widget appears with more detailed information. By default, it monitors the "/" mount. It can be configured with a list of mounts to monitor though only the first will show in the wibar. To have multiple mounts displayed on the wibar simply define multiple fs_widgets with different mounts as arguments.

Customizations

It is possible to customize widget by providing a table with all or some of the following config parameters:

Name Default Description
mounts {'/'} Table with mounts to monitor, check the output from a df command for available options (column 'Mounted on')
timeout 60 How often in seconds the widget refreshes

Installation

Clone/download repo and use the widget in rc.lua:

  local fs_widget = require("awesome-wm-widgets.fs-widget.fs-widget")
  ...
  s.mywibox:setup {
      s.mytasklist, -- Middle widget
      { -- Right widgets
      fs_widget(), --default
      fs_widget({ mounts = { '/', '/mnt/music' } }), -- multiple mounts
  ...