Qtile - Revision history

Prabuanand: removed :Category:Desktop as per Help_talk:Style

2025-05-25T15:28:49Z

removed Category:Desktop as per Help_talk:Style

← Older revision		Revision as of 15:28, 25 May 2025
Line 71:		Line 71:
	* [https://wiki.gentoo.org/wiki/Qtile Qtile - Gentoo Wiki]		* [https://wiki.gentoo.org/wiki/Qtile Qtile - Gentoo Wiki]

	~~[[Category:Desktop]]~~
	[[Category:Window Managers]]		[[Category:Window Managers]]

Prabuanand: replaced File management content with a link

2025-05-03T12:52:06Z

replaced File management content with a link

@@ Line 46: / Line 46: @@
 }}
-=== Auto-mounting USB drives ===
+=== File management ===
-To enable automatic mounting of USB drives, install these packages:
+Install the necessary [[File management]] packages for automounting of removable storage and browsing of network shares that works seamlessly with file associations.
-To list descriptions of all gvfs- packages:
+If the Qtile sessions are already in progress, they need to be restarted for the changes to take effect, i.e. log out and log in again.
 === Enabling privilege escalation GUI ===

Prabuanand: moved headings, included Prerequisites

2025-03-17T10:15:57Z

moved headings, included Prerequisites

← Older revision		Revision as of 10:15, 17 March 2025
Line 2:		Line 2:
	[https://qtile.org/ Qtile] is a full-featured and hackable window manager written in Python, compatible with Xorg and Wayland.		[https://qtile.org/ Qtile] is a full-featured and hackable window manager written in Python, compatible with Xorg and Wayland.

			== Prerequisites ==
	{{:Include:Desktop prerequisites}}		{{:Include:Desktop prerequisites}}
			* [[Alpine_setup_scripts#setup-xorg-base\|Install Xorg]]

			== Installation ==

			Minimal package selection to install: {{Cmd\|# apk add qtile lightdm-gtk-greeter font-dejavu}}

			[[File:Themeiconworking.png\|thumb\|With adw-gtk3-dark and Adwaita-Xfce]]

			== Starting Qtile ==

			=== With a display manager (graphical login) ===

	~~== Manual installation ==~~		If the package <code>lightdm-gtk-greeter</code> has been installed per the instructions above, the lightdm display manager may be started to log in graphically with your new user:

	~~=== Prerequisites ===~~		First, create a lightdm session file at /usr/share/xsessions:
			{{Cmd\|# mkdir -p /usr/share/xsessions}}

	* [[Alpine_setup_scripts#setup-xorg-base\|Install Xorg]]
	* [[D-Bus#Installation\|Install and configure D-Bus]] (without D-Bus icons and keyboard shortcuts may be missing)

	~~Minimal package selection to install:~~		{{cat\|/usr/share/xsessions/qtile.desktop\|[Desktop Entry]
	{{~~Cmd~~\|~~# apk add~~ qtile ~~lightdm~~-~~gtk~~-~~greeter font~~-~~dejavu~~}}		Name{{=}}Qtile
			Comment{{=}}Qtile Session
			Exec{{=}}dbus-run-session -- qtile start
			Type{{=}}Application
			Keywords{{=}}wm;tiling}}

	~~[[File:Themeiconworking.png~~\|~~thumb\|With adw-gtk3-dark and Adwaita~~-~~Xfce]]~~		{{Cmd\|# rc-service lightdm start}}

	~~=== Set~~ up ~~eudev ===~~		After correct operation is verified, lightdm can be enabled to start up during boot:
			{{Cmd\|# rc-update add lightdm}}

	~~{{:Include:Setup_Device_Manager}}~~		== Configuration ==

	=== Allowing shut down and reboot ===		=== Allowing shut down and reboot ===
Line 64:		Line 80:
	or start them manually for this time only:		or start them manually for this time only:
	{{Cmd\|# rc-service elogind start #change elogind for lightdm and run the same command}}		{{Cmd\|# rc-service elogind start #change elogind for lightdm and run the same command}}

	~~== Starting Qtile ==~~

	~~=== With a display manager (graphical login) ===~~

	~~If the package <code>lightdm-gtk-greeter</code> has been installed per the instructions above, the lightdm display manager may be started to log in graphically with your new user:~~

	~~First, create a lightdm session file at /usr/share/xsessions:~~
	~~{{Cmd\|# mkdir -p /usr/share/xsessions}}~~


	~~{{cat\|/usr/share/xsessions/qtile.desktop\|[Desktop Entry]~~
	~~Name{{=}}Qtile~~
	~~Comment{{=}}Qtile Session~~
	~~Exec{{=}}dbus-run-session -- qtile start~~
	~~Type{{=}}Application~~
	~~Keywords{{=}}wm;tiling}}~~

	~~{{Cmd\|# rc-service lightdm start}}~~

	~~After correct operation is verified, lightdm can be enabled to start up during boot:~~
	~~{{Cmd\|# rc-update add lightdm}}~~

	=== Localized keyboard layout ===		=== Localized keyboard layout ===
Line 94:		Line 88:

	* [[Installation#Post-Install\|Post Install]]		* [[Installation#Post-Install\|Post Install]]

	* [[Alpine Setup Scripts]]
	* [https://docs.qtile.org/en/stable/ Qtile docs]		* [https://docs.qtile.org/en/stable/ Qtile docs]
	* [https://wiki.archlinux.org/title/Qtile Qtile - ArchWiki]		* [https://wiki.archlinux.org/title/Qtile Qtile - ArchWiki]

Prabuanand: changed category from :Category:Desktop Environments to :Category:Window Managers

2025-02-06T08:39:50Z

changed category from Category:Desktop Environments to Category:Window Managers

← Older revision		Revision as of 08:39, 6 February 2025
Line 11:		Line 11:
	* [[D-Bus#Installation\|Install and configure D-Bus]] (without D-Bus icons and keyboard shortcuts may be missing)		* [[D-Bus#Installation\|Install and configure D-Bus]] (without D-Bus icons and keyboard shortcuts may be missing)

	~~<br>~~
	Minimal package selection to install:		Minimal package selection to install:
	{{Cmd\|# apk add qtile lightdm-gtk-greeter font-dejavu}}		{{Cmd\|# apk add qtile lightdm-gtk-greeter font-dejavu}}
Line 75:		Line 74:
	{{Cmd\|# mkdir -p /usr/share/xsessions}}		{{Cmd\|# mkdir -p /usr/share/xsessions}}

	~~<br>~~

	{{cat\|/usr/share/xsessions/qtile.desktop\|[Desktop Entry]		{{cat\|/usr/share/xsessions/qtile.desktop\|[Desktop Entry]
Line 83:		Line 81:
	Type{{=}}Application		Type{{=}}Application
	Keywords{{=}}wm;tiling}}		Keywords{{=}}wm;tiling}}


	{{Cmd\|# rc-service lightdm start}}		{{Cmd\|# rc-service lightdm start}}
Line 91:		Line 88:

	=== Localized keyboard layout ===		=== Localized keyboard layout ===
	~~<br>~~
	The keyboard layout can be [[Xorg#Keyboard_Layout_(optional)\|\|configured at the Xorg level]].		The keyboard layout can be [[Xorg#Keyboard_Layout_(optional)\|configured at the Xorg level]].

	== See also ==		== See also ==
Line 104:		Line 101:

	[[Category:Desktop]]		[[Category:Desktop]]
	[[Category:~~Desktop Environments~~]]		[[Category:Window Managers]]

Prabuanand: changed the included section from :Include:Setup-desktop to :Include:Desktop prerequisites

2025-02-05T04:32:49Z

changed the included section from Include:Setup-desktop to Include:Desktop prerequisites

← Older revision		Revision as of 04:32, 5 February 2025
Line 2:		Line 2:
	[https://qtile.org/ Qtile] is a full-featured and hackable window manager written in Python, compatible with Xorg and Wayland.		[https://qtile.org/ Qtile] is a full-featured and hackable window manager written in Python, compatible with Xorg and Wayland.

	{{:Include:~~Setup-desktop~~}}		{{:Include:Desktop prerequisites}}

	~~Qtile is currently not supported by the setup-desktop script, and must be installed manually. See the steps listed below in Manual installation.~~

	== Manual installation ==		== Manual installation ==

Yass: Fix the rendering markup

2025-02-03T12:45:08Z

Fix the rendering markup

← Older revision		Revision as of 12:45, 3 February 2025
Line 75:		Line 75:

	First, create a lightdm session file at /usr/share/xsessions:		First, create a lightdm session file at /usr/share/xsessions:
	{{Cmd\|# mkdir -p /usr/share/xsessions		{{Cmd\|# mkdir -p /usr/share/xsessions}}
	~~# nano /usr/share/xsessions/qtile.desktop~~}}

	[Desktop Entry]		<br>
	Name=Qtile
	Comment=Qtile Session		{{cat\|/usr/share/xsessions/qtile.desktop\|[Desktop Entry]
	Exec=dbus-run-session -- qtile start		Name{{=}}Qtile
	Type=Application		Comment{{=}}Qtile Session
	Keywords=wm;tiling		Exec{{=}}dbus-run-session -- qtile start
			Type{{=}}Application
			Keywords{{=}}wm;tiling}}

	~~<br>~~

	{{Cmd\|# rc-service lightdm start}}		{{Cmd\|# rc-service lightdm start}}

Yass: /* Starting Qtile */

2025-02-03T12:40:24Z

Starting Qtile

← Older revision		Revision as of 12:40, 3 February 2025
Line 84:		Line 84:
	Type=Application		Type=Application
	Keywords=wm;tiling		Keywords=wm;tiling

			<br>

	{{Cmd\|# rc-service lightdm start}}		{{Cmd\|# rc-service lightdm start}}

Yass: Initial draft on the Qtile install documentation (based on the XFCE page)

2025-02-03T12:39:23Z

Initial draft on the Qtile install documentation (based on the XFCE page)

New page

[[file:QtileScreenshot.png |thumb |Qtile screenshot (default configuration).]]
[https://qtile.org/ Qtile] is a full-featured and hackable window manager written in Python, compatible with Xorg and Wayland.

{{:Include:Setup-desktop}}

Qtile is currently not supported by the setup-desktop script, and must be installed manually. See the steps listed below in Manual installation.

== Manual installation ==

=== Prerequisites ===

* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]
* [[D-Bus#Installation|Install and configure D-Bus]] (without D-Bus icons and keyboard shortcuts may be missing)

<br>
Minimal package selection to install:
{{Cmd|# apk add qtile lightdm-gtk-greeter font-dejavu}}

[[File:Themeiconworking.png|thumb|With adw-gtk3-dark and Adwaita-Xfce]]

=== Set up eudev ===

{{:Include:Setup_Device_Manager}}

=== Allowing shut down and reboot ===

To enable users to shut down the machine or reboot, the packages {{Pkg|elogind}} and {{Pkg|polkit-elogind}} need to be installed.
{{Cmd|# apk add elogind polkit-elogind}}

A reboot is required to let it take effect.
{{Cmd|# lbu commit # if running in diskless mode, to save state
$ reboot
}}

=== Auto-mounting USB drives ===

To enable automatic mounting of USB drives, install these packages:
{{Cmd|# apk add gvfs udisks2}}

Depending on what devices you intend to mount, some additional packages may be needed:
{{Cmd|# apk add \
ntfs-3g \ # Stable, full-featured, read-write NTFS (driver)
gvfs-cdda \ # CDDA support for gvfs
gvfs-afp \ # AFP support for gvfs
gvfs-goa \ # GNOME Online Accounts support for gvfs
gvfs-mtp \ # MTP support for gvfs
gvfs-smb \ # Windows fileshare support for gvfs
gvfs-lang \ # Languages for package gvfs
gvfs-afc \ # Apple mobile devices support for gvfs
gvfs-nfs \ # NFS support for gvfs
gvfs-dev \ # Backends for the gio framework in GLib (development files)
gvfs-archive \ # Archiving support for gvfs
gvfs-dav \ # WebDAV support for gvfs
gvfs-fuse \ # FUSE support for gvfs
gvfs-gphoto2 \ # gphoto2 support for gvfs
gvfs-avahi \ # DNS-SD support for gvfs}}

To list descriptions of all gvfs- packages:
{{cmd|$ apk info -d gvfs-*
}}

=== Enabling privilege escalation GUI ===

To make elogind/lightdm running, either make them start automatically at system start:
{{Cmd|# rc-update add elogind #change elogind for lightdm and run the same command}}

or start them manually for this time only:
{{Cmd|# rc-service elogind start #change elogind for lightdm and run the same command}}

== Starting Qtile ==

=== With a display manager (graphical login) ===

If the package <code>lightdm-gtk-greeter</code> has been installed per the instructions above, the lightdm display manager may be started to log in graphically with your new user:

First, create a lightdm session file at /usr/share/xsessions:
{{Cmd|# mkdir -p /usr/share/xsessions
# nano /usr/share/xsessions/qtile.desktop}}

[Desktop Entry]
Name=Qtile
Comment=Qtile Session
Exec=dbus-run-session -- qtile start
Type=Application
Keywords=wm;tiling

{{Cmd|# rc-service lightdm start}}

After correct operation is verified, lightdm can be enabled to start up during boot:
{{Cmd|# rc-update add lightdm}}

=== Localized keyboard layout ===
<br>
The keyboard layout can be [[Xorg#Keyboard_Layout_(optional)||configured at the Xorg level]].

== See also ==

* [[Installation#Post-Install|Post Install]]

* [[Alpine Setup Scripts]]
* [https://docs.qtile.org/en/stable/ Qtile docs]
* [https://wiki.archlinux.org/title/Qtile Qtile - ArchWiki]
* [https://wiki.gentoo.org/wiki/Qtile Qtile - Gentoo Wiki]

[[Category:Desktop]]
[[Category:Desktop Environments]]