Skip to content

chetan0402/NotifyUI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Creative Commons License
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.