tauri-plugin-taskbar

Windows taskbar thumbnail toolbar controls for Tauri applications.

| Platform | Supported | | --- | --- | | Windows | ✓ full | | Linux | ~ no-op fallback | | macOS | ~ no-op fallback | | Android | ~ no-op fallback | | iOS | ~ no-op fallback |

Install

This plugin targets Tauri v2 and Rust 1.77.2+.

Add the Rust crate to your src-tauri/Cargo.toml:

[dependencies]
tauri-plugin-taskbar = "0.1.0"

Add the JS bindings package:

pnpm add tauri-plugin-taskbar
# or npm add tauri-plugin-taskbar
# or yarn add tauri-plugin-taskbar

Rust setup

Register the plugin in your Tauri builder:

fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_taskbar::init())
        .run(tauri::generate_context!())
        .expect("error while running tauri app");
}

Configuration

Configure the plugin in tauri.conf.json under plugins.taskbar:

{
  "plugins": {
    "taskbar": {
      "autoAttach": true,
      "windowLabel": "main",
      "events": {
        "previous": "media-prev",
        "toggle": "media-toggle",
        "next": "media-next"
      },
      "tooltips": {
        "previous": "Previous",
        "play": "Play",
        "pause": "Pause",
        "next": "Next"
      },
      "icons": {
        "previous": "icons/taskbar/PREV_THUMB.ico",
        "previousDisabled": "icons/taskbar/PREV_THUMB_DISABLED.ico",
        "play": "icons/taskbar/PLAY_THUMB.ico",
        "pause": "icons/taskbar/PAUSE_THUMB.ico",
        "next": "icons/taskbar/NEXT_THUMB.ico",
        "nextDisabled": "icons/taskbar/NEXT_THUMB_DISABLED.ico"
      }
    }
  }
}

JavaScript usage

import {
  initialize,
  isSupported,
  setNavigationEnabled,
  setPlaybackState
} from 'tauri-plugin-taskbar'

if (await isSupported()) {
  await initialize()
  await setPlaybackState(true)
  await setNavigationEnabled(true, true)
}

Emitted events

When taskbar buttons are clicked, this plugin emits app events:

• events.previous (default: media-prev)
• events.toggle (default: media-toggle)
• events.next (default: media-next)

Production notes

• This plugin does not set App User Model ID (AUMID). Keep AUMID setup in your app entrypoint.
• Ensure configured icon files are included as Tauri bundle resources.
• Non-Windows platforms intentionally succeed with no-op behavior for cross-platform safety.