diff options
author | streetturtle <streetturtle@users.noreply.github.com> | 2022-01-23 19:45:41 -0500 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-01-23 19:45:41 -0500 |
commit | 3ec57a1d57a4ec122e2ac4fee2f113529566bcd8 (patch) | |
tree | a62afd98efcdbc3550db7cd0aa5b9e4cf538384c /cmus-widget/README.md | |
parent | 4066f673dbda4a733ac6d838bf04bff8682265c3 (diff) | |
parent | 56c8e3439b43f819f7a73bd075737ce93d38e5ef (diff) |
Merge pull request #331 from augustogunsch/cmus
Add cmus widget
Diffstat (limited to 'cmus-widget/README.md')
-rw-r--r-- | cmus-widget/README.md | 48 |
1 files changed, 48 insertions, 0 deletions
diff --git a/cmus-widget/README.md b/cmus-widget/README.md new file mode 100644 index 0000000..c24d975 --- /dev/null +++ b/cmus-widget/README.md @@ -0,0 +1,48 @@ +# Cmus widget + +Cmus widget that shows the current playing track. + +![widget](cmus-widget.png) + +Left click toggles playback. + +## Installation + +Clone the repo under **~/.config/awesome/** and add widget in **rc.lua**: + +```lua +local cmus_widget = require('awesome-wm-widgets.cmus-widget.cmus') +... +s.mytasklist, -- Middle widget + { -- Right widgets + layout = wibox.layout.fixed.horizontal, + ... + -- default + cmus_widget(), + -- customized + cmus_widget{ + space = 5, + timeout = 5 + }, +``` + +### Shortcuts + +To improve responsiveness of the widget when playback is changed by a shortcut use corresponding methods of the widget: + +```lua +awful.key({ modkey, "Shift" }, "p", function () cmus_widget:play_pause() end, {description = "play/pause cmus", group = "custom"}), +``` + +## Customization + +It is possible to customize the widget by providing a table with all or some of the following config parameters: + +### Generic parameter + +| Name | Default | Description | +|---|---|---| +| `font` | `Play 9` | Font used for the track title | +| `path_to_icons` | `/usr/share/icons/Arc/actions/symbolic/` | Alternative path for the icons | +| `timeout`| `10` | Refresh cooldown | +| `space` | `3` | Space between icon and track title | |