Qtile - Revision history

Samu: Added information regarding testing. Removed duplicate code at the top of the page. Small grammar changes.

2026-05-28T16:44:03Z

Added information regarding testing. Removed duplicate code at the top of the page. Small grammar changes.

← Older revision		Revision as of 16:44, 28 May 2026
Line 2:		Line 2:
	== Setup ==		== Setup ==

	To enable Qtile as your window manager, ~~set <code>services.xserver.windowManager.qtile.enable = true</code>. For example~~:		To enable Qtile as your window manager, include this in your configuration:

	~~{{file\|/etc/nixos/configuration.nix\|nix\|}}~~
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	{		services.xserver.windowManager.qtile.enable = true;
	services.xserver.windowManager.qtile.enable = true;
	}
	</syntaxhighlight>		</syntaxhighlight>
	{{Note\|The Qtile package creates desktop files for both X11 and Wayland, to use one of the backends choose the right session in your display manager.}}		{{Note\|The Qtile package creates desktop files for both X11 and Wayland, to use one of the backends choose the right session in your display manager.}}
Line 31:		Line 28:
	</syntaxhighlight>		</syntaxhighlight>

	or, if you have a directory containing multiple python files:		Or, if you have a directory containing multiple python files:

	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
Line 154:		Line 151:
	</syntaxhighlight>		</syntaxhighlight>

	This flake can also be tested with a vm:		This flake can also be tested with a virtual machine:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	sudo nixos-rebuild build-vm --flake .#demo		sudo nixos-rebuild build-vm --flake .#demo
	</syntaxhighlight>		</syntaxhighlight>

	~~Gives~~ you a script to run that runs Qemu to test your config. For this to work you have to set a user with a password.		This gives you a script to run that runs Qemu to test your config. For this to work you have to set a user with a password.

			To hack on Qtile with Nix, simply run <code>nix develop</code> in a checkout of the Qtile repository. In the development shell, there are a few useful commands:

			* <code>qtile-run-tests-wayland</code>: Run all Wayland tests.
			* <code>qtile-run-tests-x11</code>: Run all X11 tests.

	{{Note\|1=For a detailed walkthrough on setting up Qtile with flakes—from basic installation to package overrides, see [https://gurjaka.codeberg.page/blog.html?post=qtile-flake Gurjaka's Qtile Flake Guide].}}		{{Note\|1=For a detailed walkthrough on setting up Qtile with flakes—from basic installation to package overrides, see [https://gurjaka.codeberg.page/blog.html?post=qtile-flake Gurjaka's Qtile Flake Guide].}}
Line 165:		Line 167:
	== Credits ==		== Credits ==
	* Based on the official [https://docs.qtile.org/en/latest/manual/install/nixos.html# Qtile Documentation].		* Based on the official [https://docs.qtile.org/en/latest/manual/install/nixos.html# Qtile Documentation].
	* Wayland details from [https://gist.github.com/jwijenbergh/48da1a8f4c4a56d122407c4d009bc81f Gist by Jwijenbergh]		* Wayland details from [https://gist.github.com/jwijenbergh/48da1a8f4c4a56d122407c4d009bc81f Gist by Jwijenbergh].
			* Flake config details from [https://gurjaka.codeberg.page/blog.html?post=qtile-flake Gurjaka's Qtile Flake Guide].
	* NixOS implementation details maintained by the community.		* NixOS implementation details maintained by the community.

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

Gurjaka: /* Credits */

2026-03-09T20:12:26Z

Credits

← Older revision		Revision as of 20:12, 9 March 2026
Line 165:		Line 165:
	== Credits ==		== Credits ==
	* Based on the official [https://docs.qtile.org/en/latest/manual/install/nixos.html# Qtile Documentation].		* Based on the official [https://docs.qtile.org/en/latest/manual/install/nixos.html# Qtile Documentation].
	* Wayland details from [https://gist.github.com/jwijenbergh/48da1a8f4c4a56d122407c4d009bc81f~~#screen-sharing--desktop-portals~~ Gist by Jwijenbergh]		* Wayland details from [https://gist.github.com/jwijenbergh/48da1a8f4c4a56d122407c4d009bc81f Gist by Jwijenbergh]
	* NixOS implementation details maintained by the community.		* NixOS implementation details maintained by the community.

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

Gurjaka: /* Extra Packages */

2026-03-09T20:01:41Z

Extra Packages

← Older revision		Revision as of 20:01, 9 March 2026
Line 53:		Line 53:
	</syntaxhighlight>		</syntaxhighlight>

	{{Note\|Some options may change over time, please refer to see all the options for the latest stable: [https://search.nixos.org search.nixos.org] if you have any doubt}}		{{Note\|1=Some options may change over time, please refer to see all the options for the latest stable: [https://search.nixos.org/options?channel=25.11&query=qtile search.nixos.org] if you have any doubt}}

	== Wayland ==		== Wayland ==

Gurjaka: /* Enabling */

2026-03-09T19:59:39Z

Enabling

Show changes

Jooooscha: Change link of qtile.org from http to https. Also, remove the www

2025-01-09T21:15:24Z

Change link of qtile.org from http to https. Also, remove the www

← Older revision		Revision as of 21:15, 9 January 2025
Line 1:		Line 1:
	[~~http~~://~~www.~~qtile.org/ Qtile] is a full-featured, hackable tiling window manager written and configured in Python.		[https://qtile.org/ Qtile] is a full-featured, hackable tiling window manager written and configured in Python.

	== Enabling ==		== Enabling ==

Jooooscha at 17:45, 1 June 2024

2024-06-01T17:45:02Z

← Older revision		Revision as of 17:45, 1 June 2024
Line 10:		Line 10:
	services.xserver.windowManager.qtile.enable = true;		services.xserver.windowManager.qtile.enable = true;
	}		}
	</syntaxhighlight>To start Qtile from your display manager (sddm, lightdm, etc) you have to add a Desktop Entry to your config like this.{{file\|/etc/nixos/qtile.nix\|nix\|}}		</syntaxhighlight>To start Qtile on Wayland from your display manager (sddm, lightdm, etc) you have to add a Desktop Entry to your config like this.{{file\|/etc/nixos/qtile.nix\|nix\|}}
	<syntaxHighlight lang=nix>		<syntaxHighlight lang=nix>
	{ config, pkgs, lib, ... }:		{ config, pkgs, lib, ... }:

Jooooscha: Simplify code example

2024-06-01T17:44:28Z

Simplify code example

← Older revision		Revision as of 17:44, 1 June 2024
Line 6:		Line 6:

	{{file\|/etc/nixos/configuration.nix\|nix\|}}		{{file\|/etc/nixos/configuration.nix\|nix\|}}
	<~~syntaxHighlight~~ lang=nix>		<syntaxhighlight lang="nix">
	{ ~~config, pkgs, ... }:~~		{
	~~...~~
	~~imports =~~
	~~[ # Include the results of the hardware scan.~~
	~~./hardware-configuration.nix~~
	~~# For wayland support see the following config~~
	~~./qtile.nix~~
	];
	services.xserver.windowManager.qtile.enable = true;		services.xserver.windowManager.qtile.enable = true;
	~~...~~
	}		}
	</~~syntaxHighlight~~>		</syntaxhighlight>To start Qtile from your display manager (sddm, lightdm, etc) you have to add a Desktop Entry to your config like this.{{file\|/etc/nixos/qtile.nix\|nix\|}}

	{{file\|/etc/nixos/qtile.nix\|nix\|}}
	<syntaxHighlight lang=nix>		<syntaxHighlight lang=nix>
	{ config, pkgs, lib, ... }:		{ config, pkgs, lib, ... }:

Jooooscha: Smaller text changes

2024-06-01T17:39:47Z

Smaller text changes

← Older revision		Revision as of 17:39, 1 June 2024
Line 3:		Line 3:
	== Enabling ==		== Enabling ==

	To enable Qtile as your ~~windowManager~~, set: <code>services.xserver.windowManager.qtile.enable~~</code> to <code>~~true</code>. For example:		To enable Qtile as your window manager, set <code>services.xserver.windowManager.qtile.enable = true</code>. For example:

	{{file\|/etc/nixos/configuration.nix\|nix\|}}		{{file\|/etc/nixos/configuration.nix\|nix\|}}

imported>Jooooscha: fix: greater sign (and remove now redundant explanation)

2024-03-06T20:33:56Z

fix: greater sign (and remove now redundant explanation)

← Older revision		Revision as of 20:33, 6 March 2024
Line 5:		Line 5:
	To enable Qtile as your windowManager, set: <code>services.xserver.windowManager.qtile.enable</code> to <code>true</code>. For example:		To enable Qtile as your windowManager, set: <code>services.xserver.windowManager.qtile.enable</code> to <code>true</code>. For example:

	{{file\|/etc/nixos/configuration.nix\|nix\|		{{file\|/etc/nixos/configuration.nix\|nix\|}}
	<~~nowiki~~>		<syntaxHighlight lang=nix>
	{ config, pkgs, ... }:		{ config, pkgs, ... }:
	...		...
Line 18:		Line 18:
	...		...
	}		}
	</~~nowiki~~>		</syntaxHighlight>
	}}

	{{file\|/etc/nixos/qtile.nix\|nix\|		{{file\|/etc/nixos/qtile.nix\|nix\|}}
	<~~nowiki~~>		<syntaxHighlight lang=nix>
	{ config, pkgs, lib, ... }:		{ config, pkgs, lib, ... }:

Line 49:		Line 48:
	services.xserver.displayManager.sessionPackages = [ pkgs.qtile-unwrapped ];		services.xserver.displayManager.sessionPackages = [ pkgs.qtile-unwrapped ];
	}		}
	</~~nowiki~~>		</syntaxHighlight>
	}}

	Please note, the wiki renders the greater than sign in the code above with the HTML code & followed by gt;. It needs to be the actual symbol ">" not the HTML code, ie. echo "${qtileSession}" > $out/share/wayland-sessions/qtile.desktop

	== Warning ==		== Warning ==

imported>Wingej0 at 17:44, 26 January 2024

2024-01-26T17:44:02Z

← Older revision		Revision as of 17:44, 26 January 2024
Line 51:		Line 51:
	</nowiki>		</nowiki>
	}}		}}

			Please note, the wiki renders the greater than sign in the code above with the HTML code & followed by gt;. It needs to be the actual symbol ">" not the HTML code, ie. echo "${qtileSession}" > $out/share/wayland-sessions/qtile.desktop

	== Warning ==		== Warning ==