From 931807e32607ac32ed74a7394ab617c09d57aa0a Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sat, 21 Jun 2025 14:21:54 +0200
Subject: [PATCH 1/7] Add a launch_command setting

(and put duplicate code in a function)
---
 src/modules/launcher/mod.rs | 37 ++++++++++++++++++++++++-------------
 src/modules/menu/config.rs  |  5 +++++
 src/modules/menu/mod.rs     |  2 +-
 src/modules/menu/ui.rs      | 17 ++++-------------
 4 files changed, 34 insertions(+), 27 deletions(-)

diff --git a/src/modules/launcher/mod.rs b/src/modules/launcher/mod.rs
index 0a6757f..13338c8 100644
--- a/src/modules/launcher/mod.rs
+++ b/src/modules/launcher/mod.rs
@@ -108,6 +108,9 @@ pub struct LauncherModule {
     #[serde(default, flatten)]
     layout: LayoutConfig,
 
+    #[serde(default = "default_launch_command")]
+    launch_command: String,
+
     /// See [common options](module-level-options#common-options).
     #[serde(flatten)]
     pub common: Option<CommonConfig>,
@@ -158,6 +161,25 @@ fn default_icon_page_forward() -> String {
     String::from("󰅂")
 }
 
+pub(crate) fn default_launch_command() -> String { String::from("gtk-launch") }
+pub fn launch_command(file_name: &String, str: &String) {
+    let launch_command_parts: Vec<&str> = str.split_whitespace().collect();
+    if let Err(err) = Command::new(&launch_command_parts[0])
+        .args(&launch_command_parts[1..])
+        .arg(file_name)
+        .stdout(Stdio::null())
+        .stderr(Stdio::null())
+        .spawn()
+    {
+        error!(
+            "{:?}",
+            Report::new(err)
+            .wrap_err("Failed to run launch command.")
+            .suggestion("Perhaps the applications file is invalid?")
+        );
+    }
+}
+
 const fn default_truncate_popup() -> TruncateMode {
     TruncateMode::Length {
         mode: EllipsizeMode::Middle,
@@ -373,25 +395,14 @@ impl Module<gtk::Box> for LauncherModule {
         let wl = context.client::<wayland::Client>();
 
         let desktop_files = context.ironbar.desktop_files();
+        let launch_command_str: String = self.launch_command.clone();
 
         spawn(async move {
             while let Some(event) = rx.recv().await {
                 if let ItemEvent::OpenItem(app_id) = event {
                     match desktop_files.find(&app_id).await {
                         Ok(Some(file)) => {
-                            if let Err(err) = Command::new("gtk-launch")
-                                .arg(file.file_name)
-                                .stdout(Stdio::null())
-                                .stderr(Stdio::null())
-                                .spawn()
-                            {
-                                error!(
-                                    "{:?}",
-                                    Report::new(err)
-                                        .wrap_err("Failed to run gtk-launch command.")
-                                        .suggestion("Perhaps the applications file is invalid?")
-                                );
-                            }
+                            launch_command(&file.file_name, &launch_command_str);
                         }
                         Ok(None) => warn!("Could not find applications file for {}", app_id),
                         Err(err) => error!("Failed to find parse file for {}: {}", app_id, err),
diff --git a/src/modules/menu/config.rs b/src/modules/menu/config.rs
index 4575880..8efe994 100644
--- a/src/modules/menu/config.rs
+++ b/src/modules/menu/config.rs
@@ -1,5 +1,6 @@
 use crate::config::{CommonConfig, TruncateMode};
 use crate::modules::menu::{MenuEntry, XdgSection};
+use crate::modules::launcher::default_launch_command;
 use indexmap::IndexMap;
 use serde::Deserialize;
 
@@ -123,6 +124,9 @@ pub struct MenuModule {
     /// See [common options](module-level-options#common-options).
     #[serde(flatten)]
     pub common: Option<CommonConfig>,
+
+    #[serde(default = "default_launch_command")]
+    pub launch_command: String,
 }
 
 impl Default for MenuModule {
@@ -139,6 +143,7 @@ impl Default for MenuModule {
             label_icon: None,
             label_icon_size: default_menu_popup_icon_size(),
             common: Some(CommonConfig::default()),
+            launch_command: default_launch_command(),
         }
     }
 }
diff --git a/src/modules/menu/mod.rs b/src/modules/menu/mod.rs
index cd46766..6c9e2d7 100644
--- a/src/modules/menu/mod.rs
+++ b/src/modules/menu/mod.rs
@@ -263,7 +263,7 @@ impl Module<Button> for MenuModule {
                             let container1 = container.clone();
                             let tx = context.tx.clone();
                             let (button, sub_menu) =
-                                ui::make_entry(entry, tx, &image_provider, truncate_mode);
+                                ui::make_entry(entry, tx, &image_provider, truncate_mode, &self.launch_command);
 
                             if let Some(sub_menu) = sub_menu.clone() {
                                 sub_menu.set_valign(alignment);
diff --git a/src/modules/menu/ui.rs b/src/modules/menu/ui.rs
index e5cf3d7..654a69b 100644
--- a/src/modules/menu/ui.rs
+++ b/src/modules/menu/ui.rs
@@ -3,6 +3,7 @@ use crate::channels::AsyncSenderExt;
 use crate::config::TruncateMode;
 use crate::gtk_helpers::{IronbarGtkExt, IronbarLabelExt};
 use crate::modules::ModuleUpdateEvent;
+use crate::modules::launcher::launch_command;
 use crate::script::Script;
 use crate::{image, spawn};
 use color_eyre::{Help, Report};
@@ -17,6 +18,7 @@ pub fn make_entry<R>(
     tx: mpsc::Sender<ModuleUpdateEvent<R>>,
     image_provider: &image::Provider,
     truncate_mode: TruncateMode,
+    launch_command_str: &String,
 ) -> (Button, Option<gtk::Box>)
 where
     R: Send + Clone + 'static,
@@ -96,22 +98,11 @@ where
                 {
                     let sub_menu = sub_menu.clone();
                     let file_name = sub_entry.file_name.clone();
+                    let command = launch_command_str.clone();
                     let tx = tx.clone();
 
                     button.connect_clicked(move |_button| {
-                        if let Err(err) = Command::new("gtk-launch")
-                            .arg(&file_name)
-                            .stdout(Stdio::null())
-                            .stderr(Stdio::null())
-                            .spawn()
-                        {
-                            error!(
-                                "{:?}",
-                                Report::new(err)
-                                    .wrap_err("Failed to run gtk-launch command.")
-                                    .suggestion("Perhaps the applications file is invalid?")
-                            );
-                        }
+                        launch_command(&file_name, &command);
 
                         sub_menu.hide();
                         tx.send_spawn(ModuleUpdateEvent::ClosePopup);

From c2d55a196378c6d261829ee79e6e4593d9bc4ed3 Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sat, 21 Jun 2025 14:47:53 +0200
Subject: [PATCH 2/7] Add documentation for launch_command

---
 docs/modules/Launcher.md    | 1 +
 docs/modules/Menu.md        | 1 +
 src/modules/launcher/mod.rs | 3 +++
 src/modules/menu/config.rs  | 3 +++
 4 files changed, 8 insertions(+)

diff --git a/docs/modules/Launcher.md b/docs/modules/Launcher.md
index 3d6dfa8..6efa18e 100644
--- a/docs/modules/Launcher.md
+++ b/docs/modules/Launcher.md
@@ -19,6 +19,7 @@ Optionally displays a launchable set of favourites.
 | `show_names`                | `boolean`                                   | `false`  | Whether to show app names on the button label. Names will still show on tooltips when set to false.                                                       |
 | `show_icons`                | `boolean`                                   | `true`   | Whether to show app icons on the button.                                                                                                                  |
 | `icon_size`                 | `integer`                                   | `32`     | Size to render icon at (image icons only).                                                                                                                |
+| `launch_command`            | `string`                                    | `gtk-launch` | Command used to launch applications.                                                                                                                  |
 | `reversed`                  | `boolean`                                   | `false`  | Whether to reverse the order of favorites/items                                                                                                           |
 | `minimize_focused`          | `boolean`                                   | `true`   | Whether to minimize a focused window when its icon is clicked. Only minimizes single windows.                                                             |
 | `truncate.mode`             | `'start'` or `'middle'` or `'end'` or `off` | `end`    | Location of the ellipses and where to truncate text from. Applies to application names when `show_names` is enabled.                                      |
diff --git a/docs/modules/Menu.md b/docs/modules/Menu.md
index 793f4d0..ba8becd 100644
--- a/docs/modules/Menu.md
+++ b/docs/modules/Menu.md
@@ -20,6 +20,7 @@ It is also possible to add custom categories and actions into the menu.
 | `label`               | `string`                                             | `≡`              | Label to show on the menu button on the bar.                                                                                                                            |
 | `label_icon`          | `string`                                             | `null`           | Icon to show on the menu button on the bar.                                                                                                                             |
 | `label_icon_size`     | `integer`                                            | `16`             | Size of the label_icon image.                                                                                                                                           |
+| `launch_command`      | `string`                                             | `gtk-launch`     | Command used to launch applications.                                                                                                                                    |
 | `truncate`            | `'start'` or `'middle'` or `'end'` or `off` or `Map` | `off`            | Applies to popup. The location of the ellipses and where to truncate text from. Leave null to avoid truncating. Use the long-hand `Map` version if specifying a length. |
 | `truncate.mode`       | `'start'` or `'middle'` or `'end'` or `off`          | `off`            | Applies to popup. The location of the ellipses and where to truncate text from. Leave null to avoid truncating.                                                         |
 | `truncate.length`     | `integer`                                            | `null`           | Applies to popup. The fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                                                |
diff --git a/src/modules/launcher/mod.rs b/src/modules/launcher/mod.rs
index 13338c8..e7cd9d9 100644
--- a/src/modules/launcher/mod.rs
+++ b/src/modules/launcher/mod.rs
@@ -108,6 +108,9 @@ pub struct LauncherModule {
     #[serde(default, flatten)]
     layout: LayoutConfig,
 
+    /// Command used to launch applications.
+    ///
+    /// **Default**: `gtk-launch`
     #[serde(default = "default_launch_command")]
     launch_command: String,
 
diff --git a/src/modules/menu/config.rs b/src/modules/menu/config.rs
index 8efe994..1b84ae3 100644
--- a/src/modules/menu/config.rs
+++ b/src/modules/menu/config.rs
@@ -125,6 +125,9 @@ pub struct MenuModule {
     #[serde(flatten)]
     pub common: Option<CommonConfig>,
 
+    /// Command used to launch applications.
+    ///
+    /// **Default**: `gtk-launch`
     #[serde(default = "default_launch_command")]
     pub launch_command: String,
 }

From a253a23d570f97c61964e3511124c3951acafeca Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sat, 21 Jun 2025 19:12:22 +0200
Subject: [PATCH 3/7] Remove now unused imports in menu

---
 src/modules/menu/ui.rs | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/modules/menu/ui.rs b/src/modules/menu/ui.rs
index 654a69b..a60da2d 100644
--- a/src/modules/menu/ui.rs
+++ b/src/modules/menu/ui.rs
@@ -6,10 +6,8 @@ use crate::modules::ModuleUpdateEvent;
 use crate::modules::launcher::launch_command;
 use crate::script::Script;
 use crate::{image, spawn};
-use color_eyre::{Help, Report};
 use gtk::prelude::*;
 use gtk::{Align, Button, Label, Orientation};
-use std::process::{Command, Stdio};
 use tokio::sync::mpsc;
 use tracing::{debug, error};
 

From a6f63b3bf1a25ba11929058d6c22435d2bb7751d Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sun, 22 Jun 2025 16:15:33 +0200
Subject: [PATCH 4/7] Improve launch_command

---
 src/config/mod.rs           | 26 +++++++++++++++++++++++++-
 src/modules/launcher/mod.rs | 26 ++++----------------------
 src/modules/menu/config.rs  |  2 +-
 src/modules/menu/mod.rs     |  9 +++++++--
 src/modules/menu/ui.rs      |  6 +++---
 5 files changed, 40 insertions(+), 29 deletions(-)

diff --git a/src/config/mod.rs b/src/config/mod.rs
index 0fb7875..4960d7d 100644
--- a/src/config/mod.rs
+++ b/src/config/mod.rs
@@ -44,9 +44,11 @@ use crate::modules::workspaces::WorkspacesModule;
 
 use crate::modules::{AnyModuleFactory, ModuleFactory, ModuleInfo};
 use cfg_if::cfg_if;
-use color_eyre::Result;
+use color_eyre::{Help, Report, Result};
 use serde::Deserialize;
 use std::collections::HashMap;
+use std::process::{Command, Stdio};
+use tracing::error;
 
 #[cfg(feature = "schema")]
 use schemars::JsonSchema;
@@ -435,3 +437,25 @@ pub const fn default_false() -> bool {
 pub const fn default_true() -> bool {
     true
 }
+
+pub fn default_launch_command() -> String {
+    String::from("gtk-launch")
+}
+
+pub fn launch_command(file_name: &str, str: &str) {
+    let launch_command_parts: Vec<&str> = str.split_whitespace().collect();
+    if let Err(err) = Command::new(&launch_command_parts[0])
+        .args(&launch_command_parts[1..])
+        .arg(file_name)
+        .stdout(Stdio::null())
+        .stderr(Stdio::null())
+        .spawn()
+    {
+        error!(
+            "{:?}",
+            Report::new(err)
+                .wrap_err("Failed to run launch command.")
+                .suggestion("Perhaps the applications file is invalid?")
+        );
+    }
+}
diff --git a/src/modules/launcher/mod.rs b/src/modules/launcher/mod.rs
index e7cd9d9..5b6694e 100644
--- a/src/modules/launcher/mod.rs
+++ b/src/modules/launcher/mod.rs
@@ -7,17 +7,18 @@ use self::open_state::OpenState;
 use super::{Module, ModuleInfo, ModuleParts, ModulePopup, ModuleUpdateEvent, WidgetContext};
 use crate::channels::{AsyncSenderExt, BroadcastReceiverExt};
 use crate::clients::wayland::{self, ToplevelEvent};
-use crate::config::{CommonConfig, EllipsizeMode, LayoutConfig, TruncateMode};
+use crate::config::{
+    CommonConfig, EllipsizeMode, LayoutConfig, TruncateMode, default_launch_command, launch_command,
+};
 use crate::gtk_helpers::{IronbarGtkExt, IronbarLabelExt};
 use crate::modules::launcher::item::ImageTextButton;
 use crate::modules::launcher::pagination::{IconContext, Pagination};
 use crate::{arc_mut, lock, module_impl, spawn, write_lock};
-use color_eyre::{Help, Report};
+use color_eyre::Report;
 use gtk::prelude::*;
 use gtk::{Button, Orientation};
 use indexmap::IndexMap;
 use serde::Deserialize;
-use std::process::{Command, Stdio};
 use std::sync::Arc;
 use tokio::sync::mpsc;
 use tracing::{debug, error, trace, warn};
@@ -164,25 +165,6 @@ fn default_icon_page_forward() -> String {
     String::from("󰅂")
 }
 
-pub(crate) fn default_launch_command() -> String { String::from("gtk-launch") }
-pub fn launch_command(file_name: &String, str: &String) {
-    let launch_command_parts: Vec<&str> = str.split_whitespace().collect();
-    if let Err(err) = Command::new(&launch_command_parts[0])
-        .args(&launch_command_parts[1..])
-        .arg(file_name)
-        .stdout(Stdio::null())
-        .stderr(Stdio::null())
-        .spawn()
-    {
-        error!(
-            "{:?}",
-            Report::new(err)
-            .wrap_err("Failed to run launch command.")
-            .suggestion("Perhaps the applications file is invalid?")
-        );
-    }
-}
-
 const fn default_truncate_popup() -> TruncateMode {
     TruncateMode::Length {
         mode: EllipsizeMode::Middle,
diff --git a/src/modules/menu/config.rs b/src/modules/menu/config.rs
index 1b84ae3..1d72386 100644
--- a/src/modules/menu/config.rs
+++ b/src/modules/menu/config.rs
@@ -1,6 +1,6 @@
+use crate::config::default_launch_command;
 use crate::config::{CommonConfig, TruncateMode};
 use crate::modules::menu::{MenuEntry, XdgSection};
-use crate::modules::launcher::default_launch_command;
 use indexmap::IndexMap;
 use serde::Deserialize;
 
diff --git a/src/modules/menu/mod.rs b/src/modules/menu/mod.rs
index 6c9e2d7..2c58526 100644
--- a/src/modules/menu/mod.rs
+++ b/src/modules/menu/mod.rs
@@ -262,8 +262,13 @@ impl Module<Button> for MenuModule {
                         for entry in $entries.values() {
                             let container1 = container.clone();
                             let tx = context.tx.clone();
-                            let (button, sub_menu) =
-                                ui::make_entry(entry, tx, &image_provider, truncate_mode, &self.launch_command);
+                            let (button, sub_menu) = ui::make_entry(
+                                entry,
+                                tx,
+                                &image_provider,
+                                truncate_mode,
+                                &self.launch_command,
+                            );
 
                             if let Some(sub_menu) = sub_menu.clone() {
                                 sub_menu.set_valign(alignment);
diff --git a/src/modules/menu/ui.rs b/src/modules/menu/ui.rs
index a60da2d..e311910 100644
--- a/src/modules/menu/ui.rs
+++ b/src/modules/menu/ui.rs
@@ -1,9 +1,9 @@
 use super::MenuEntry;
 use crate::channels::AsyncSenderExt;
 use crate::config::TruncateMode;
+use crate::config::launch_command;
 use crate::gtk_helpers::{IronbarGtkExt, IronbarLabelExt};
 use crate::modules::ModuleUpdateEvent;
-use crate::modules::launcher::launch_command;
 use crate::script::Script;
 use crate::{image, spawn};
 use gtk::prelude::*;
@@ -16,7 +16,7 @@ pub fn make_entry<R>(
     tx: mpsc::Sender<ModuleUpdateEvent<R>>,
     image_provider: &image::Provider,
     truncate_mode: TruncateMode,
-    launch_command_str: &String,
+    launch_command_str: &str,
 ) -> (Button, Option<gtk::Box>)
 where
     R: Send + Clone + 'static,
@@ -96,7 +96,7 @@ where
                 {
                     let sub_menu = sub_menu.clone();
                     let file_name = sub_entry.file_name.clone();
-                    let command = launch_command_str.clone();
+                    let command = launch_command_str.to_string();
                     let tx = tx.clone();
 
                     button.connect_clicked(move |_button| {

From d2f46a59b4c13e3f6ff81322f72114b89ffbb1f9 Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sun, 22 Jun 2025 16:45:17 +0200
Subject: [PATCH 5/7] Make launch_command more flexible with {app_name}

---
 src/config/mod.rs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/config/mod.rs b/src/config/mod.rs
index 4960d7d..11661ff 100644
--- a/src/config/mod.rs
+++ b/src/config/mod.rs
@@ -439,14 +439,14 @@ pub const fn default_true() -> bool {
 }
 
 pub fn default_launch_command() -> String {
-    String::from("gtk-launch")
+    String::from("gtk-launch {app_name}")
 }
 
 pub fn launch_command(file_name: &str, str: &str) {
-    let launch_command_parts: Vec<&str> = str.split_whitespace().collect();
+    let expanded = str.replace("{app_name}", file_name);
+    let launch_command_parts: Vec<&str> = expanded.split_whitespace().collect();
     if let Err(err) = Command::new(&launch_command_parts[0])
         .args(&launch_command_parts[1..])
-        .arg(file_name)
         .stdout(Stdio::null())
         .stderr(Stdio::null())
         .spawn()

From 8dfca4303dc3dd9bb557804289c0d876b642f725 Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sun, 22 Jun 2025 16:53:43 +0200
Subject: [PATCH 6/7] Update docs to mention {app_name} in launch_command

---
 docs/modules/Launcher.md | 36 ++++++++++++++++++------------------
 docs/modules/Menu.md     | 30 +++++++++++++++---------------
 2 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/docs/modules/Launcher.md b/docs/modules/Launcher.md
index 6efa18e..08561e6 100644
--- a/docs/modules/Launcher.md
+++ b/docs/modules/Launcher.md
@@ -13,24 +13,24 @@ Optionally displays a launchable set of favourites.
 
 > Type: `launcher`
 
-|                             | Type                                        | Default  | Description                                                                                                                                               |
-|-----------------------------|---------------------------------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `favorites`                 | `string[]`                                  | `[]`     | List of app IDs (or classes) to always show at the start of the launcher.                                                                                 |
-| `show_names`                | `boolean`                                   | `false`  | Whether to show app names on the button label. Names will still show on tooltips when set to false.                                                       |
-| `show_icons`                | `boolean`                                   | `true`   | Whether to show app icons on the button.                                                                                                                  |
-| `icon_size`                 | `integer`                                   | `32`     | Size to render icon at (image icons only).                                                                                                                |
-| `launch_command`            | `string`                                    | `gtk-launch` | Command used to launch applications.                                                                                                                  |
-| `reversed`                  | `boolean`                                   | `false`  | Whether to reverse the order of favorites/items                                                                                                           |
-| `minimize_focused`          | `boolean`                                   | `true`   | Whether to minimize a focused window when its icon is clicked. Only minimizes single windows.                                                             |
-| `truncate.mode`             | `'start'` or `'middle'` or `'end'` or `off` | `end`    | Location of the ellipses and where to truncate text from. Applies to application names when `show_names` is enabled.                                      |
-| `truncate.length`           | `integer`                                   | `null`   | Fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                                                        |
-| `truncate.max_length`       | `integer`                                   | `null`   | Maximum number of characters before truncating. Leave blank to let GTK automatically handle.                                                              |
-| `truncate_popup.mode`       | `'start'` or `'middle'` or `'end'` or `off` | `middle` | Location of the ellipses and where to truncate text from. Applies to window names within a group popup.                                                   |
-| `truncate_popup.length`     | `integer`                                   | `null`   | Fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                                                        |
-| `truncate_popup.max_length` | `integer`                                   | `25`     | Maximum number of characters before truncating. Leave blank to let GTK automatically handle.                                                              |
-| `page_size`                 | `integer`                                   | `1000`   | Number of items to show on a page. When the number of items is reached, controls appear which can be used to move forward/back through the list of items. |
-| `icons.page_back`           | `string` or [image](images)                 | `󰅁`     | Icon to show for page back button.                                                                                                                        |                                                                                                                                                         
-| `icons.page_forward`        | `string` or [image](images)                 | `󰅂`     | Icon to show for page forward button.                                                                                                                     |                                                                                                                                                         
+|                             | Type                                        | Default                 | Description                                                                                                                                               |
+|-----------------------------|---------------------------------------------|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `favorites`                 | `string[]`                                  | `[]`                    | List of app IDs (or classes) to always show at the start of the launcher.                                                                                 |
+| `show_names`                | `boolean`                                   | `false`                 | Whether to show app names on the button label. Names will still show on tooltips when set to false.                                                       |
+| `show_icons`                | `boolean`                                   | `true`                  | Whether to show app icons on the button.                                                                                                                  |
+| `icon_size`                 | `integer`                                   | `32`                    | Size to render icon at (image icons only).                                                                                                                |
+| `launch_command`            | `string`                                    | `gtk-launch {app_name}` | Command used to launch applications.                                                                                                                  |
+| `reversed`                  | `boolean`                                   | `false`                 | Whether to reverse the order of favorites/items                                                                                                           |
+| `minimize_focused`          | `boolean`                                   | `true`                  | Whether to minimize a focused window when its icon is clicked. Only minimizes single windows.                                                             |
+| `truncate.mode`             | `'start'` or `'middle'` or `'end'` or `off` | `end`                   | Location of the ellipses and where to truncate text from. Applies to application names when `show_names` is enabled.                                      |
+| `truncate.length`           | `integer`                                   | `null`                  | Fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                                                        |
+| `truncate.max_length`       | `integer`                                   | `null`                  | Maximum number of characters before truncating. Leave blank to let GTK automatically handle.                                                              |
+| `truncate_popup.mode`       | `'start'` or `'middle'` or `'end'` or `off` | `middle`                | Location of the ellipses and where to truncate text from. Applies to window names within a group popup.                                                   |
+| `truncate_popup.length`     | `integer`                                   | `null`                  | Fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                                                        |
+| `truncate_popup.max_length` | `integer`                                   | `25`                    | Maximum number of characters before truncating. Leave blank to let GTK automatically handle.                                                              |
+| `page_size`                 | `integer`                                   | `1000`                  | Number of items to show on a page. When the number of items is reached, controls appear which can be used to move forward/back through the list of items. |
+| `icons.page_back`           | `string` or [image](images)                 | `󰅁`                    | Icon to show for page back button.                                                                                                                        |                                                                                                                                                         
+| `icons.page_forward`        | `string` or [image](images)                 | `󰅂`                    | Icon to show for page forward button.                                                                                                                     |                                                                                                                                                         
 <details>
 <summary>JSON</summary>
 
diff --git a/docs/modules/Menu.md b/docs/modules/Menu.md
index ba8becd..53617e1 100644
--- a/docs/modules/Menu.md
+++ b/docs/modules/Menu.md
@@ -10,21 +10,21 @@ It is also possible to add custom categories and actions into the menu.
 
 ## Configuration
 
-|                       | Type                                                 | Default          | Description                                                                                                                                                             |
-|-----------------------|------------------------------------------------------|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `start`               | `MenuEntry[]`                                        | `[]`             | Items to add to the start of the main menu.                                                                                                                             |
-| `center`              | `MenuEntry[]`                                        | Default XDG menu | Items to add to the centre of the main menu. By default this shows a number of XDG entries that should cover all common applications.                                   |
-| `end`                 | `MenuEntry[]`                                        | `[]`             | Items to add to the end of the main menu.                                                                                                                               |
-| `height`              | `integer`                                            | `null`           | Height of the menu. Leave null to resize dynamically.                                                                                                                   |
-| `width`               | `integer`                                            | `null`           | Width of the menu. Leave null to resize dynamically.                                                                                                                    |
-| `label`               | `string`                                             | `≡`              | Label to show on the menu button on the bar.                                                                                                                            |
-| `label_icon`          | `string`                                             | `null`           | Icon to show on the menu button on the bar.                                                                                                                             |
-| `label_icon_size`     | `integer`                                            | `16`             | Size of the label_icon image.                                                                                                                                           |
-| `launch_command`      | `string`                                             | `gtk-launch`     | Command used to launch applications.                                                                                                                                    |
-| `truncate`            | `'start'` or `'middle'` or `'end'` or `off` or `Map` | `off`            | Applies to popup. The location of the ellipses and where to truncate text from. Leave null to avoid truncating. Use the long-hand `Map` version if specifying a length. |
-| `truncate.mode`       | `'start'` or `'middle'` or `'end'` or `off`          | `off`            | Applies to popup. The location of the ellipses and where to truncate text from. Leave null to avoid truncating.                                                         |
-| `truncate.length`     | `integer`                                            | `null`           | Applies to popup. The fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                                                |
-| `truncate.max_length` | `integer`                                            | `null`           | Applies to popup. The maximum number of characters before truncating. Leave blank to let GTK automatically handle.                                                      |
+|                       | Type                                                 | Default                 | Description                                                                                                                             |
+|-----------------------|------------------------------------------------------|-------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|
+| `start`               | `MenuEntry[]`                                        | `[]`                    | Items to add to the start of the main menu.                                                                                             |
+| `center`              | `MenuEntry[]`                                        | Default XDG menu        | Items to add to the centre of the main menu. By default this shows a number of XDG entries that should cover all common applications.   |
+| `end`                 | `MenuEntry[]`                                        | `[]`                    | Items to add to the end of the main menu.                                                                                               |
+| `height`              | `integer`                                            | `null`                  | Height of the menu. Leave null to resize dynamically.                                                                                   |
+| `width`               | `integer`                                            | `null`                  | Width of the menu. Leave null to resize dynamically.                                                                                    |
+| `label`               | `string`                                             | `≡`                     | Label to show on the menu button on the bar.                                                                                            |
+| `label_icon`          | `string`                                             | `null`                  | Icon to show on the menu button on the bar.                                                                                             |
+| `label_icon_size`     | `integer`                                            | `16`                    | Size of the label_icon image.                                                                                                           |
+| `launch_command`      | `string`                                             | `gtk-launch {app_name}` | Command used to launch applications.                                                                                                    |
+| `truncate`            | `'start'` or `'middle'` or `'end'` or `off` or `Map` | `off`                   | Applies to popup. The location of the ellipses and where to truncate text from. Leave null to avoid truncating. Use the long-hand `Map` version if specifying a length. |
+| `truncate.mode`       | `'start'` or `'middle'` or `'end'` or `off`          | `off`                   | Applies to popup. The location of the ellipses and where to truncate text from. Leave null to avoid truncating.                         |
+| `truncate.length`     | `integer`                                            | `null`                  | Applies to popup. The fixed width (in chars) of the widget. Leave blank to let GTK automatically handle.                                |
+| `truncate.max_length` | `integer`                                            | `null`                  | Applies to popup. The maximum number of characters before truncating. Leave blank to let GTK automatically handle.                      |
 
 
 ### `MenuEntry`

From d89189310154740f3f8be6c06509c2b1cd1529bd Mon Sep 17 00:00:00 2001
From: Username404-59 <w.iron.zombie@gmail.com>
Date: Sun, 22 Jun 2025 18:31:22 +0200
Subject: [PATCH 7/7] Rename launch_command to open_program & move it to
 desktop_file.rs

---
 src/config/mod.rs           | 22 +---------------------
 src/desktop_file.rs         | 24 ++++++++++++++++++++++--
 src/modules/launcher/mod.rs |  5 +++--
 src/modules/menu/ui.rs      |  4 ++--
 4 files changed, 28 insertions(+), 27 deletions(-)

diff --git a/src/config/mod.rs b/src/config/mod.rs
index 11661ff..3fba57e 100644
--- a/src/config/mod.rs
+++ b/src/config/mod.rs
@@ -44,11 +44,9 @@ use crate::modules::workspaces::WorkspacesModule;
 
 use crate::modules::{AnyModuleFactory, ModuleFactory, ModuleInfo};
 use cfg_if::cfg_if;
-use color_eyre::{Help, Report, Result};
+use color_eyre::Result;
 use serde::Deserialize;
 use std::collections::HashMap;
-use std::process::{Command, Stdio};
-use tracing::error;
 
 #[cfg(feature = "schema")]
 use schemars::JsonSchema;
@@ -441,21 +439,3 @@ pub const fn default_true() -> bool {
 pub fn default_launch_command() -> String {
     String::from("gtk-launch {app_name}")
 }
-
-pub fn launch_command(file_name: &str, str: &str) {
-    let expanded = str.replace("{app_name}", file_name);
-    let launch_command_parts: Vec<&str> = expanded.split_whitespace().collect();
-    if let Err(err) = Command::new(&launch_command_parts[0])
-        .args(&launch_command_parts[1..])
-        .stdout(Stdio::null())
-        .stderr(Stdio::null())
-        .spawn()
-    {
-        error!(
-            "{:?}",
-            Report::new(err)
-                .wrap_err("Failed to run launch command.")
-                .suggestion("Perhaps the applications file is invalid?")
-        );
-    }
-}
diff --git a/src/desktop_file.rs b/src/desktop_file.rs
index 3fdf346..8b0a509 100644
--- a/src/desktop_file.rs
+++ b/src/desktop_file.rs
@@ -1,12 +1,13 @@
 use crate::spawn;
-use color_eyre::Result;
+use color_eyre::{Help, Report, Result};
 use std::collections::HashMap;
 use std::env;
 use std::path::{Path, PathBuf};
+use std::process::{Command, Stdio};
 use std::sync::Arc;
 use tokio::io::{AsyncBufReadExt, BufReader};
 use tokio::sync::Mutex;
-use tracing::debug;
+use tracing::{debug, error};
 use walkdir::{DirEntry, WalkDir};
 
 #[derive(Debug, Clone)]
@@ -323,6 +324,25 @@ fn files(dir: &Path) -> Vec<PathBuf> {
         .collect()
 }
 
+/// Starts a `.desktop` file with the provided formatted command.
+pub fn open_program(file_name: &str, str: &str) {
+    let expanded = str.replace("{app_name}", file_name);
+    let launch_command_parts: Vec<&str> = expanded.split_whitespace().collect();
+    if let Err(err) = Command::new(&launch_command_parts[0])
+        .args(&launch_command_parts[1..])
+        .stdout(Stdio::null())
+        .stderr(Stdio::null())
+        .spawn()
+    {
+        error!(
+            "{:?}",
+            Report::new(err)
+                .wrap_err("Failed to run launch command.")
+                .suggestion("Perhaps the applications file is invalid?")
+        );
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
diff --git a/src/modules/launcher/mod.rs b/src/modules/launcher/mod.rs
index 5b6694e..0bdfbb2 100644
--- a/src/modules/launcher/mod.rs
+++ b/src/modules/launcher/mod.rs
@@ -8,8 +8,9 @@ use super::{Module, ModuleInfo, ModuleParts, ModulePopup, ModuleUpdateEvent, Wid
 use crate::channels::{AsyncSenderExt, BroadcastReceiverExt};
 use crate::clients::wayland::{self, ToplevelEvent};
 use crate::config::{
-    CommonConfig, EllipsizeMode, LayoutConfig, TruncateMode, default_launch_command, launch_command,
+    CommonConfig, EllipsizeMode, LayoutConfig, TruncateMode, default_launch_command,
 };
+use crate::desktop_file::open_program;
 use crate::gtk_helpers::{IronbarGtkExt, IronbarLabelExt};
 use crate::modules::launcher::item::ImageTextButton;
 use crate::modules::launcher::pagination::{IconContext, Pagination};
@@ -387,7 +388,7 @@ impl Module<gtk::Box> for LauncherModule {
                 if let ItemEvent::OpenItem(app_id) = event {
                     match desktop_files.find(&app_id).await {
                         Ok(Some(file)) => {
-                            launch_command(&file.file_name, &launch_command_str);
+                            open_program(&file.file_name, &launch_command_str);
                         }
                         Ok(None) => warn!("Could not find applications file for {}", app_id),
                         Err(err) => error!("Failed to find parse file for {}: {}", app_id, err),
diff --git a/src/modules/menu/ui.rs b/src/modules/menu/ui.rs
index e311910..7c7cb1e 100644
--- a/src/modules/menu/ui.rs
+++ b/src/modules/menu/ui.rs
@@ -1,7 +1,7 @@
 use super::MenuEntry;
 use crate::channels::AsyncSenderExt;
 use crate::config::TruncateMode;
-use crate::config::launch_command;
+use crate::desktop_file::open_program;
 use crate::gtk_helpers::{IronbarGtkExt, IronbarLabelExt};
 use crate::modules::ModuleUpdateEvent;
 use crate::script::Script;
@@ -100,7 +100,7 @@ where
                     let tx = tx.clone();
 
                     button.connect_clicked(move |_button| {
-                        launch_command(&file_name, &command);
+                        open_program(&file_name, &command);
 
                         sub_menu.hide();
                         tx.send_spawn(ModuleUpdateEvent::ClosePopup);