.config/awesome/freedesktop/README.rst

   1 Awesome-Freedesktop
   2 ===================
   3
   4 -------------------------------------------------------------------
   5 Freedesktop.org menu and desktop icons support for Awesome WM 4.x
   6 -------------------------------------------------------------------
   7
   8 :Original author: Antonio Terceiro
   9 :Maintainer: Luca CPZ
  10 :Version: git
  11 :License: GNU-GPL2_
  12 :Source: https://github.com/lcpz/awesome-freedesktop
  13
  14 Description
  15 -----------
  16
  17 This is a port of awesome-freedesktop_ to Awesome_ 4.x.
  18
  19 See branches_ for previous versions.
  20
  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.
  23
  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.
  26
  27 More specifically, the todo list is:
  28
  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)
  34
  35 Screenshot
  36 ----------
  37
  38 .. image:: screenshot.png
  39     :align: center
  40     :alt: Showcase of Freedesktop support in Awesome, using Adwaita icons
  41
  42 Installation and usage
  43 ----------------------
  44
  45 Read the wiki_.
  46
  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