powerballoondeprecated

Windows balloon notification using PowerShell.

Usage no npm install needed!

<script type="module">
  import powerballoon from 'https://cdn.skypack.dev/powerballoon';
</script>

README

About

Windows balloon notification using PowerShell.
Doesn't use any native module. Everything is done through PowerShell.

Looking for Windows toast notification ? node-powertoast

Example

Windows 7 Windows 10
//Sending a simple balloon notification
const balloon = require('powerballoon');

balloon({
  title: "NPM",
  message: "Installed.",
  ico: "C:\\Program Files\\nodejs\\node.exe"
}).catch((err) => { 
  console.error(err);
});

Installation

npm install powerballoon

Options

  • title

    The title of your notification

  • message

    The content message of your notification. This can not be empty !
    Thus default to "Hello World !"

  • ico

    Path to the icon shown in the systray.
    Path can target either an .ico file or an .exe.
    default to the PowerShell executable icon.

  • type

    • 0 : Info
    • 1 : Warning
    • 2 : Error

    default to 'Info'

  • showTime

    balloon duration in ms.
    default to 7000.

    ⚠️ Please note that Windows can dismiss the pop-up before the timeout expires.

Common Issues

  • Windows balloon are disabled

    There is a registry setting that controls whether a balloons can be show or not.
    HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\Advanced
    DWORD::EnableBalloonTips

  • Powershell is not recognized as an internal or external command [...]

    Powershell needs to be installed.
    Windows 7/Server 2008 R2 are the first Windows versions to come with PowerShell installed.