NotifyUI 0.0.3

Python Notification library integrated with PyQt6

This work is licensed under a Creative Commons Attribution 4.0 International License.

NotifyUI

A python lib to help make easy and crazy notifications.

Example

from NotifyUI import NotifyElements

app=NotifyElements.NotifyApplication()
NotifyText(app.window,10,10,"Notify Elements",font=QtGui.QFont("Segoe UI",10,QtGui.QFont.Weight.Normal))
NotifyText(app.window,10,40,"Hello world!",font=QtGui.QFont("Segoe UI",13,QtGui.QFont.Weight.Bold))
NotifyText(app.window,10,70,"Extra text",font=QtGui.QFont("Segoe UI",10,QtGui.QFont.Weight.Normal),color="#a5a5a5")
app.window.setCloseClick(True)
app.send_notification()

Or to simply send a windows 10 inspired notification

from NotifyUI import NotifyElements

NotifyElements.sendWinStyleNotify("Notify Elements","Hello World","This is a test message.")

Default functions

---

sendWinStyleNotify(app_name,title,msg,fadeTime):

• Sends a windows 10 inspired style notification.
  app_name: the name of the application.
  title: the title of the notification.
  msg: the message of the notification.
  fadeTime: the fade time of the notificaion. (Must be a QTime object)
  e.g. "Notify Elements","Hello World","This is a test message."
  
• Note: This function is a thread. So it won't block the main thread.

Methods of classes

NotifyApplication

---

send_notification():

• This sends the notification which you have created so far.

NotifyWindow

---

setWindowTopLeft():

• Set the window to the top left of the screen.

setWindowTopRight():

• Set the window to the top right of the screen.

setWindowBottomLeft():

• Set the window to the bottom left of the screen.

setWindowBottomRight():

• Set the window to the BottomRight of the screen.

setBackgroundColor(color):

• Set the background color of the window.
  color: the color in string format.
  e.g. red or #ff0000 or rgb(255,0,0) or rgba(255,0,0,0.5)

appendStyle(property,value):

• Append a style to the style sheet.
  property: the property of the style.
  e.g. background-color or border-radius value: the value of the property.
  e.g. red or 10px or rgba(255,0,0,0.5)

addTextElement(x,y,text,font,color):

• x: x position of the text element inside the window
  y: y position of the text element inside the window
  text: string to be displayed
  font: style of the font (Must be QFont object)
  color: input hex color or rgb() for the color of text
  
• Note: the font and color input are optional as they do have a default value

setCloseClick(value):

• If true, the notification would close when left clicked.
• Default:- false

setPadding(value):

• Set the padding of the window.
  value: the padding in pixels.
  e.g. 10 or 20 or 30.
  
• Default: 10

setFadeAwayTime(value):

• Set the fade away time of the window.
  fadeTime: the fade away time in milliseconds.
  e.g. 1000 or 2000 or 3000.
  
• Default:- 500

setFadeAtClick(value):

• Toggle if the window should fade away when left clicked.
  value: True or False.
• Default: True

autoFade(fade_time):

• Automatically fade away after the specified time.
  fade_time: the fade time. (Must be a QTime object)

NotifyText

---

setBackgroundColor(color):

• Set the background color of the window.
  color: the color in string format.
  e.g. "red" or "#ff0000" or "rgb(255,0,0)" or "rgba(255,0,0,0.5)"

appendStyle(property,value):

• Append a style to the style sheet.
  property: the property of the style.
  e.g. "background-color" or "border-radius"
  value: the value of the property.
  e.g. "red" or "10px" or "rgba(255,0,0,0.5)"

setFadeAtClick(value):

• Toggle if the element should fade away when left clicked. value: True or False.
• Default: True

setFadeAwayTime(value):

• Set the fade away time of the window.
  fadeTime: the fade away time in milliseconds.
  e.g. 1000 or 2000 or 3000.
  
• Default:- 500

NotifyTimer

---

__init__(call_at_end,end_qtime,*args,**kwargs):

• This class runs the function passed after the specified time.
  call_at_end: the function to be called after the specified time.
  end_qtime: the time after which the function is called. (Should be a QTime object)
  args: the arguments to be passed to the function.
  kargs: the keyword arguments to be passed to the function.
  

• Note:- Declare this as a variable to keep the timer alive.