XMonad - Revision history

Pigs: /* Adding Haskell Modules */ fix typo

2025-05-12T05:51:57Z

Adding Haskell Modules: fix typo

← Older revision		Revision as of 05:51, 12 May 2025
Line 32:		Line 32:
	services.xserver.windowManager.xmonad = {		services.xserver.windowManager.xmonad = {
	...		...
	~~extra-packages~~ = haskellPackages: [		extraPackages = haskellPackages: [
	haskellPackages.monad-logger		haskellPackages.monad-logger
	];		];

Pigs: Includes more configuration details, improve formatting, and fix broken link

2025-04-17T06:38:27Z

Includes more configuration details, improve formatting, and fix broken link

← Older revision		Revision as of 06:38, 17 April 2025
Line 11:		Line 11:
	You probably also want to activate the <code>enableContribAndExtras</code> option.		You probably also want to activate the <code>enableContribAndExtras</code> option.

			{{file\|/etc/nixos/configuration.nix\|nix\|
			<nowiki>
	services.xserver.windowManager.xmonad = {		services.xserver.windowManager.xmonad = {
	enable = true;		enable = true;
	enableContribAndExtras = true;		enableContribAndExtras = true;
	};		};
			</nowiki>
			}}

	The second options automatically adds the <code>xmonad-contrib</code> and <code>xmonad-extras</code> packages.		The second options automatically adds the <code>xmonad-contrib</code> and <code>xmonad-extras</code> packages.
	They are required to use the [https://hackage.haskell.org/package/xmonad-contrib Xmonad Contrib] extensions.		They are required to use the [https://hackage.haskell.org/package/xmonad-contrib Xmonad Contrib] extensions.

	~~To add~~ Haskell ~~modules that are not included in the Xmonad-Contrib package, you have to tell ghc where to find them.~~		=== Adding Haskell Modules ===
	~~For example, you can use the following to add the [https://github.com/Procrat/xmonad-contexts\|xmonad-contexts] module.~~

	<~~syntaxHighlight lang~~="nix">		To add additional Haskell modules beyond xmonad-contrib and xmonad-extras, use the <code>extraPackages</code> option

			{{file\|/etc/nixos/configuration.nix\|nix\|
			<nowiki>
			...
			services.xserver.windowManager.xmonad = {
			...
			extra-packages = haskellPackages: [
			haskellPackages.monad-logger
			];
			};
			</nowiki>
			}}

			To add Haskell modules that are not in the Haskell Nix package set, you have to tell ghc where to find them.
			For example, you can use the following to add the [https://github.com/Procrat/xmonad-contexts xmonad-contexts] module.

			{{file\|/etc/nixos/configuration.nix\|nix\|
			<nowiki>
			{ config, pkgs, ... }:
			let
			xmonad-contexts = pkgs.fetchFromGitHub {
			owner = "Procrat";
			repo = "xmonad-contexts";
			rev = "SOME_COMMIT_HASH"; # replace with an actual commit for reproducibility
			sha256 = "sha256-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
			};
			in {
			...
			services.xserver.windowManager.xmonad = {
			...
			ghcArgs = [
			"-hidir /tmp" # place interface files in /tmp, otherwise ghc tries to write them to the nix store
			"-odir /tmp" # place object files in /tmp, otherwise ghc tries to write them to the nix store
			"-i${xmonad-contexts}" # tell ghc to search in the respective nix store path for the module
			];
			};
			}
			</nowiki>
			}}

			or if you are using Flakes

			{{file\|/etc/nixos/configuration.nix\|nix\|
			<nowiki>
	{ xmonad-contexts, ... }:		{ xmonad-contexts, ... }:
	{		{
	...		...
	services.xserver.windowManager.xmonad = {		services.xserver.windowManager.xmonad = {
	...		...
Line 35:		Line 82:
	};		};
	}		}
	</~~syntaxHighlight~~>		</nowiki>
			}}

	Don't forget to add the module to your inputs:		Don't forget to add the module to your flake inputs:

	<~~syntaxHighlight lang="nix"~~>		{{file\|/etc/nixos/flake.nix\|nix\|
			<nowiki>
	inputs.xmonad-contexts = {		inputs.xmonad-contexts = {
	url = "github:Procrat/xmonad-contexts";		url = "github:Procrat/xmonad-contexts";
	flake = false;		flake = false;
	};		};
	</~~syntaxHighlight~~>		</nowiki>
			}}

	== Configuration ==		== Configuration ==

	~~To configure Xmonad you~~ give Nix your config file like this:		<code>$HOME/.xmonad</code> is the default path used for the configuration file. If your configuration is in a different location, give Nix your Xmonad config file like this:

			{{file\|/etc/nixos/configuration.nix\|nix\|
			<nowiki>
			services.xserver.windowManager.xmonad = {
			...
			config = builtins.readFile ../path/to/xmonad.hs;
			};
			</nowiki>
			}}

	~~<syntaxHighlight lang~~=~~"nix">~~		See [https://search.nixos.org/options?query=services.xserver.windowManager.xmonad services.xserver.windowManager.xmonad] for a full list of available options and their descriptions.
	services.xserver.windowManager.xmonad.~~config = builtins.readFile~~ ..~~/path/to/~~xmonad.~~hs;~~
	~~</syntaxHighlight>~~

	More information on how to configure Xmonad can be found in the [https://wiki.archlinux.org/title/Xmonad Arch Wiki], and a list of starter configs can be found in the [https://wiki.haskell.org/Xmonad/Config_archive Xmonad Config Archive].		More information on how to configure Xmonad can be found in the [https://wiki.archlinux.org/title/Xmonad Arch Wiki], and a list of starter configs can be found in the [https://wiki.haskell.org/Xmonad/Config_archive Xmonad Config Archive].
Line 119:		Line 176:
	</syntaxhighlight>		</syntaxhighlight>

	=== Developer Environment for XMonad ===		== Developer Environment for XMonad ==

	When developing modules for XMonad, it can help to install the following packages		When developing modules for XMonad, it can help to install the following packages

H7x4: Add a few links

2024-09-15T23:17:36Z

Add a few links

← Older revision		Revision as of 23:17, 15 September 2024
Line 1:		Line 1:
	[https://xmonad.org/ xmonad] is a tiling [https://wiki.archlinux.org/title/Window_manager window manager] for X. Windows are arranged automatically to tile the screen without gaps or overlap, maximizing screen use. Window manager features are accessible from the keyboard: a mouse is optional.		[https://xmonad.org/ xmonad] is a tiling [https://wiki.archlinux.org/title/Window_manager window manager] for [[Xorg\|X]]. Windows are arranged automatically to tile the screen without gaps or overlap, maximizing screen use. Window manager features are accessible from the keyboard: a mouse is optional.

	xmonad is written, configured and extensible in [~~https://haskell.org/~~ Haskell]. Custom layout algorithms, key bindings and other extensions may be written by the user in configuration files.		xmonad is written, configured and extensible in [[Haskell]]. Custom layout algorithms, key bindings and other extensions may be written by the user in configuration files.

	Layouts are applied dynamically, and different layouts may be used on each workspace. [[Wikipedia:Xinerama\|Xinerama]] is fully supported, allowing windows to be tiled on several physical screens.		Layouts are applied dynamically, and different layouts may be used on each workspace. [[Wikipedia:Xinerama\|Xinerama]] is fully supported, allowing windows to be tiled on several physical screens.
Line 59:		Line 59:

	Xmonad is a Window Manager (WM) and not a Desktop Environment (DE). Therefore, among other things,		Xmonad is a Window Manager (WM) and not a Desktop Environment (DE). Therefore, among other things,
	Xmonad does not handle power management related things such as sleeping.		Xmonad does not handle [[Power Management\|power management]] related things such as sleeping.
	However, there are several ways of still adding this functionality.		However, there are several ways of still adding this functionality.

Line 66:		Line 66:
	The approach goes through the following steps:		The approach goes through the following steps:

	* Let the XServer detect idle-situation		* Let the [[Xorg\|XServer]] detect idle-situation
	* Inform "logind" (i.e. "systemd") about the situation		* Inform "[[Systemd/logind\|logind]]" (i.e. "systemd") about the situation
	* Let "logind" make the system sleep		* Let "logind" make the system sleep

Line 153:		Line 153:

	The "with-ghc" should be ghc that's in the "ghc-with-packages" dependency of the "xmonad-with-packages".		The "with-ghc" should be ghc that's in the "ghc-with-packages" dependency of the "xmonad-with-packages".
	It can be easily found with "nix-tree", which shows dependencies between packages on the machine.		It can be easily found with "[https://github.com/utdemir/nix-tree nix-tree]", which shows dependencies between packages on the machine.

	[[Category:Window managers]]		[[Category:Window managers]]
	[[Category:Applications]]		[[Category:Applications]]

imported>Jooooscha: Clean up rest of the entry, remove some nonsensical parts

2023-02-16T09:00:47Z

Clean up rest of the entry, remove some nonsensical parts

@@ Line 55: / Line 55: @@
 More information on how to configure Xmonad can be found in the [https://wiki.archlinux.org/title/Xmonad Arch Wiki], and a list of starter configs can be found in the [https://wiki.haskell.org/Xmonad/Config_archive Xmonad Config Archive].
 == Power management ==
@@ Line 177: / Line 118: @@
 $ sleep 1s && xset s activate
 </syntaxhighlight>
 [[Category:Window managers]]
 [[Category:Applications]]

imported>Jooooscha: Add information on how to import external modules that are not in xmonad-contrib

2023-02-16T08:39:24Z

Add information on how to import external modules that are not in xmonad-contrib

@@ Line 9: / Line 9: @@
 The simplest way to install Xmonad is to activate the corresponding NixOS module.
 You can do this by adding the following to your NixOS configuration.
-You probably also want to activate the <core>enableContribAndExtras</code> option.
+You probably also want to activate the <code>enableContribAndExtras</code> option.
    services.xserver.windowManager.xmonad = {
@@ Line 18: / Line 18: @@
 The second options automatically adds the <code>xmonad-contrib</code> and <code>xmonad-extras</code> packages.
 They are required to use the [https://hackage.haskell.org/package/xmonad-contrib Xmonad Contrib] extensions.
 == Configuration ==
@@ Line 23: / Line 50: @@
 To configure Xmonad you give Nix your config file like this:
- services.xserver.windowManager.xmonad.config = builtins.readFile ../path/to/xmonad.hs;
+<syntaxHighlight lang="nix">
 More information on how to configure Xmonad can be found in the [https://wiki.archlinux.org/title/Xmonad Arch Wiki], and a list of starter configs can be found in the [https://wiki.haskell.org/Xmonad/Config_archive Xmonad Config Archive].

imported>Jooooscha: Replace dead link with link to arch wiki (WM is a non specific topic, I guess thats ok)

2022-12-26T18:32:01Z

Replace dead link with link to arch wiki (WM is a non specific topic, I guess thats ok)

← Older revision		Revision as of 18:32, 26 December 2022
Line 1:		Line 1:
	[https://xmonad.org/ xmonad] is a tiling [[window manager]] for X. Windows are arranged automatically to tile the screen without gaps or overlap, maximizing screen use. Window manager features are accessible from the keyboard: a mouse is optional.		[https://xmonad.org/ xmonad] is a tiling [https://wiki.archlinux.org/title/Window_manager window manager] for X. Windows are arranged automatically to tile the screen without gaps or overlap, maximizing screen use. Window manager features are accessible from the keyboard: a mouse is optional.

	xmonad is written, configured and extensible in [https://haskell.org/ Haskell]. Custom layout algorithms, key bindings and other extensions may be written by the user in configuration files.		xmonad is written, configured and extensible in [https://haskell.org/ Haskell]. Custom layout algorithms, key bindings and other extensions may be written by the user in configuration files.

imported>Jooooscha: Add more information about xmonad contrib

2022-12-26T18:27:22Z

Add more information about xmonad contrib

← Older revision		Revision as of 18:27, 26 December 2022
Line 6:		Line 6:

	== Installation ==		== Installation ==
	~~{{file\|/etc/nixos/~~configuration.~~nix\|nix\|~~<~~nowiki~~>
	services.xserver.windowManager.xmonad.enable = true;		The simplest way to install Xmonad is to activate the corresponding NixOS module.
	</~~nowiki~~>}}		You can do this by adding the following to your NixOS configuration.
			You probably also want to activate the <core>enableContribAndExtras</code> option.

			services.xserver.windowManager.xmonad = {
			enable = true;
			enableContribAndExtras = true;
			};

			The second options automatically adds the <code>xmonad-contrib</code> and <code>xmonad-extras</code> packages.
			They are required to use the [https://hackage.haskell.org/package/xmonad-contrib Xmonad Contrib] extensions.

	== Configuration ==		== Configuration ==

			To configure Xmonad you give Nix your config file like this:

			services.xserver.windowManager.xmonad.config = builtins.readFile ../path/to/xmonad.hs;

			More information on how to configure Xmonad can be found in the [https://wiki.archlinux.org/title/Xmonad Arch Wiki], and a list of starter configs can be found in the [https://wiki.haskell.org/Xmonad/Config_archive Xmonad Config Archive].

	=== Configuring XMonad with IDE support ===		=== Configuring XMonad with IDE support ===

	To edit XMonad configuration with IDE support, see https://www.srid.ca/xmonad-conf-ide		To edit XMonad configuration with IDE support, see https://www.srid.ca/xmonad-conf-ide

	=== Another way to set up lsp support ===		=== Another way to set up lsp support ===

	Previous way to set up lsp support didn't work for me.		Previous way to set up lsp support didn't work for me.
	[https://discourse.nixos.org/t/haskell-language-server-support-for-xmonad/12348 This post] helped:		[https://discourse.nixos.org/t/haskell-language-server-support-for-xmonad/12348 This post] helped:


	==== if setting up xmonad with extra packages: ====		==== if setting up xmonad with extra packages: ====

imported>Jooooscha: Clearify introduction of power management section

2022-12-26T18:13:29Z

Clearify introduction of power management section

← Older revision		Revision as of 18:13, 26 December 2022
Line 68:		Line 68:
	I try to manually run "haskell-language-server" in the directory with `xmonad.hs`, `hie.yaml` and `hie-bios.sh`		I try to manually run "haskell-language-server" in the directory with `xmonad.hs`, `hie.yaml` and `hie-bios.sh`
	when there are no errors, my editor also successfully starts lsp		when there are no errors, my editor also successfully starts lsp


	== Power management ==		== Power management ==

	~~While~~ other ~~DEs come with built-in functionality~~, ~~''xmonad''~~ does not.		Xmonad is a Window Manager (WM) and not a Desktop Environment (DE). Therefore, among other things,
			Xmonad does not handle power management related things such as sleeping.
	However, there are several ways of still adding this functionality.		However, there are several ways of still adding this functionality.

imported>Milnet2: Add: Suspend system after inactivity

2022-11-20T16:33:26Z

Add: Suspend system after inactivity

@@ Line 68: / Line 68: @@
 I try to manually run "haskell-language-server" in the directory with `xmonad.hs`, `hie.yaml` and `hie-bios.sh`
 when there are no errors, my editor also successfully starts lsp
 [[Category:Window managers]]
 [[Category:Applications]]

imported>Zach-hill: Added to "Window managers" and "Applications" categories

2022-10-02T15:59:43Z

Added to "Window managers" and "Applications" categories

← Older revision		Revision as of 15:59, 2 October 2022
Line 68:		Line 68:
	I try to manually run "haskell-language-server" in the directory with `xmonad.hs`, `hie.yaml` and `hie-bios.sh`		I try to manually run "haskell-language-server" in the directory with `xmonad.hs`, `hie.yaml` and `hie-bios.sh`
	when there are no errors, my editor also successfully starts lsp		when there are no errors, my editor also successfully starts lsp

			[[Category:Window managers]]
			[[Category:Applications]]