Desktop elements

Elements

Did you press some random key combo and something weird appeared on your screen? It is probably one of the elements below.

Window switcher

• Activate it with super+tab. It will instantly take you to the previous window in history.
• Releasing super will hide it.
• It is fully clickable, and uses the same mousebinds set in keys.tasklist_buttons inside keys.lua.
• While visible, pressing tab, j or down arrow will start cycling through windows in the current tag.
• Cycle backwards with k or up arrow.
• Close the current window with d or q
• Minimize the current window with n.
• Unminimize a client with u, starting from the top of the list and moving downwards.

Dashboard

• Activate it with super+F1, or by middle clicking anywhere on the desktop.
• Dismiss with escape, q or F1 or middle click.
• You can scroll on the calendar to switch to the previous / next month. Left click to reset.
• Clicking the fortune box gives you a new fortune cookie :)
• The bell icon suspends / re-enables notifications on click.
• The camera icon takes a screenshot instantly on left click and with a 5 second delay on right click.

Sidebar

• Can be toggled with super+grave (grave is the key under Escape).
• Can be activated by moving the mouse to the edge of the screen and hidden by moving the mouse out of it (these settings can be easily enabled/disabled in your user preferences in rc.lua).
• By default it is always above windows, and does not grab your keyboard (so you can have it open while doing something else, or just toggle it for a second to check your battery while you are watching something in fullscreen).
• Most widgets (volume, search, exit, music...) are clickable.
• Volume and music update only when they need to, as they are subscribed to pulse and mpd events respectively.
• For the weather widget I modified this polybar custom script. It uses the openweathermap API.

Exit screen

• Activate it with super+escape, by clicking Exit on the sidebar, or in the right click menu (awesome -> quit)
• Mouse controls: Click on any icon to execute the command, right click or middle click anywhere to cancel.
• Keyboard controls:
  • escape or q or x to cancel
  • p to poweroff
  • r to reboot
  • s to suspend
  • e to exit (logout)
  • l to lock with the built-in lock screen