feat: add mouse scroll action scripting to notificaiton #1489

leyuskckiran1510 · 2025-06-21T12:38:07Z

Adds mouse scroll action scripting to the notification,

how to use it

add mouse action mouse_scroll_forward = forward_script as and mouse_scroll_backward = back_script [optional as it's by default]
now add your costume rule to trigger for notification in your dunstrc;

# a example 
[volume]
    sumamry = "changevolume"
    script_mouse_forward = change_vup
    script_mouse_back = change_vdown

[note:- script_mouse_forward/back takes single word script to run, you cannot put long script their, make a file of the script you want to execute, and give it a simple single word name and add that to path, do not forget to add executable flag chmod +x my_script ]

now you can do something like dunstify "changevolume" "volume=10%"
now if you hover to that notification and scroll with mouse wheel, your script should be triggred

why we need this

this allows us to control linear actions, through our mouse wheel, instead of just clicking on mouse.
this opens ups the possibility of triggering actions, when needed, for example if you have a setup which warns if volume it to high. You can just use mouse wheel to change the volume.

TODOS:

if this concept is liked my many, we can also add feature like script_mouse_click1/2/3
so that we can execute different set of scripts for different mouse action

Closes #1490

leyuskckiran1510 · 2025-06-21T13:00:49Z

demo video

output.mp4

bynect · 2025-06-22T16:46:38Z

hello. thank you for the contribution. I like the idea however there are some things we might improve. I am busy right now so I will just leave some initial review. also please fix the errors

bynect · 2025-06-22T16:47:28Z

dunstrc

    # These values can be strung together for each mouse event, and
    # will be executed in sequence.
    mouse_left_click = close_current
    mouse_middle_click = do_action, close_current
    mouse_right_click = close_all
+    mouse_scroll_forward = forward_script
+    mouse_scroll_backward = back_script


a more standard way to say this is scroll up/down

okay will make those changes tonight and push it, I tried to follow the convention of x11 constant for mouse button, will make those changes

src/settings_data.h

src/notification.h

leyuskckiran1510 · 2025-06-23T07:31:40Z

hello. thank you for the contribution. I like the idea however there are some things we might improve. I am busy right now so I will just leave some initial review. also please fix the errors

about the error, their seems to be memory leak issue in my code, will fix those issues to, thank you

leyuskckiran1510 · 2025-06-24T07:01:47Z

hello. thank you for the contribution. I like the idea however there are some things we might improve. I am busy right now so I will just leave some initial review. also please fix the errors

about the error, their seems to be memory leak issue in my code, will fix those issues to, thank you

i am working on, it will update when I am done, rn now busy with other stuffs

bynect · 2025-06-24T19:50:18Z

dont worry. let me know when its ready for review

leyuskckiran1510 · 2025-06-27T12:44:53Z

@bynect could you rerun the workflow, I think the leak was due the mouse_script_scroll not being freed, I think the last commits solves the issue. Could you verify that and let me know if that fixes

codecov-commenter · 2025-06-27T16:57:00Z

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

Attention: Patch coverage is 16.25000% with 67 lines in your changes missing coverage. Please review.

Project coverage is 64.49%. Comparing base (fb59a30) to head (15bef64).

Files with missing lines	Patch %	Lines
src/notification.c	17.50%	33 Missing ⚠️
src/rules.c	18.18%	18 Missing ⚠️
src/input.c	0.00%	12 Missing ⚠️
src/x11/x.c	0.00%	4 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1489      +/-   ##
==========================================
- Coverage   64.90%   64.49%   -0.42%     
==========================================
  Files          51       51              
  Lines        9024     9100      +76     
  Branches     1048     1065      +17     
==========================================
+ Hits         5857     5869      +12     
- Misses       3167     3231      +64

Flag	Coverage Δ
unittests	`64.49% <16.25%> (-0.42%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

leyuskckiran1510 · 2025-07-07T13:59:29Z

@bynect Do i need to make 100% code coverage too ? or the task here is done for me.
Please do let me know on changes required.

bynect · 2025-07-07T14:00:36Z

Sorry right now I can't review

bynect · 2025-07-09T09:42:48Z

src/input.c

                        if (n) {
                                if (act == MOUSE_CLOSE_CURRENT) {
                                        n->marked_for_closure = REASON_USER;
                                } else if (act == MOUSE_DO_ACTION) {
                                        notification_do_action(n);
                                } else if (act == MOUSE_OPEN_URL) {
                                        notification_open_url(n);
+                                } else if (act == MOUSE_SCROLL_SCRIPT){


could you please properly indent this? we leave a space between if and (
also spaces between == and commas. but the content seems right

bynect · 2025-07-09T09:43:33Z

src/notification.c

        printf("}\n");
        fflush(stdout);
 }

 /* see notification.h */
 void notification_run_script(struct notification *n)
 {
+


this newline seems unnecessary

bynect · 2025-07-09T09:44:42Z

src/notification.h

@@ -19,6 +18,12 @@ enum icon_position {
        ICON_OFF
 };

+enum mouse_action_type{
+    MOUSE_ACTION_OTHERS=0,


=0 is unnecessary

bynect · 2025-07-09T09:46:24Z

src/notification.h

@@ -86,8 +91,17 @@ struct notification {

        enum markup_mode markup;
        char *format;
+
+        enum mouse_action_type script_choice;


rather than having this choice variable inside notification I would rather add mouse_action parameter to run_script function. this seems a bit more clean and you don't risk forgetting to set the type of action beforehand

bynect · 2025-07-09T09:49:22Z

src/x11/x.c

@@ -26,6 +26,8 @@
 #define BTN_RIGHT   (0x111)
 #define BTN_MIDDLE  (0x112)
 #define BTN_TOUCH   (0x14a)
+#define BTN_FORWARD (0x115)


maybe is better to change this as well to SCROLL_UP / SCROLL_DOWN ?
because there are the lateral mouse buttons called forward and backward and it could cause confusion eventually?

bynect · 2025-07-09T09:49:51Z

src/settings_data.h

+        {
+                .name = "mouse_scroll_down",
+                .section = "global",
+                .description = "Action of right click event",


please update the description. also of scroll_up

bynect · 2025-07-09T10:01:32Z

src/notification.c


-                const char *script = n->scripts[i];
+                const char *script;


i am not sure about this behaviour. script specified with always_run_script should run even if you use a button I think.
is there a reason for this structure of the code?

bynect · 2025-07-09T10:02:40Z

I left a review. mostly it is formatting. but there are some architecture changes I suggest. let me know what do you think

leyuskckiran1510 · 2025-07-10T06:44:41Z

I left a review. mostly it is formatting. but there are some architecture changes I suggest. let me know what do you think

okay I will make those changes and let you know, thank you for the time to review the code

leyuskckiran1510 added 3 commits June 21, 2025 18:01

docs: update default dunstrc with usage example

4fa0c13

feat: add mouse scroll action scripting to notificaiton

403f579

typo: fix forward_script typo in dunstrc example

9befcaf

bynect reviewed Jun 22, 2025

View reviewed changes

src/settings_data.h Outdated Show resolved Hide resolved

bynect reviewed Jun 22, 2025

View reviewed changes

src/notification.h Show resolved Hide resolved

resolve: resolve requested changes

e5dd87f

fix: fix memory leak

0547104

fix: fix rule scroll script memory leak

15bef64

bynect reviewed Jul 9, 2025

View reviewed changes

feat: add mouse scroll action scripting to notificaiton #1489

Are you sure you want to change the base?

feat: add mouse scroll action scripting to notificaiton #1489

Uh oh!

Conversation

leyuskckiran1510 commented Jun 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Adds mouse scroll action scripting to the notification,

how to use it

why we need this

TODOS:

Uh oh!

leyuskckiran1510 commented Jun 21, 2025

Uh oh!

bynect commented Jun 22, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

leyuskckiran1510 Jun 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

leyuskckiran1510 commented Jun 23, 2025

Uh oh!

leyuskckiran1510 commented Jun 24, 2025

Uh oh!

bynect commented Jun 24, 2025

Uh oh!

leyuskckiran1510 commented Jun 27, 2025

Uh oh!

codecov-commenter commented Jun 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

leyuskckiran1510 commented Jul 7, 2025

Uh oh!

bynect commented Jul 7, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

bynect commented Jul 9, 2025

Uh oh!

leyuskckiran1510 commented Jul 10, 2025

Uh oh!

Uh oh!

leyuskckiran1510 commented Jun 21, 2025 •

edited

Loading

leyuskckiran1510 Jun 23, 2025 •

edited

Loading

codecov-commenter commented Jun 27, 2025 •

edited

Loading