Awesome - Revision history

Souheab: Added information about using a flake to install the development build of AwesomeWM. Additonally for transparency's sake I would like to mention that I am the developer of the flake mentioned here.

2025-12-01T20:22:43Z

Added information about using a flake to install the development build of AwesomeWM. Additonally for transparency's sake I would like to mention that I am the developer of the flake mentioned here.

← Older revision		Revision as of 20:22, 1 December 2025
Line 43:		Line 43:
	}}		}}

			== AwesomeWM Flake ==
			If you wish to run the development build of AwesomeWM (i.e. the source code at the git master branch), you can use a flake as shown below:
			{{File\|3={
			inputs = {
			# ...
			awesome-flake.url = "github:Souheab/awesomewm-git-nix-flake";
			};
			outputs = {nixpkgs, ...} @ inputs: {
			nixosConfigurations.YOUR_HOSTNAME = nixpkgs.lib.nixosSystem {
			specialArgs = { inherit inputs; };
			modules = [
			./configuration.nix
			# ...
			];
			};
			};
			}\|name=flake.nix\|lang=nix}}
			And here's how you can install the package:
			{{File\|3={inputs, pkgs, ...}: {
			services.xserver = {
			enable = true;
			windowManager.awesome = {
			enable = true;
			package = inputs."awesome-flake".packages.${pkgs.stdenv.hostPlatform.system}.default;
			};
			};
			}\|name=configuration.nix\|lang=nix}}
			Note: This uses an unofficial third party flake which is not officially associated with the AwesomeWM project

			Flake reference: https://github.com/Souheab/awesomewm-git-nix-flake

	== References ==		== References ==

Phanirithvij: examples from old wiki

2025-03-13T03:57:54Z

examples from old wiki

← Older revision		Revision as of 03:57, 13 March 2025
Line 23:		Line 23:
	luaModules = with pkgs.luaPackages; [		luaModules = with pkgs.luaPackages; [
	# add any lua packages required by your configuration here		# add any lua packages required by your configuration here
			luarocks # is the package manager for Lua modules
			luadbi-mysql # Database abstraction layer
	];		];

	};		};
	};		};

AveryKoen: Now this page is not dead-end, heh. I added a link to the Home Manager page.

2024-12-30T20:11:20Z

Now this page is not dead-end, heh. I added a link to the Home Manager page.

← Older revision		Revision as of 20:11, 30 December 2024
Line 33:		Line 33:
	}}		}}

	Similar configuration using ~~home-manager~~		Similar configuration using [[Home Manager]].

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

NobbZ at 17:59, 25 June 2024

2024-06-25T17:59:10Z

← Older revision		Revision as of 17:59, 25 June 2024
Line 22:		Line 22:
	enable = true;		enable = true;
	luaModules = with pkgs.luaPackages; [		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~~
	];		];

Denperidge: Updated example for NixOS 24.05. Using the syntax used before the edit will result in "trace: warning: The option `services.xserver.displayManager.sddm.enable' defined in `/etc/nixos/configuration.nix' has been renamed to `services.displayManager.sddm.enable'. "

2024-06-02T18:17:36Z

Updated example for NixOS 24.05. Using the syntax used before the edit will result in "trace: warning: The option `services.xserver.displayManager.sddm.enable' defined in `/etc/nixos/configuration.nix' has been renamed to `services.displayManager.sddm.enable'. "

← Older revision		Revision as of 18:17, 2 June 2024
Line 11:		Line 11:

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

	services.xserver = {		services.xserver = {
	enable = true;		enable = true;


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

	windowManager.awesome = {		windowManager.awesome = {

imported>Nix: change to Applications subcategory

2021-09-20T05:31:30Z

change to Applications subcategory

← Older revision		Revision as of 05:31, 20 September 2021
Line 51:		Line 51:

	[[Category:Window managers]]		[[Category:Window managers]]
	[[Category:~~Software~~]]		[[Category:Applications]]

imported>Nix: add Software category

2021-09-20T05:29:30Z

add Software category

← Older revision		Revision as of 05:29, 20 September 2021
Line 51:		Line 51:

	[[Category:Window managers]]		[[Category:Window managers]]
			[[Category:Software]]

imported>Artturin: add to window managers

2020-11-19T03:12:40Z

add to window managers

← Older revision		Revision as of 03:12, 19 November 2020
Line 50:		Line 50:
	* [https://awesomewm.org/apidoc/documentation/05-awesomerc.md.html#3 Default configuration file documentation]		* [https://awesomewm.org/apidoc/documentation/05-awesomerc.md.html#3 Default configuration file documentation]

	[[Category:~~Guide~~]]		[[Category:Window managers]]

imported>B1ackshadow at 18:39, 27 June 2020

2020-06-27T18:39:58Z

← Older revision		Revision as of 18:39, 27 June 2020
Line 3:		Line 3:
	== Enabling ==		== 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\|		{{file\|/etc/nixos/configuration.nix\|nix\|

imported>B1ackshadow: Created page with "[https://awesomewm.org/ awesome] is a highly configurable, next generation framework window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 licens..."

2020-06-27T18:38:56Z

Created page with "[https://awesomewm.org/ awesome] is a highly configurable, next generation framework window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 licens..."

New page

[https://awesomewm.org/ 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 <code>services.xserver.windowManager.i3.enable</code> to <code>true</code>. For example:

{{file|/etc/nixos/configuration.nix|nix|
<nowiki>
{ config, pkgs, ... }:

...
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
luadbi-mysql # Database abstraction layer
];

};
};
...
}

</nowiki>
}}

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 [https://awesomewm.org/apidoc/sample%20files/rc.lua.html# rc.lua] which is generated at
<code>/run/current-system/sw/etc/xdg/awesome/rc.lua</code>. Copy the file to <code>~/.config/awesome/</code> and make changes.
}}

== References ==

* [https://awesomewm.org/apidoc/documentation/07-my-first-awesome.md.html# Getting started]
* [https://awesomewm.org/apidoc/documentation/05-awesomerc.md.html#3 Default configuration file documentation]

[[Category:Guide]]