Skip to content menu and desktop icons support for Awesome WM
Branch: master
Clone or download
Pull request Compare This branch is 35 commits ahead, 3 commits behind terceiro:master.
lcpz Merge pull request #12 from Sorky/patch-1
Hold the generated menu in the module
Latest commit 3f2d23c Nov 10, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.rst update references Oct 7, 2017
awesome-freedesktop-scm-1.rockspec updated LuaRocks spec Oct 16, 2018
desktop.lua menu: fix elimination of null paths; removed whitespaces; closes #11 Oct 16, 2018
menu.lua Hold the generated menu in the module Nov 10, 2018
screenshot.png updated LuaRocks spec Oct 16, 2018


Awesome-Freedesktop menu and desktop icons support for Awesome WM 4.x

Original author:Antonio Terceiro
Maintainer:Luca CPZ
Version: git


This is a port of awesome-freedesktop to Awesome 4.x.

See branches for previous versions.

Since the introduction of Menubar as core library for providing menu functionalities in Awesome, we can now avoid all the dirty work by just exploiting menubar.utils functions.

At the initial status of this port, the menu is pretty much complete, while the desktop icons are very basic, so the long term objective will be to complete functionalities on this part too.

More specifically, the todo list is:

  • A better way to handle desktop icons path
  • Ability to drag and line up icons
  • Event-based signals, in particular:
    • Updating trash icon according to its status
    • Dynamic update (no need to restart Awesome to see changes on desktop)


Showcase of Freedesktop support in Awesome, using Adwaita icons

Installation and usage

Read the wiki.

You can’t perform that action at this time.