Skip to content

The Windows Notification CLI is a small project that enables users to conveniently set a reminder that will pop up as an alarm in Windows 10.

Notifications You must be signed in to change notification settings

ehtesham-ali/Windows-Notification-CLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

Introduction

The Windows Notification CLI is a small project that enables users to conveniently set a reminder that will pop up as an alarm in Windows 10 (not tested on 11). This runs in the terminal, meaning you don’t need to have a browser tab open to keep track of time or to have another application open; a simple PowerShell instance will suffice! Features include:

  • A simple way to set reminders on Windows 10 machines using 3 arguments: title, body, and time (minutes)
  • The reminder will continue to beep until you manually close it to ensure you don’t sleep through it!

How to Use Windows Notification CLI

Using this CLI is super simple:

First, you need to find the AppUserModelId of the version of Python you have on your computer. This is usually not an actual Microsoft-provided ID, but rather a file location to the Python executable. To find the executable, open PowerShell and enter in get-StartApps | Where-Object {$_.Name -like '*Python*'} and hit enter. You should see some options that look like this:

Name                            AppID
----                            -----
Python 3.9 (64-bit)             C:\Users\ehtes\AppData\Local\Programs\Python\Python39\python.exe
Python 3.9 Manuals (64-bit)     Microsoft.AutoGenerated.{5FDD71EB-3CD4-19FC-A1BF-C6B31FAC6271}
Python 3.9 Module Docs (64-bit) Microsoft.AutoGenerated.{8FC0AE35-E127-6B47-021F-13C9B008E9B5}
IDLE (Python 3.9 64-bit)        Microsoft.AutoGenerated.{B84D4DE7-D9C7-2178-BE8C-08BCAD140254}

You want to copy the AppID of Python 3.X (XX-bit) and copy it into the argument in line 43 before running ANY reminders.

Whenever you want to set a reminder, first point the terminal to the source of the python file, then in the first argument pass in the title (substitute spaces with underscores, the interpreter will change them back), the second argument should be the body of the reminder, and the last argument is a number that tells the program to show the reminder after X minutes.

💡 If you still get an error or you don’t see a Toast/Notification showing in the action centre, try adding double slashes in the argument of line 43 in the file, sometimes that solves the problem!

Dependencies

  • winrt (pip install winrt)

Future Updates

In the near-future I will add a Pomodoro technique timer to the CLI to make it easier for students to cram for exams :)


Notion | Website

About

The Windows Notification CLI is a small project that enables users to conveniently set a reminder that will pop up as an alarm in Windows 10.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages