From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id qFQQFoiM6maomwAA62LTzQ:P1 (envelope-from ) for ; Wed, 18 Sep 2024 08:17:12 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e224::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp1.migadu.com with LMTPS id qFQQFoiM6maomwAA62LTzQ (envelope-from ) for ; Wed, 18 Sep 2024 10:17:12 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=UAezegG5; dkim=fail ("headers rsa verify failed") header.d=nanein.fr header.s=mail header.b=VrPlFoKj; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1726647432; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=XFgjmJ7o0At5HRAgIuwe5eL6y4haM9e1gYwqb2yva6M=; b=RLPPu9fZ+2ZqBWNnIw88kcfVGX4dwZPIMljTTQuw14Acr6kGgGiZldyh9KLmthtshmXEqV xr7FjuJtu2AwpD5oFhPKa5NLNWBg71FaxZiTErblw5/sMS/6+F0VwCc6zQbwEhTPeHV/nC hoq4LkkFEEbXK0uhn3EUc2uFZ095VOMpMxa8u9GgmqUZE1otdSeC9ldktPG30LwiUVaete GY8cGhKTF+bBvt38X1lSW/uX127NGexfsmBhNkBfjAZLGHVoKzO3lSBBYmNuuL4fWC0V8p Qb6rxrbmrYoPYGAyRNvP6YeiKjT96sU+nFgwsAQ73xXoUK1AZgSe8MR3IkTO7A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1726647432; a=rsa-sha256; cv=none; b=Q2AJx98FeotANRtNlFwIvjL8VVBTNFVf0i9NnxeSajkvFopjw04gniDqH0VYi9yDhj1PQs Erchpqj0oybCIbsMl/sw6nyNF2MRJhwLrGokt3LCx34njYcfXvKidWN4BhjQOBhb63/Xes EnkF4fzTv9nOc330T+NpCO0xdj7SKOm+VNlozUb1b3z39OJT7zMTg+0GDKChEuh0unHr1V 68pCd9kF3Q0L66zwYJGaUAwSK6br3V7A7kSTHvoky9FuLgsvMrpAxx1qEccqsonBtNru+i aGQd5aZ7A1ltZHQzZVIInv8CSeiIEBRzyCpF0YqcoV7586Vbx9Z1r0iFtUVU8g== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=UAezegG5; dkim=fail ("headers rsa verify failed") header.d=nanein.fr header.s=mail header.b=VrPlFoKj; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=gnu.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 89EEA7E391 for ; Wed, 18 Sep 2024 10:17:11 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sqprv-0000no-NE; Wed, 18 Sep 2024 04:17:01 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sqprj-0000nJ-SV for guix-patches@gnu.org; Wed, 18 Sep 2024 04:16:50 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1sqprj-0005o8-CK for guix-patches@gnu.org; Wed, 18 Sep 2024 04:16:47 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:From:To:In-Reply-To:References:Subject; bh=J75WQstMVLyJnSO33Mj2e38zLt90Ra08nEGGaMfgHGY=; b=UAezegG5dxUys83LiW2q+6+kC7WM8M5cFHmyQ4EEaBO7bwFHANN0yiyFyGVePL5Vb3KhrYPvKpb30d9MVdgIzq+H2AUVkYFw6zw90qfSmqDpbyFG7Vt0UA99+e3nVn2NvW/ksO14UENJDG+nq99B+C11hdijMa2QSrr7fFDFL7CzBhcKhedchRwhPqZ9zossD5AuNAR1kHkbalwpDG/ec3YuSymj3JE24pmm2TKgPFAdVLonm+bzExIggDr3pvRGbzqraNupRQ/IIjNyQsSZI3W1L1EWuNTGwVd2bS1pwXUVc51HCRhMKZvIBcpT3OGfq81s5VsQcsDPiU87ylTevA==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sqprx-0003WE-Ku for guix-patches@gnu.org; Wed, 18 Sep 2024 04:17:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#72714] [PATCH v5] home: services: Add 'home-sway-service-type'. References: <1e82e473639f21a2950a0827f156437ef1bc9c48.1724081442.git.ds-ac@nanein.fr> In-Reply-To: <1e82e473639f21a2950a0827f156437ef1bc9c48.1724081442.git.ds-ac@nanein.fr> Resent-From: Arnaud Daby-Seesaram Original-Sender: "Debbugs-submit" Resent-CC: , guix-patches@gnu.org Resent-Date: Wed, 18 Sep 2024 08:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72714 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 72714@debbugs.gnu.org Cc: Arnaud Daby-Seesaram , ( , Andrew Tropin , Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Maxim Cournoyer , Tanguy Le Carrour X-Debbugs-Original-Xcc: ( , Andrew Tropin , Florian Pelz , Ludovic =?UTF-8?Q?Court=C3=A8s?= , Maxim Cournoyer , Tanguy Le Carrour Received: via spool by 72714-submit@debbugs.gnu.org id=B72714.172664740813501 (code B ref 72714); Wed, 18 Sep 2024 08:17:01 +0000 Received: (at 72714) by debbugs.gnu.org; 18 Sep 2024 08:16:48 +0000 Received: from localhost ([127.0.0.1]:56956 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sqpri-0003Vd-GJ for submit@debbugs.gnu.org; Wed, 18 Sep 2024 04:16:48 -0400 Received: from nanein.fr ([185.230.78.41]:45530) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sqprf-0003VM-AM for 72714@debbugs.gnu.org; Wed, 18 Sep 2024 04:16:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=nanein.fr; s=mail; t=1726647351; bh=2buOKGXP2Ng0AtYkiBNW1qxX6Js4v5sgt4mX3kBKI7g=; h=From:To:Cc:Subject:Date:From; b=VrPlFoKjP4zqR4mXbOWa/gi5KPtkntO1j+tQKExLhZC9PDL5B4XQNlRSCrjkWk6uh RtyPjuvSpkRJ7qbCVQnP7QNGRhrtX3HPHAfqXO83LCJ8bEznjXEkS6YsljcEM/LsaX kwZA4eXRm9Ii2Yaz2ySCaAWxx3uaRh0xASK8215oKkcqdnd/VGbAFiSDxN8XAngqyO ZbuweuzC7v+7TTuR0F0o/H+T2BlysvXLoErzshaS5jvgVhGLZVkn0J8T8hq5MDFmh+ MXJ7nL4SF4U9t3Tfd+dtKJfb5DxJMOfczZ+TgRtS0r2Z+1bbU8XVH7zf7XbYlkXNkL GxecLJZGgb5aOOfA/rBqn9x/ptLeEM3xlJ3wJCXThhaLK0efvkZv/+geBBA8B+z7e4 E4y3cRsOzkMncFe6MVdirgFcowZjiUagwSxXKjJt4iat1VMD4AGy8DmZE2EYdZ+n1l e/3X0vBUk9xtLxpe3dAho0fOoAAatP+RdmQTDga+KQw2a4j/Ur17BoBUt3wDgZhMQo IHWkPywQ2urFyZ4q9S8QzfKXYJo8/t80W9/X3E8GFb6UXyb7/hCbHIsLOSR/LyWBxW mRSVOZwZAafW049ncYVz26vvllPgKtE5bIj9l3MzeuNG7FwNvtAwEPFr6Vgqhsgxm/ +wxTmRCT//9Ye5/YrIgQORas= Received: from localhost.localdomain (wg.nanein.fr [IPv6:2a0c:700:12:50:1::109]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by nanein.fr (Postfix) with ESMTPSA id BFFB6140215; Wed, 18 Sep 2024 10:15:50 +0200 (CEST) Date: Wed, 18 Sep 2024 10:15:40 +0200 Message-ID: <20240918081545.8885-1-ds-ac@nanein.fr> X-Mailer: git-send-email 2.46.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-to: Arnaud Daby-Seesaram X-ACL-Warn: , Arnaud Daby-Seesaram via Guix-patches From: Arnaud Daby-Seesaram via Guix-patches via Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Scanner: mx12.migadu.com X-Migadu-Spam-Score: -5.51 X-Migadu-Queue-Id: 89EEA7E391 X-Spam-Score: -5.51 X-TUID: cIeHv8EKZ4YG * gnu/home/services/sway.scm: New file. (home-sway-service-type): New variable. (sway-configuration->file): New procedure. (sway-configuration): New configuration record. (sway-bar): New configuration record. (sway-output): New configuration record. (sway-input): New configuration record. (point): New configuration record. (sway-color): New configuration record. (sway-border-color): New configuration record. (flatten): New procedure. * gnu/local.mk: Add gnu/home/services/sway.scm. * doc/guix.texi (Sway window manager): New node to document the above changes. --- doc/guix.texi | 329 +++++++++++++++++ gnu/home/services/sway.scm | 711 +++++++++++++++++++++++++++++++++++++ gnu/local.mk | 1 + 3 files changed, 1041 insertions(+) create mode 100644 gnu/home/services/sway.scm diff --git a/doc/guix.texi b/doc/guix.texi index bdaefe3802..07598a2a7e 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -130,6 +130,7 @@ Copyright @copyright{} 2024 Richard Sent@* Copyright @copyright{} 2024 Dariqq@* Copyright @copyright{} 2024 Denis 'GNUtoo' Carikli@* Copyright @copyright{} 2024 Fabio Natali@* +Copyright @copyright{} 2024 Arnaud Daby-Seesaram@* Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or @@ -460,6 +461,7 @@ Home Services * Mail: Mail Home Services. Services for managing mail. * Messaging: Messaging Home Services. Services for managing messaging. * Media: Media Home Services. Services for managing media. +* Sway: Sway window manager. Setting up the Sway configuration. * Networking: Networking Home Services. Networking services. * Miscellaneous: Miscellaneous Home Services. More services. @@ -45190,6 +45192,7 @@ services)}. * Mail: Mail Home Services. Services for managing mail. * Messaging: Messaging Home Services. Services for managing messaging. * Media: Media Home Services. Services for managing media. +* Sway: Sway window manager. Setting up the Sway configuration. * Networking: Networking Home Services. Networking services. * Miscellaneous: Miscellaneous Home Services. More services. @end menu @@ -47104,6 +47107,332 @@ kodi} for more information. @end table @end deftp +@node Sway window manager +@subsection Sway window manager + +@cindex sway, Home Service +@cindex sway, configuration +The @code{(gnu home services sway)} module provides +@code{home-sway-service-type}, a home service to configure sway in a +declarative way. + +@quotation Note +This home service only sets up the configuration file and profile +packages for sway. It does @i{not} start sway in any way. If you want +to do so, you might be interested in using +@code{greetd-wlgreet-sway-session} instead. + +The function @code{sway-configuration->file} defined below can be used +to provide the value for the @code{sway-configuration} field of +@code{greetd-wlgreet-sway-session}. +@end quotation + +@defvar sway-configuration->file +This function takes a @code{sway-configuration} record (defined below), +and returns a file-like object represented the serialized configuration. +@end defvar + +@defvar home-sway-service-type +This is a home service type to set up Sway. It takes care of: +@itemize +@item +providing a @file{~/.config/sway/config} file, +@item +adding sway-related packages to your profile. +@end itemize + +Here is an example of a service and its configuration that you could add +to the @code{services} field of your @code{home-environment}: + +@lisp +(service home-sway-service-type + (sway-configuration + (gestures + '((swipe:3:down . "move to scratchpad") + (swipe:3:up . "scratchpad show"))) + (outputs + (list (sway-output + (identifier '*) + (bg (file-append guix-backgrounds + "\ +/share/backgrounds/guix/guix-checkered-16-9.svg"))))))) +@end lisp + +The above example describes a sway configuration in which +@itemize +@item +all monitors use a particular wallpaper whose @file{.svg} is provided by +the @code{guix-background} package; +@item +swiping down (resp.@: up) with three fingers moves the active window to +the scratchpad (resp.@: shows/hides the scratchpad). +@end itemize +@end defvar + +@deftp {Data Type} sway-configuration +This configuration record describes the sway configuration +(see@ @cite{sway(5)}). Available fields are: + +@table @asis +@item @code{variables} (default: @code{%sway-default-variables}) +The value of this field is an association list in which keys are symbols +and values are strings or G-expressions (@pxref{G-Expressions}). + +Example: @code{'(mod . "Mod4")}. + +@item @code{keybindings} (default: @code{%sway-default-keybindings}) +This field describes keybindings for the @emph{default} mode. As above, +the value is an association list: keys are symbols and values are either +strings, G-expressions or file-append objects. + +Examples using: +@itemize +@item +a string: @code{'($mod+Return . "exec $term")} +@item +a G-exp: @code{`($mod+t . ,#~(string-append #$st "/bin/st"))} +@item +a file-append: @code{`($mod+t . ,(file-append st "/bin/st"))} +@end itemize + +@item @code{gestures} (default: @code{%sway-default-gestures}) +Similar to the previous field, but for finger-gestures. + +The following snippet allows to navigate through workspaces by swiping +right and left with three fingers: +@lisp +'((swipe:3:right . "workspace next_on_output") + (swipe:3:left . "workspace prev_on_output")) +@end lisp + +@item @code{packages} (default: @code{%sway-default-packages}) +This field describes a list of packages to add to the user profile. + +@item @code{inputs} (default: @code{(list (sway-input))}) +List of @code{sway-input} configuration records. + +@item @code{outputs} (default: @code{'()}) +List of @code{sway-output} configuration records. + +@item @code{bar} (default: @code{(sway-bar)}) +Bar configuration. + +@item @code{modes} (default: @code{'()}) +Optional list of @code{sway-mode} records (described below). + +@item @code{always-execs} (default: @code{'()}) +Programs to execute at startup time @i{and} after every configuration +reload. The value of this field is a list of strings or G-expressions. + +@item @code{execs} (default: @code{%sway-default-execs}) +Programs to execute at startup time. The value of this field is a list +of strings or G-expressions. + +The default value, @code{%sway-default-execs}, executes @code{swayidle} +in order to lock the screen after 5@ minutes of inactivity (displaying a +background distributed with Sway) and turn of the screen after +10@ minutes of inactivity. + +@item @code{extra-content} (default: @code{'()}) +Lines to add to the configuration file. The value of this field is a +list of strings or G-expressions. +@end table +@end deftp + +@deftp {Data Type} sway-input +@code{sway-input} records describe input blocks +(see@ @cite{sway-input(5)}). Available fields are: + +@table @asis +@item @code{identifier} (default: @code{'*}) +Identifier of the input. The field accepts symbols and strings. If a +string is used, it will be quoted in the generated configuration file. + +@item @code{xkb-layout} (optional) +Keyboard specific option. Comma-separated keyboard layout(s) to use. + +@item @code{xkb-model} (optional) +Keyboard specific option. String providing the keyboard model. + +@item @code{xkb-options} (optional) +Keyboard specific option. Additional xkb options for the keyboard. + +@item @code{xkb-variant} (optional) +Keyboard specific option. String specifying the variant of the layout. + +@item @code{extra-content} (default: @code{'()}) +Lines to add to the input block. The value of this field is a list of +strings. +@end table + +For example, the following snippet makes all keyboards use a french +layout, in which @kbd{capslock} has been remaped to @kbd{ctrl}: +@lisp +(sway-input (identifier "type:keyboard") + (xkb-layout "fr") + (xkb-options '("ctrl:nocaps"))) +@end lisp +@end deftp + +@deftp {Data Type} sway-output +@code{sway-output} records describe sway outputs +(see@ @cite{sway-output(5)}). Available fields are: + +@table @asis +@item @code{identifier} (default: @code{'*}) +Identifier of the monitor. If the +@code{identifier} is a symbol, it is inserted as is; if it is a string, +it will be quoted in the configuration file. + +@item @code{resolution} (optional) +This string defines the resolution of the monitor. + +@item @code{position} (optional) +The (optional) value of this field must be a @code{point}. +Example: +@lisp +(position + (point (x 1920) + (y 0))) +@end lisp + +@item @code{bg} (optional) +This field accepts a file-like value representing the wallpaper to use +on this monitor. It will be used with the @code{fill} option. + +@item @code{extra-content} (default: @code{'()}) +Any additional lines to be added to the output configuration block. +Elements of the list must be either strings or G-expressions. +@end table +@end deftp + +@deftp {Data Type} sway-border-color + +@table @code +@item border +Color of the border. +@item background +Color of the background. +@item text +Color of the text. +@end table +@end deftp + +@deftp {Data Type} sway-color +@table @asis +@item @code{background} (optional string) +Background color of the bar. +@item @code{statusline} (optional string) +Text color of the separator. +@item @code{focused-background} (optional string) +Background color of the bar on the currently focused monitor. +@item @code{focused-statusline} (optional string) +Text color of the statusline on the currently focused monitor. +@item @code{focused-workspace} (optional @code{sway-border-color}) +Color scheme for focused workspaces. +@item @code{active-workspace} (optional @code{sway-border-color}) +Colour scheme for active workspaces. +@item @code{inactive-workspace} (optional @code{sway-border-color}) +Colour scheme for inactive workspaces. +@item @code{urgent-workspace} (optional @code{sway-border-color}) +Colour scheme for workspaces containing `urgent' windows. +@item @code{binding-mode} (optional @code{sway-border-color}) +Colour scheme for the binding mode indicator. +@end table +@end deftp + +@deftp {Data Type} sway-bar +Describes the Sway bar (see@ @cite{sway-bar(5)}). + +@table @asis +@item @code{identifier} (default: @code{'bar0}) +Identifier of the bar. The value must be a string. + +@item @code{position} (default: @code{'top}) +Specify the position of the bar. Accepted values are @code{'top} or +@code{'bottom}. + +@item @code{hidden-state} (default: @code{'hide}) +Specify the apparence of the bar when it is hidden. Accepted values are +@code{'hide} or @code{show}. + +@item @code{binding-mode-indicator} (default: @code{#t}) +Enable or disable the binding mode indicator. + +@item @code{colors} (optional) +An optional @code{sway-color} configuration record. + +@item @code{status-command} (default: @code{%sway-status-command}) +This field accept strings, G-expressions and executable file-like +values. The default value is a command (string) that prints the date +and time every second. + +Each line printed on @code{stdout} by this command (or script) will be +displayed on the status area of the bar. + +Below are a few examples using: +@itemize +@item +a string: @code{"while date +'%Y-%m-%d %X'; do sleep 1; done"}, +@item +a G-exp: +@lisp +#~(string-append "while " + #$coreutils "/bin/date" + " +'%Y-%m-%d %X'; do sleep 1; done") +@end lisp +@item +an executable file: +@lisp +(program-file + "sway-bar-status" + (with-imported-modules + (source-module-closure + '((ice-9 textual-ports) (ice-9 regex) + (ice-9 popen) (ice-9 format) + (srfi srfi-19))) + #~(begin + (use-modules (ice-9 format) + (srfi srfi-19)) + (let loop () + (let* ((date (date->string + (current-date) + "~d/~m/~Y (~a) ~H:~M:~S"))) + (format #t "~a~%~!" date) + (sleep 1) + (loop)))))) +@end lisp +@end itemize +@end table +@end deftp + +@deftp {Data Type} sway-mode +Describes a Sway mode. + +Here is a mockup of the resize mode of the default Sway configuration: +@example +(sway-mode + (mode-name "resize") + (keybindings + '(($left . "resize shrink width 10px") + ($right . "resize grow width 10px") + ($down . "resize grow height 10px") + ($up . "resize shrink height 10px") + (Return . "mode \"default\"") + (Escape . "mode \"default\"")))) +@end example + +@table @asis +@item @code{mode-name} (default @code{"default"}) +Name of the mode. +@item @code{keybindings} (default @code{'()}) +This field describes keybindings. The value is an association list: +keys are symbols and values are either strings or G-expressions. +@item @code{mouse-bindings} (default @code{'()}) +Ditto, but keys are mouse events. +@end table +@end deftp + @node Networking Home Services @subsection Networking Home Services diff --git a/gnu/home/services/sway.scm b/gnu/home/services/sway.scm new file mode 100644 index 0000000000..7d665e7280 --- /dev/null +++ b/gnu/home/services/sway.scm @@ -0,0 +1,711 @@ +;;; GNU Guix --- Functional package management for GNU +;;; Copyright © 2024 Arnaud Daby-Seesaram +;;; +;;; This file is part of GNU Guix. +;;; +;;; GNU Guix is free software; you can redistribute it and/or modify it +;;; under the terms of the GNU General Public License as published by +;;; the Free Software Foundation; either version 3 of the License, or (at +;;; your option) any later version. +;;; +;;; GNU Guix is distributed in the hope that it will be useful, but +;;; WITHOUT ANY WARRANTY; without even the implied warranty of +;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +;;; GNU General Public License for more details. +;;; +;;; You should have received a copy of the GNU General Public License +;;; along with GNU Guix. If not, see . + +(define-module (gnu home services sway) + #:use-module (guix monads) + #:use-module (guix modules) + #:use-module (guix gexp) + #:use-module (srfi srfi-1) + #:use-module (srfi srfi-26) + #:use-module (ice-9 popen) + #:use-module (ice-9 format) + #:use-module (ice-9 match) + #:use-module (guix packages) + #:use-module (gnu services configuration) + #:use-module (gnu home services) + #:use-module (gnu packages freedesktop) + #:use-module (gnu packages xdisorg) + #:use-module (gnu packages image) + #:use-module (gnu packages gnome) + #:use-module (gnu packages wm) + #:use-module (gnu packages emacs) + #:use-module (gnu packages linux) + #:use-module (gnu packages base) + #:use-module (gnu packages suckless) + #:use-module (gnu packages glib) + #:export (;; Event codes + %ev-code-mouse-left + %ev-code-mouse-right + %ev-code-mouse-scroll-click + + ;; Configuration records. + sway-configuration + sway-bar + sway-output + sway-input + point + sway-color + sway-border-color + home-sway-service-type + sway-configuration->file + sway-mode + + ;; Default values. + %sway-default-variables + %sway-default-gestures + %sway-default-keybindings + %sway-default-status-command + %sway-default-execs)) + +;; Helper function. +(define (flatten l) + (let loop ((lst (reverse l)) (acc '())) + (match lst + (() acc) + ((head . tail) + (loop tail (append head acc)))))) + + +;;; +;;; Default settings and useful constants. +;;; + +(define %ev-code-mouse-left 272) +(define %ev-code-mouse-right 273) +(define %ev-code-mouse-scroll-click 274) + +(define %sway-default-variables + `((mod . "Mod4") + (left . "h") + (down . "j") + (up . "k") + (right . "l") + (term . ,(file-append st "/bin/st")) + (menu . ,#~(string-append + #$dmenu "/bin/dmenu_path | " + #$wmenu "/bin/wmenu | " + #$findutils "/bin/xargs " + #$sway "/bin/swaymsg exec --")))) + +(define %sway-default-gestures + '((swipe:3:right . "workspace next_on_output") + (swipe:3:left . "workspace prev_on_output") + (swipe:3:down . "move to scratchpad") + (swipe:3:up . "scratchpad show"))) + +(define %sway-default-keybindings + `(($mod+Return . "exec $term") + ($mod+Shift+q . "kill") + ($mod+d . "exec $menu") + ($mod+Shift+c . "reload") + ($mod+Shift+e + . ,#~(string-append + "exec " #$sway "/bin/swaynag -t warning -m 'You pressed the exit " + "shortcut. Do you really want to exit sway? This will end your " + "Wayland session.' -B 'Yes, exit sway' '" + #$sway "/bin/swaymsg exit'")) + ($mod+$left . "focus left") + ($mod+$down . "focus down") + ($mod+$up . "focus up") + ($mod+$right . "focus right") + ($mod+Left . "focus left") + ($mod+Down . "focus down") + ($mod+Up . "focus up") + ($mod+Right . "focus right") + ($mod+Shift+$left . "move left") + ($mod+Shift+$down . "move down") + ($mod+Shift+$up . "move up") + ($mod+Shift+$right . "move right") + ($mod+Shift+Left . "move left") + ($mod+Shift+Down . "move down") + ($mod+Shift+Up . "move up") + ($mod+Shift+Right . "move right") + ($mod+1 . "workspace number 1") + ($mod+2 . "workspace number 2") + ($mod+3 . "workspace number 3") + ($mod+4 . "workspace number 4") + ($mod+5 . "workspace number 5") + ($mod+6 . "workspace number 6") + ($mod+7 . "workspace number 7") + ($mod+8 . "workspace number 8") + ($mod+9 . "workspace number 9") + ($mod+0 . "workspace number 10") + ($mod+Shift+1 . "move container to workspace number 1") + ($mod+Shift+2 . "move container to workspace number 2") + ($mod+Shift+3 . "move container to workspace number 3") + ($mod+Shift+4 . "move container to workspace number 4") + ($mod+Shift+5 . "move container to workspace number 5") + ($mod+Shift+6 . "move container to workspace number 6") + ($mod+Shift+7 . "move container to workspace number 7") + ($mod+Shift+8 . "move container to workspace number 8") + ($mod+Shift+9 . "move container to workspace number 9") + ($mod+Shift+0 . "move container to workspace number 10") + ($mod+b . "splith") + ($mod+v . "splitv") + ($mod+s . "layout stacking") + ($mod+w . "layout tabbed") + ($mod+e . "layout toggle split") + ($mod+f . "fullscreen") + ($mod+Shift+space . "floating toggle") + ($mod+space . "focus mode_toggle") + ($mod+a . "focus parent") + ($mod+Shift+minus . "move scratchpad") + ($mod+minus . "scratchpad show") + ($mod+r . "mode \"resize\""))) + +(define %sway-default-status-command + "while date +'%Y-%m-%d %X'; do sleep 1; done") + +(define %sway-default-execs + (list + #~(string-append + #$swayidle "/bin/swayidle -w \\\n" + ;; 300: lock screen. + " timeout 300 '" #$swaylock "/bin/swaylock " + "--indicator-radius 75 " + "-i " #$sway "/share/backgrounds/sway/Sway_Wallpaper_Blue_1920x1080.png" + " -f -c 000000' \\\n" + ;; 600: lock + screen off. + " timeout 600 '" #$sway "/bin/swaymsg \"output * power off\"' \\\n" + ;; Resume + sleep. + " resume '" #$sway "/bin/swaymsg \"output * power on\"' \\\n" + " before-sleep '" #$swaylock "/bin/swaylock -f -c 000000'"))) + + +;;; +;;; Definition of configurations. +;;; + +(define (string-ish? s) + (or (gexp? s) + (file-append? s) + (string? s))) + +(define (list-of-string-ish? lst) + (every string-ish? lst)) + +(define (list-of-packages? lst) + (every package? lst)) + +(define (bar-position? p) + (member p '(top bottom))) + +(define (hidden-state? st) + (member st '(hide show))) + +(define (string-or-symbol? s) + (or (string? s) + (symbol? s))) + +(define (strings? lst) + (every string? lst)) + +(define (make-alist-predicate key? val?) + (lambda (lst) + (every + (lambda (item) + (match item + ((k . v) + (and (key? k) + (val? v))) + (_ #f))) + lst))) + +(define bindings? + (make-alist-predicate symbol? string-ish?)) + +(define mouse-bindings? + (make-alist-predicate integer? string-ish?)) + +(define (variables? lst) + (make-alist-predicate symbol? string-ish?)) + +(define-maybe string (no-serialization)) +(define-maybe strings (no-serialization)) + +(define-configuration/no-serialization sway-input + (identifier + (string-or-symbol '*) + "Identifier of the input.") + (xkb-layout + maybe-string + "Keyboard layout.") + (xkb-model + maybe-string + "Keyboard model.") + (xkb-options + maybe-strings + "Keyboard options.") + (xkb-variant + maybe-string + "Keyboard layout variant.") + (extra-content + (strings '()) + "Lines to add at the end of the configuration file.")) + +(define (sway-inputs? lst) + (every sway-input? lst)) + +(define-configuration/no-serialization sway-border-color + (border + string + "Border color.") + (background + string + "Background color.") + (text + string + "Text color.")) + +(define-maybe sway-border-color (no-serialization)) + +(define-configuration/no-serialization sway-color + (background + maybe-string + "Background color of the bar.") + (statusline + maybe-string + "Text color of the separator.") + (focused-background + maybe-string + "Background color of the bar on the currently focused monitor.") + (focused-statusline + maybe-string + "Text color of the statusline on the currently focused monitor.") + (focused-workspace + maybe-sway-border-color + "Colour scheme for focused workspaces.") + (active-workspace + maybe-sway-border-color + "Colour scheme for active workspaces.") + (inactive-workspace + maybe-sway-border-color + "Colour scheme for inactive workspaces.") + (urgent-workspace + maybe-sway-border-color + "Colour scheme for workspaces containing `urgent' windows.") + (binding-mode + maybe-sway-border-color + "Colour scheme for the binding mode indicator.")) + +(define-maybe sway-color (no-serialization)) + +(define (status-command? c) + (or (string? c) + (file-like? c) + (gexp? c))) + +(define-configuration/no-serialization sway-bar + (identifier + (symbol 'bar0) + "Identifier of the bar.") + (position + (bar-position 'top) + "Position of the bar.") + (hidden-state + (hidden-state 'hide) + "Hidden state.") + (binding-mode-indicator + (boolean #t) + "Binding indicator.") + (colors + maybe-sway-color + "Color palette of the bar.") + (status-command + (status-command %sway-default-status-command) + "Status command. It must be file-like.") + (keybindings + (bindings '()) + "Keybindings.") + (mouse-bindings + (mouse-bindings '()) + "Actions triggered by mouse events.") + (extra-content + (list-of-string-ish '()) + "Extra configuration lines.")) + +(define-configuration/no-serialization point + (x integer "X coordinate.") + (y integer "Y coordinate.")) + +(define (file-like-or-gexp? f) + (or (file-like? f) + (gexp? f))) + +(define-maybe point (no-serialization)) +(define-maybe file-like-or-gexp (no-serialization)) + +(define-configuration/no-serialization sway-output + (identifier + (string-or-symbol '*) + "Identifier of the output.") + (resolution + maybe-string + "Mode of the monitor.") + (position + maybe-point + "Position of the monitor.") + (bg + maybe-file-like-or-gexp + "Background image.") + (extra-content + (list-of-string-ish '()) + "Extra lines.")) + +(define (sway-outputs? lst) + (every sway-output? lst)) + +(define-configuration/no-serialization sway-mode + (mode-name + (string "default") + "Name of the mode.") + (keybindings + (bindings '()) + "Keybindings.") + (mouse-bindings + (mouse-bindings '()) + "Mouse bindings.")) +;; TODO: switch bindings. + +(define (sway-modes? lst) + (every sway-mode? lst)) + +(define-configuration/no-serialization sway-configuration + (keybindings + (bindings %sway-default-keybindings) + "Keybindings.") + (gestures + (bindings %sway-default-gestures) + "Gestures.") + (packages + (list-of-packages + (list sway swaylock waybar swaybg slurp grim dmenu bemenu + dbus xdg-desktop-portal-wlr xdg-desktop-portal)) + "List of packages to add to the profile.") + (variables + (variables %sway-default-variables) + "Variables declared at the beginning of the file.") + (inputs + (sway-inputs (list (sway-input))) + "Inputs.") + (outputs + (sway-outputs '()) + "Outputs.") + (bar + (sway-bar (sway-bar)) + "Bar configuration.") + (modes + (sway-modes '()) + "Additional modes.") + (always-execs + (list-of-string-ish '()) + "Programs to execute at startup time.") + (execs + (list-of-string-ish %sway-default-execs) + "Programs to execute at startup time.") + (extra-content + (list-of-string-ish '()) + "Lines to add at the end of the configuration file.")) + + +;;; +;;; Serialization functions. +;;; + +(define (serialize-mouse-binding var) + (let ((ev-code (number->string (car var))) + (command (cdr var))) + #~(string-append "bindcode " #$ev-code " " #$command))) + +(define (serialize-keybinding var) + (let ((name (symbol->string (car var))) + (value (cdr var))) + #~(string-append "bindsym " #$name " " #$value))) + +(define (serialize-gesture var) + (let ((name (symbol->string (car var))) + (value (cdr var))) + #~(string-append "bindgesture " #$name " " #$value))) + +(define (serialize-variable var) + (let ((name (symbol->string (car var))) + (value (cdr var))) + #~(string-append "set $" #$name " " #$value))) + +(define (serialize-exec b) + (if b + (lambda (exe) + #~(string-append "exec_always " #$exe)) + (lambda (exe) + #~(string-append "exec " #$exe)))) + +(define (serialize-output out) + (let* ((pre-ident (sway-output-identifier out)) + (ident (if (symbol? pre-ident) + (symbol->string pre-ident) + (string-append "\"" pre-ident "\""))) + (bg (sway-output-bg out)) + (resolution (sway-output-resolution out)) + (position (sway-output-position out)) + (extra-content (sway-output-extra-content out))) + (append + (filter + (lambda (elt) (not (eq? elt %unset-value))) + (list + ;; Beginning of the block. + #~(string-append "output " #$ident " {") + ;; Optional elements. + (if (eq? %unset-value bg) + %unset-value + #~(string-append " bg " #$bg " fill")) + (if (eq? %unset-value resolution) + %unset-value + (string-append " resolution " resolution)) + (if (eq? %unset-value position) + %unset-value + (string-append " position " (number->string (point-x position)) + " " (number->string (point-y position)))))) + (map + (lambda (s) + #~(string-append " " #$s)) + extra-content) + ;; End of the block. + '("}")))) + +(define-inlinable (add-line-if prefix value) + (if (eq? %unset-value value) + %unset-value + (string-append prefix " " value))) + +(define (serialize-input input) + (let* ((pre-ident (sway-input-identifier input)) + (ident (if (symbol? pre-ident) + (symbol->string pre-ident) + (string-append "\"" pre-ident "\""))) + (xkb-layout (sway-input-xkb-layout input)) + (xkb-model (sway-input-xkb-model input)) + (xkb-variant (sway-input-xkb-variant input)) + (xkb-options (sway-input-xkb-options input))) + (append + (filter + (lambda (elt) (not (eq? elt %unset-value))) + (list + (string-append "input " ident " {") + ;; Optional. + (add-line-if " xkb_layout" xkb-layout) + (add-line-if " xkb_model" xkb-model) + (add-line-if " xkb_variant" xkb-variant) + (if (eq? %unset-value xkb-options) + %unset-value + (string-append " xkb_options " + (string-join xkb-options ","))))) + (map (lambda (s) + (string-append (string-pad "" 4) s)) + (sway-input-extra-content input)) + '("}")))) + +(define (serialize-colors colors) + (define (add-border-color-if name val) + (if (eq? %unset-value val) + %unset-value + (string-append + name + " " (sway-border-color-border val) + " " (sway-border-color-background val) + " " (sway-border-color-text val)))) + (if (eq? %unset-value colors) + '() + (let ((background (sway-color-background colors)) + (statusline (sway-color-statusline colors)) + (focused-background (sway-color-focused-background colors)) + (focused-statusline (sway-color-focused-statusline colors)) + (focused-workspace (sway-color-focused-workspace colors)) + (active-workspace (sway-color-active-workspace colors)) + (inactive-workspace (sway-color-inactive-workspace colors)) + (urgent-workspace (sway-color-urgent-workspace colors)) + (binding-mode (sway-color-binding-mode colors))) + (filter + (lambda (elt) (not (eq? elt %unset-value))) + (list + (add-line-if "background" background) + (add-line-if "statusline" statusline) + (add-line-if "focused_background" focused-background) + (add-line-if "focused_statusline" focused-statusline) + (add-border-color-if "focused_workspace" focused-workspace) + (add-border-color-if "active_workspace" active-workspace) + (add-border-color-if "inactive_workspace" inactive-workspace) + (add-border-color-if "urgent_workspace" urgent-workspace) + (add-border-color-if "binding_mode" binding-mode)))))) + +(define (serialize-sway-mode mode) + (let ((name (sway-mode-mode-name mode)) + (keys (sway-mode-keybindings mode)) + (clicks (sway-mode-mouse-bindings mode)) + (serialize-keybinding + (lambda (kbd) + #~(string-append " " #$(serialize-keybinding kbd)))) + (serialize-mouse-binding + (lambda (kbd) + #~(string-append " " #$(serialize-mouse-binding kbd))))) + (append + (list (string-append "mode \"" name "\" {")) + (map serialize-keybinding keys) + (map serialize-mouse-binding clicks) + '("}")))) + +(define (sway-configuration->file conf) + (let* ((extra (sway-configuration-extra-content conf)) + (bar (sway-configuration-bar conf))) + + (with-imported-modules + (source-module-closure + '((ice-9 popen) (ice-9 match) (ice-9 format) (guix monads))) + (computed-file + "sway-config" + #~(begin + (use-modules (ice-9 format) (ice-9 popen) (ice-9 match) + (guix monads)) + + (let* ((file #$output) + (port (open-output-file #$output))) + + ;; Helper functions to pretty-print the configuration file. + (define (line s) + (lambda (i) + (format port "~a~a~%" (string-pad "" i) s) + i)) + (define (lines lst) + (lambda (i) + (let loop ((l lst)) + (match l + (() #t) + ((head . tail) + (format port "~a~a~%" (string-pad "" i) + (if (list? head) + (string-concatenate head) + head)) + (loop tail)))) + i)) + (define-syntax line* + (syntax-rules () + ((line* elt ...) + (lines (list elt ...))))) + (define-syntax line2 + (syntax-rules () + ((line2 a b) + (line (string-append a b))))) + (define (indent k) + (lambda (i) + (+ i k))) + (define (begin-block name) + (lambda (i) + (format port "~a~a {~%" (string-pad "" i) name) + (+ i 4))) + (define (end-block) + (lambda (i) + (let ((i (- i 4))) + (format port "~a}~%" (string-pad "" i)) + i))) + + ;; The value that is threaded in the following block is the + ;; indentation level. + (with-monad %identity-monad + (>>= + ;; We start with no indentation at all. + (return 0) + ;; Header of the configuration file. + (line* + "#####################################" + "### Auto-generated configuration. ###" + "#####################################" + "# DO NOT EDIT MANUALLY.") + (line* + "" "# Variables." "# ==========" + #$@(map serialize-variable + (sway-configuration-variables conf))) + (line* + "" "# Outputs." "# ========" + #$@(flatten + (map serialize-output + (sway-configuration-outputs conf)))) + (line* + "" "# Inputs." "# =======" + #$@(flatten + (map serialize-input + (sway-configuration-inputs conf)))) + (line* + "" "# Bar configuration." "# ==================") + (begin-block + (string-append + "bar " #$(symbol->string + (sway-bar-identifier bar)))) + (line2 "position " #$(symbol->string + (sway-bar-position bar))) + (line2 "hidden_state " + #$(symbol->string + (sway-bar-hidden-state bar))) + (line2 "status_command " + #$(sway-bar-status-command bar)) + (line2 "binding_mode_indicator " + #$(if (sway-bar-binding-mode-indicator bar) + "true" "false")) + (begin-block "colors") + (line* + #$@(serialize-colors (sway-bar-colors bar))) + (end-block) ;; colors + (line* + #$@(map serialize-keybinding + (sway-bar-keybindings bar))) + (line* + #$@(map serialize-mouse-binding + (sway-bar-mouse-bindings bar))) + (line* + #$@(sway-bar-extra-content bar)) + (end-block) ;; bar + (line* + "" "# Modes." "# ======" + #$@(flatten + (map serialize-sway-mode + (sway-configuration-modes conf)))) + (line* + "" "# Extra configuration content." + "# ============================" + #$@extra) + (line* + "" "# Keybindings." "# ============" + #$@(map serialize-keybinding + (sway-configuration-keybindings conf))) + (line* + "" "# Gestures." "# =========" + #$@(map serialize-gesture + (sway-configuration-gestures conf))) + (line* + "" "# Programs to execute. (at startup & after reloads)" + "# ====================" + #$@(map (serialize-exec #t) + (sway-configuration-always-execs conf))) + (line* + "" "# Programs to execute. (at startup)" + "# ====================" + #$@(map (serialize-exec #f) + (sway-configuration-execs conf))))))))))) + +(define (sway-configuration->files sway-conf) + `((".config/sway/config" ,(sway-configuration->file sway-conf)))) + +(define home-sway-service-type + (service-type + (name 'home-sway-config) + (extensions + (list (service-extension home-files-service-type + sway-configuration->files) + (service-extension home-profile-service-type + sway-configuration-packages))) + (description "Configure Sway by providing a file +@file{~/.config/sway/config}.") + (default-value (sway-configuration)))) diff --git a/gnu/local.mk b/gnu/local.mk index fcdf174099..fc877ebfaf 100644 --- a/gnu/local.mk +++ b/gnu/local.mk @@ -114,6 +114,7 @@ GNU_SYSTEM_MODULES = \ %D%/home/services/shepherd.scm \ %D%/home/services/sound.scm \ %D%/home/services/ssh.scm \ + %D%/home/services/sway.scm \ %D%/home/services/syncthing.scm \ %D%/home/services/mcron.scm \ %D%/home/services/utils.scm \ -- 2.46.0