awesome-wm-widgets/cmus-widget
streetturtle 8439ca7930
Merge pull request #332 from augustogunsch/cmus
Cmus widget - fix unused "spacing" option
2022-04-15 17:30:55 -04:00
..
screenshots cmus: move screenshot to screenshots folder 2022-01-23 20:21:00 -05:00
README.md Merge pull request #332 from augustogunsch/cmus 2022-04-15 17:30:55 -04:00
cmus.lua Use default theme font instead 2022-01-24 12:02:55 -03:00

README.md

Cmus widget

Cmus widget that shows the current playing track.

widget

Left click toggles playback.

Installation

Clone the repo under ~/.config/awesome/ and add widget in rc.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:

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 beautiful.font Font name and size, like Play 12
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