aboutsummaryrefslogtreecommitdiff

NAME

parte simple notification displayer

SYNOPSIS

parte [options] [text ...]

DESCRIPTION

parte is a simple notification displayer that accepts input from standard input or command-line arguments.
It is highly configurable through its arguments and compile-time options. Right-clicking the notification may trigger an action.

EXAMPLE WITHOUT OPTIONS

    parte "Hello" "This is another line"
    echo "Hello\nThis is another line" | parte
    echo "Hello" | parte "This is another line"
    parte "right clic for echo" && echo "hello world!!"

parte return 1 in normal circunstances, 2 in errors and 0 when is closed with a right clic, so yo can make a script work only if you decide to (like above).

EXIT STATUS

parte returns:

Code Meaning
0 Closed via right-click
1 Normal termination
2 Error occurred

OPTIONS

Flag Argument Description
-h, -?, --help Show help and exit.
-u mode Set notification mode: low, normal, urgent (default: normal). Overrides prior style flags.
-t seconds Display duration in seconds.
-border-size pixels Border size in pixels.
-fg "#RRGGBB" Foreground (font) color.
-bg "#RRGGBB" Background color.
-border-color "#RRGGBB" Border color.
-font pattern Fontconfig pattern for the font.
-focus-keyboard Show notification on monitor with keyboard focus.
-focus-mouse Show notification on monitor under mouse cursor.
-top-left Place notification in top-left corner.
-top-right Place notification in top-right corner.
-bottom-left Place notification in bottom-left corner.
-bottom-right Place notification in bottom-right corner.

EXAMPLE WITH OPTIONS

    parte -fg "#FFFFFF" -bg "#000000" "Hello" "This is another line"
    echo "Hello\nThis is another line very urgent" | parte -u "urgent"
    echo "Hello" | parte -u "low" -t 3 "This is another line"

INSTALATION

make config.h
make install clean

use sudo if your user needs it.

make uninstall

This will uninstall it.

LICENCE

Copyright (c) Juan de la Puente Valbuena softwaredelapuente@gmail.com Licensed under the EUPL-1.2 see more details in LICENSE