4 -------------------------------------------------------------------
5 Freedesktop.org menu and desktop icons support for Awesome WM 4.x
6 -------------------------------------------------------------------
8 :Original author: Antonio Terceiro
12 :Source: https://github.com/lcpz/awesome-freedesktop
17 This is a port of awesome-freedesktop_ to Awesome_ 4.x.
19 See branches_ for previous versions.
21 Since the introduction of Menubar_ as core library for providing Freedesktop.org menu functionalities in Awesome,
22 we can now avoid all the dirty work by just exploiting ``menubar.utils`` functions.
24 At the initial status of this port, the menu is pretty much complete, while the desktop icons are very basic,
25 so the long term objective will be to complete functionalities on this part too.
27 More specifically, the todo list is:
29 - A better way to handle desktop icons path
30 - Ability to drag and line up icons
31 - Event-based signals, in particular:
32 - Updating trash icon according to its status
33 - Dynamic update (no need to restart Awesome to see changes on desktop)
38 .. image:: screenshot.png
40 :alt: Showcase of Freedesktop support in Awesome, using Adwaita icons
42 Installation and usage
43 ----------------------
47 .. _GNU-GPL2: http://www.gnu.org/licenses/gpl-2.0.html
48 .. _awesome-freedesktop: https://github.com/terceiro/awesome-freedesktop
49 .. _Awesome: https://github.com/awesomeWM/awesome
50 .. _branches: https://github.com/lcpz/awesome-freedesktop/branches
51 .. _Menubar: https://github.com/awesomeWM/awesome/tree/master/lib/menubar
52 .. _wiki: https://github.com/lcpz/awesome-freedesktop/wiki