diff --git a/hosts/common/programs/sway/config b/hosts/common/programs/sway/config
index c893314b8..c4e2f8e94 100644
--- a/hosts/common/programs/sway/config
+++ b/hosts/common/programs/sway/config
@@ -203,6 +203,9 @@ for_window [title="sm64ex-coop: beta 31.0"] {
 
 
 ### displays & inputs
+# totally disable input events generated by buffyboard
+input "26214:25209:rd" events disabled
+
 input type:touchpad {
     # see also: accel_profile, scroll_factor, tap_button_map, clickfinger_button_map
     tap enabled
diff --git a/modules/services/buffyboard.nix b/modules/services/buffyboard.nix
index f8e9d5e92..740d98b46 100644
--- a/modules/services/buffyboard.nix
+++ b/modules/services/buffyboard.nix
@@ -1,3 +1,12 @@
+# buffyboard processes system-wide /dev/input/* events (touchscreen, mouse)
+# and outputs events to a virtual input device.
+# this plays well with keyboard-only software like getty,
+# but for any programs which use both pointer inputs and keyboard inputs (e.g. desktop environments)
+# you likely want to instruct them to ignore the buffyboard device, else clicking or tapping might trigger
+# both a mouse event *and* an undesired keyboard event via buffyboard.
+#
+# for sway, add to ~/.config/sway/config: `input "26214:25209:rd" events disabled`
+#
 { config, lib, pkgs, ... }:
 let
   cfg = config.sane.services.buffyboard;