Calendar popup for awesome WM
Switch branches/tags
Nothing to show
Clone or download
coldfix Merge pull request #6 from macunha1/master
feat(color): Allow today to color be passed through constructor
Latest commit 00860a3 Oct 13, 2018


Small calendar popup for awesome window manager.


This is a polished up and improved module based on the calendar2.lua module by Bernd Zeimetz and Marc Dequènes.


Drop the script into your awesome config folder. Suggestion:

cd ~/.config/awesome
git clone


In your rc.lua:

-- load the widget code
local calendar = require("calendar")

-- attach it as popup to your text clock widget:

You can also add some options to customize the widget's display. For instance:

local calendar = require("calendar")
calendar_widget = calendar({
  fdow = 7,                  -- Set Sunday as first day of the week (default is
                             -- 1 = Monday)
  position = "bottom_right", -- Useful if you prefer your wibox at the bottomn
                             -- of the screen