Plugin: Global Keybinds by gabrielpastori1 · Pull Request #4104 · pear-devs/pear-desktop

gabrielpastori1 · 2025-11-22T20:57:43Z

Global Keybinds Plugin

This plugin enables system-wide global keyboard shortcuts for the music player. It allows you to control media playback, volume, and track ratings (like/dislike) from anywhere in your operating system, even when the application is minimized or not in focus.

🚀 Features

Global Control: Control your music while working in other applications.
Customizable: Remap any action to your preferred key combination via the plugin settings.
Smart Double-Tap: A unique feature that allows you to toggle the player window's visibility by double-pressing the Play/Pause shortcut.

🎹 Default Shortcuts

By default, the plugin is configured with the following key combinations (using Shift + Ctrl to avoid conflicts with common system shortcuts):

Action	Default Shortcut
Play / Pause	`Shift` + `Ctrl` + `Space`
Next Track	`Shift` + `Ctrl` + `Right Arrow`
Previous Track	`Shift` + `Ctrl` + `Left Arrow`
Volume Up	`Shift` + `Ctrl` + `Up Arrow`
Volume Down	`Shift` + `Ctrl` + `Down Arrow`
Like Track	`Shift` + `Ctrl` + `=`
Dislike Track	`Shift` + `Ctrl` + `-`

⚙️ Configuration & Options

You can customize the behavior and key assignments through the plugin menu.

Remapping Keys

Click on the "Keybinds Management" option in the plugin menu. A prompt will appear allowing you to press the new key combination you wish to assign to each action.

Window Visibility Toggle (Double Tap)

Option: Double Tap to Toggle Window Visibility
Default: Enabled
How it works:
- Single Press on the Play/Pause shortcut: Toggles media playback.
- Double Press (quickly): Shows or Hides the application window.

Note: If you disable this option, the Play/Pause shortcut will only control playback, regardless of how fast you press it.

👨‍💻 Author

Gabriel Pastori

🇧🇷 Brazilian Developer
GitHub: gabrielpastori1

🤝 Credits

This plugin was developed using the precise-volume plugin as a base and reference.

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

…l keybinds

…i1/pear-desktop into global-keybindings

…al keybinds

…ybinds

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

…keybinds

…i1/pear-desktop into global-keybindings

…ybinds

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

sharkslovegaming · 2025-12-04T08:56:00Z

How do I add this? Not having a working global keybind is so annoying.

gabrielpastori1 · 2025-12-05T17:15:05Z

How do I add this? Not having a working global keybind is so annoying.

@sharkslovegaming for now we need to wait for the project maintainers to review these changes and publish a new version of the app with the global keybind support.

If you’re comfortable with the technical side, you can check out my branch (https://github.com/gabrielpastori1/pear-desktop/tree/global-keybindings) and build the app locally to use it right away—that’s what I’m doing at the moment.

gabrielpastori1 · 2026-01-08T16:14:19Z

@ArjixWasTaken and @JellyBrick, can you review my PR please?

github-actions · 2026-01-08T16:31:19Z

      : is.macOS()
-        ? 'hiddenInset'
-        : 'default',
+      ? 'hiddenInset'


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

? 'hiddenInset'

? 'hiddenInset'

github-actions · 2026-01-08T16:31:19Z

-        ? 'hiddenInset'
-        : 'default',
+      ? 'hiddenInset'
+      : 'default',


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

: 'default',

: 'default',

github-actions · 2026-01-08T16:31:19Z

      : is.windows()
-        ? userAgents.windows
-        : userAgents.linux;
+      ? userAgents.windows


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

? userAgents.windows

? userAgents.windows

github-actions · 2026-01-08T16:31:19Z

-        ? userAgents.windows
-        : userAgents.linux;
+      ? userAgents.windows
+      : userAgents.linux;


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

: userAgents.linux;

: userAgents.linux;

github-actions · 2026-01-08T16:31:19Z

-          if (acc.cancel) {
-            return acc;
-          }
+      return listeners.reduce(async (accumulator, listener) => {


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ⏎········

Suggested change

return listeners.reduce(async (accumulator, listener) => {

return listeners.reduce(

async (accumulator, listener) => {

github-actions · 2026-01-08T16:31:20Z

+        const acc = await accumulator;
+        if (acc.cancel) {
+          return acc;
+        }


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

}

}

github-actions · 2026-01-08T16:31:20Z

-          return { ...accumulator, ...result };
-        },
-        Promise.resolve({ cancel: false }),
+        const result = await listener.apply();


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

const result = await listener.apply();

const result = await listener.apply();

github-actions · 2026-01-08T16:31:20Z

-        },
-        Promise.resolve({ cancel: false }),
+        const result = await listener.apply();
+        return { ...accumulator, ...result };


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

return { ...accumulator, ...result };

return { ...accumulator, ...result };

github-actions · 2026-01-08T16:31:20Z

-        Promise.resolve({ cancel: false }),
+        const result = await listener.apply();
+        return { ...accumulator, ...result };
+      },


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

},

},

github-actions · 2026-01-08T16:31:20Z

+        const result = await listener.apply();
+        return { ...accumulator, ...result };
+      },
+      Promise.resolve({ cancel: false }),


🚫 [eslint] <prettier/prettier> _{reported by reviewdog 🐶}
Insert ··

Suggested change

Promise.resolve({ cancel: false }),

Promise.resolve({ cancel: false }),

JellyBrick · 2026-01-29T09:01:55Z

Did you use an AI tool to create this PR?

gabrielpastori1 · 2026-01-29T15:22:37Z

Did you use an AI tool to create this PR?

No, the only part where AI was used was in the readme and for bug checking.

ArjixWasTaken · 2026-01-30T07:35:50Z

+## 👨‍💻 Author
+
+**Gabriel Pastori**
+* 🇧🇷 Brazilian Developer
+* GitHub: [gabrielpastori1](https://github.com/gabrielpastori1)


The official way we declare authorship of plugins is via the authors property when declaring the plugin.

e.g. https://github.com/pear-devs/pear-desktop/blob/master/src/plugins/synced-lyrics/index.ts#L14

You can either supply your GitHub username (gabrielpastori1) or use the git author syntax (Gabriel Pastori <email-address>)

The README file feels out of place and has no visibility for the end-user.
(well, the authors property has no visibility either, but that will change once #3066 is merged)

If you feel like the current plugin details are limiting, you can ofc make suggestions to help improve the details system for all plugins.

But using a random README file is unstructured and does no justice to the plugin

gabrielpastori1 and others added 14 commits November 22, 2025 17:42

plugin: global keybinds

2e17757

add readme to global-keybinds plugin

3c37f46

Update src/plugins/global-keybinds/index.ts

50bab7a

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

refactor: remove unused imports and improve type definitions in globa…

3d142fd

…l keybinds

Merge branch 'global-keybindings' of https://github.com/gabrielpastor…

b17ed33

…i1/pear-desktop into global-keybindings

refactor: improve type definitions and clean up menu function in glob…

4d239eb

…al keybinds

fix: remove async from global-keybinds refresh event handler

808effb

fix: corrigir a ordem de importação do BackendContext no plugin de ke…

40e3001

…ybinds

Update src/plugins/global-keybinds/index.ts

57329a9

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

fix: melhorar a mensagem de erro no registro de atalhos do plugin de …

fbd1cf0

…keybinds

Merge branch 'global-keybindings' of https://github.com/gabrielpastor…

ffbf7d5

…i1/pear-desktop into global-keybindings

force github actions run

95a4bf4

fix: corrigir a ordem de importação do BackendContext no plugin de ke…

4032872

…ybinds

Update src/plugins/global-keybinds/index.ts

7c9ca92

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Merge remote-tracking branch 'upstream/master' into global-keybindings

8fbeb29

gabrielpastori1 added 2 commits January 8, 2026 13:21

Merge remote-tracking branch 'origin/master' into global-keybindings

c1c17ab

fix: Refactor import statement and improve code formatting in index.ts

f968b61

github-actions Bot reviewed Jan 8, 2026

View reviewed changes

JellyBrick added the enhancement New feature or request label Jan 29, 2026

ArjixWasTaken reviewed Jan 30, 2026

View reviewed changes

	return listeners.reduce(async (accumulator, listener) => {
	return listeners.reduce(
	async (accumulator, listener) => {

	const result = await listener.apply();
	const result = await listener.apply();

	return { ...accumulator, ...result };
	return { ...accumulator, ...result };

	Promise.resolve({ cancel: false }),
	Promise.resolve({ cancel: false }),

Conversation

gabrielpastori1 commented Nov 22, 2025

Global Keybinds Plugin

🚀 Features

🎹 Default Shortcuts

⚙️ Configuration & Options

Remapping Keys

Window Visibility Toggle (Double Tap)

👨‍💻 Author

🤝 Credits

Uh oh!

sharkslovegaming commented Dec 4, 2025

Uh oh!

gabrielpastori1 commented Dec 5, 2025

Uh oh!

gabrielpastori1 commented Jan 8, 2026

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Jan 8, 2026

Choose a reason for hiding this comment

Uh oh!

JellyBrick commented Jan 29, 2026

Uh oh!

gabrielpastori1 commented Jan 29, 2026

Uh oh!

ArjixWasTaken Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

ArjixWasTaken Jan 30, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants