About
=====
This project aims to add support for freedesktop.org compliant desktop entries
and menu.
Installation
============
Just drop freedesktop/ folder in your ~/.config/awesome/ directory.
Main features
=============
* a freedesktop.org-compliant (or almost) applications menu
* a freedesktop.org-compliant (or almost) desktop
* a (yet limited) icon lookup function.
Usage example
=============
You can use the frerdesktop module in your awesome configuration
(~/.config/awesome/rc.lua) like this:
-- applications menu
require('freedesktop.utils')
freedesktop.utils.terminal = terminal -- default: "xterm"
freedesktop.utils.icon_theme = 'gnome' -- look inside /usr/share/icons/, default: nil (don't use icon theme)
require('freedesktop.menu')
require("debian.menu")
menu_items = freedesktop.menu.new()
myawesomemenu = {
{ "manual", terminal .. " -e man awesome", freedesktop.utils.lookup_icon({ icon = 'help' }) },
{ "edit config", editor_cmd .. " " .. awful.util.getdir("config") .. "/rc.lua", freedesktop.utils.lookup_icon({ icon = 'package_settings' }) },
{ "restart", awesome.restart, freedesktop.utils.lookup_icon({ icon = 'gtk-refresh' }) },
{ "quit", awesome.quit, freedesktop.utils.lookup_icon({ icon = 'gtk-quit' }) }
}
table.insert(menu_items, { "awesome", myawesomemenu, beautiful.awesome_icon })
table.insert(menu_items, { "open terminal", terminal, freedesktop.utils.lookup_icon({icon = 'terminal'}) })
table.insert(menu_items, { "Debian", debian.menu.Debian_menu.Debian, freedesktop.utils.lookup_icon({ icon = 'debian-logo' }) })
mymainmenu = awful.menu.new({ items = menu_items, width = 150 })
mylauncher = awful.widget.launcher({ image = beautiful.awesome_icon,
menu = mymainmenu })
-- desktop icons
require('freedesktop.desktop')
for s = 1, screen.count() do
freedesktop.desktop.add_applications_icon({screen = s, showlabels = true})
freedesktop.desktop.add_dirs_and_files_icon({screen = s, showlabels = true})
end
bellthoven/awesome-freedesktop
freedesktop.org menu and desktop files specifications support for the awesome window manager
Lua