Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit

v1.0.0 is going to rock the boat a little.
Need to make it as obvious as possible not to blindly update.

Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Codacy Badge codecov Build Status PowerShell Gallery Version PowerShell Gallery Downloads Open Issues

BurntToast Logo Banner

PowerShell Module for displaying Windows 10 and Windows Server 2019 Toast Notifications


BurntToast v1.0.0 will include numerous breaking changes and your existing scripts will not work without changes.

DO NOT upgrade to BurntToast v1.0.0 until you are ready.

You can read more about the up coming changes on and BurntToast's new Docs Site


PowerShell Gallery Install (Requires PowerShell v5)

Install-Module -Name BurntToast

See the PowerShell Gallery for the complete details and instructions. Don't forget to set the correct Execution Policy.

Manual Install

Download from Releases page and extract the contents into $env:userprofile\Documents\WindowsPowerShell\modules\BurntToast (you may have to create these directories if they don't exist.)

If you are using PowerShell 6 or later, extract into $env:userprofile\Documents\PowerShell\Modules\BurntToast

Please remember to "unblock" the zip file before extracting the contents. Not doing so will result in the module not working correctly. This can be done via the file properties or with Unblock-File.


Default Toast


BurntToast Notification Example Default

Customized Toast

New-BurntToastNotification -AppLogo C:\smile.jpg -Text "Don't forget to smile!",
                                                       'Your script ran successfully, celebrate!'

BurntToast Notification Example Custom

Alarm Clock

New-BurntToastNotification -Text 'WAKE UP!' -Sound 'Alarm2' -SnoozeAndDismiss

BurntToast Notification Example Alarm


Please note: as of v0.5.0, BurntToast no longer works on Windows 8.

  • 0.8.5

    • Actually implement the ability to use a UniqueIdentifier with the Remove-BTNotification function (which was half implemented in 0.8.4)
  • 0.8.4

    • Enhancement: Header ID on New-BTHeader is now optional. An ID will be auto generated if not specified (#125)

    • Enhancement: Hero images can now be specified using the New-BurntToastNotification function using the -HeroImage parameter (#80)

    • Enhancement: AppIDs can now be specified using the New-BurntToastNotification function using the -AppId parameter.

    • Enhancement: You can now specify a UniqueIdentifier when using the Remove-BTNotification function rather than component Tag and Group strings.

    • Fix: Weird edge cases when taking text from Twitch/IRC and using them in a toast is now sorted.

  • 0.8.3

    • Fix: Error when running Update-BTNotification on PowerShell 6.0+ (#120)

    • Fix: Error when using actionable toast parameters on any version (#122)

    • Fix: Multiple warnings about events not being supported when specifying multiple event types.

  • v0.8.2

    • Add: AdaptiveGroups are now usable via New-BTColumn
  • v0.8.1

    • Fix: Toast alias removed in 0.8.0 has been restored

    • Deprecation: Signalling removal of Shoulder Tap cmdlets in future version, v0.9.0

    • Deprecation: Signalling removal of Path parameter from New-BTAudio in future version, v0.9.0.

  • v0.8.0

    • Fix: Images from UNC path failing (#111)

    • Add: Ability to force a refresh of cached images via IgnoreCache switch on New-BTImage

    • Add: ACTIONABLE NOTIFICATIONS! Exposed via ActivatedAction and DismissedAction parameters on Submit-BTNotification and New-BurntToastNotification

  • v0.7.2

    • Fix: Curly Braces when "Reminder" pops up (#72)

    • Fix: Caching remote gifs are saved based on their remote filename and not overwritten (#105)

    • Fix: BurntToast and .NET 5 (#101)

  • see more in the Full Change Log



Image Credit

The default image for BurntToast Notifications is a photo taken by Craig Sunter