Autostart Module

The Autostart Module allows you to configure the Bubbledesk Bridge application to start automatically when the user logs into their system. This feature ensures that the app is ready and running without manual intervention after system startup.

Overview

Automatic startup is useful for background services or apps that need to maintain persistent connections.

It supports multiple startup modes to control how the app appears on launch:

• shown: The app window is displayed normally.
• minimized: The app starts minimized to the taskbar or dock.
• hidden: The app starts without showing any window.

You can enable or disable autostart and specify the preferred startup mode according to your needs.

Methods

Method	Description
enable()	Enables autostart for the app.
disable()	Disables autostart for the app.
isEnabled()	Returns a boolean indicating if autostart is enabled.
mode.get()	Retrieves the current autostart mode as a string.
mode.set(mode: string)	Sets the autostart mode. You can check accepted values here .

AutostartMode

Mode	Description
shown	The app window is shown on startup.
minimized	The app starts minimized to the taskbar or dock.
hidden	The app starts without displaying any window.

Example

async function setupAutostart(mode) { // mode must be one of 'shown'|'minimized'|'hidden'
  const enabled = await Bubbledesk.autostart.isEnabled();
  if (!enabled) await Bubbledesk.autostart.enable();
  
  await Bubbledesk.autostart.mode.set(mode);
}

setupAutostart();

Notes

TIP

Always check the current autostart status with isEnabled() before attempting to enable or disable it to avoid unnecessary operations.

WARNING

Autostart behavior and support may vary across operating systems. For example, Windows, macOS, and Linux handle autostart differently, and some modes might not be fully supported on all platforms.