diff --git a/chroma.conf.sample b/chroma.conf.sample
index d2b2c47..6afd464 100644
--- a/chroma.conf.sample
+++ b/chroma.conf.sample
@@ -52,7 +52,7 @@ anchor_x = 50
 anchor_y = 50
 
 # Image downsampling settings for performance optimization
-# ===================================================
+# ========================================================
 # Enable automatic downsampling of large images to save memory and improve performance
 # Set to false to keep original resolution for all images (uses more memory!)
 enable_downsampling = true
@@ -73,6 +73,21 @@ min_scale_factor = 0.25  # Don't scale below 25% of original size
 # ==================================
 # Basic format: output.OUTPUT_NAME = /path/to/image.ext
 #
+# You can match outputs by name OR by description:
+#   output.DP-1 = /path/to/image.jpg          # Match by port name
+#   output.desc:Samsung = /path/to/image.jpg  # Match by description prefix
+#
+# The description is the human-readable name provided by the compositor
+# via the Wayland wl_output description event. For example, if your
+# monitor reports "Samsung T27A450" as its description, you can use
+# "output.desc:Samsung" to match it. The match is a prefix match, so
+# "output.desc:Sam" would also work.
+#
+# To find your output names and descriptions, run one of these commands:
+#   wlr-randr (for wlroots-based compositors)
+#   wayland-info | grep wl_output
+#   kanshi list-outputs
+#
 # Extended format with per-output settings:
 #   output.OUTPUT_NAME = /path/to/image.ext
 #   output.OUTPUT_NAME.scale = fill|fit|stretch|center
@@ -90,23 +105,6 @@ min_scale_factor = 0.25  # Don't scale below 25% of original size
 #   bottom-left - image anchored to bottom-left corner
 #   bottom-right - image anchored to bottom-right corner
 #
-# To find your output names, run one of these commands:
-#
-#   Compositor Agnostic:
-#   - wlr-randr (for wlroots-based compositors)
-#   - wayland-info | grep wl_output
-#   - kanshi list-outputs
-#
-#   Compositor Specific
-#   - hyprctl monitors -j | jq .[].name (Hyprland specific)
-#
-# Common output name patterns:
-#   - DP-1, DP-2, DP-3, etc. (DisplayPort)
-#   - HDMI-A-1, HDMI-A-2, etc. (HDMI)
-#   - eDP-1 (embedded DisplayPort, laptops)
-#   - DVI-D-1, DVI-I-1 (DVI)
-#   - VGA-1 (VGA, legacy)
-#
 #  Examples:
 #  output.HDMI-A-1 = ~/Pictures/wallpaper.jpg
 #  output.DP-1 = ~/Pictures/monitor1.png
@@ -115,6 +113,14 @@ min_scale_factor = 0.25  # Don't scale below 25% of original size
 #  output.DP-1.anchor = top-left
 #  output.DP-2 = ~/Pictures/monitor2.jpg
 #  output.DP-2.scale = stretch
+#
+#  # Match by monitor description (prefix match):
+#  output.desc:Samsung = ~/Pictures/samsung-wallpaper.jpg
+#  output.desc:Samsung.scale = fill
+#  output.desc:LG Ultra = ~/Pictures/lg-wallpaper.jpg
+#  output.desc:BenQ = ~/Pictures/benq-wallpaper.jpg
+#
+#  # Laptop internal display:
 #  output.eDP-1 = ~/Pictures/laptop-wallpaper.jpg
 #  output.eDP-1.scale = fill
 #  output.eDP-1.anchor = bottom-right