Awesome: Difference between revisions

Latest revision as of 17:59, 25 June 2024

awesome is a highly configurable, next generation framework window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 license.

Enabling

To enable awesomeWM set services.xserver.windowManager.awesome.enable to true. For example:

/etc/nixos/configuration.nix

{ config, pkgs, ... }: 


  ...
  services.displayManager = {
    sddm.enable = true;
    defaultSession = "none+awesome";
  };

  services.xserver = {
    enable = true;

    windowManager.awesome = {
      enable = true;
      luaModules = with pkgs.luaPackages; [
        # add any lua packages required by your configuration here
      ];

    };
  };
  ...
}

Similar configuration using home-manager

Reference: https://github.com/rycee/home-manager/blob/master/modules/services/window-managers/awesome.nix#blob-path

Tip

Awesome provides a default config file rc.lua which is generated at /run/current-system/sw/etc/xdg/awesome/rc.lua. Copy the file to ~/.config/awesome/ and make changes.

References

@@ Line 3: / Line 3: @@
 == Enabling ==
-To enable awesomeWM set <code>services.xserver.windowManager.i3.enable</code> to <code>true</code>. For example:
+To enable awesomeWM set <code>services.xserver.windowManager.awesome.enable</code> to <code>true</code>. For example:
 {{file|/etc/nixos/configuration.nix|nix|
@@ Line 11: / Line 11: @@
    ...
+  services.displayManager = {
+    sddm.enable = true;
+    defaultSession = "none+awesome";
+  };
    services.xserver = {
      enable = true;
-    displayManager = {
-        sddm.enable = true;
-        defaultSession = "none+awesome";
-    };
      windowManager.awesome = {
        enable = true;
        luaModules = with pkgs.luaPackages; [
-         luarocks # is the package manager for Lua modules
+         # add any lua packages required by your configuration here
-        luadbi-mysql # Database abstraction layer
        ];
@@ Line 50: / Line 48: @@
 * [https://awesomewm.org/apidoc/documentation/05-awesomerc.md.html#3 Default configuration file documentation]
-[[Category:Guide]]
+[[Category:Window managers]]
+[[Category:Applications]]