awesome-wm-widgets/fs-widget
Nuno Silva 2717d15af5 fix SI prefixes
- lower 'm' is milli, not mega
- lower 'g' is unassigned
- 'G' is 10^9, 'Gi' is 2^30

see https://en.wikipedia.org/wiki/Metric_prefix
2023-11-18 17:08:39 +00:00
..
README.md Fix documentation inconsistencies (mainly tables) 2023-09-20 23:01:55 +01:00
fs-widget.lua fix SI prefixes 2023-11-18 17:08:39 +00:00
screenshot.png [fs] fix #218 2020-11-30 09:31:44 -05: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
  ...