OS Manuals

/usr/bin/fyi

Command-line client for desktop notifications over D-Bus, a drop-in alternative to notify-send

From fyi 1.0.4-r3 (enterprise-packages), captured 2026-11-08 by running fyi --help (exit 0). permalink

Usage: /usr/bin/fyi [OPTIONS…] TITLE [MESSAGE]
       /usr/bin/fyi --close=ID
       /usr/bin/fyi --server-info
       /usr/bin/fyi --server-capabilities

Options:
  -a,--app-name=NAME           app-name, typically used for the icon, unless
                               --icon is used
  -i,--icon=ICON               notification icon. Can be either a symbolic name,
                               or a file (default: none)
     --image-data=FILE         file content (must be raw RGBA pixel data) is sent
                               as a image-data hint
     --image-size=WIDTHxHEIGHT width and height, in pixels, of --image-data
  -u,--urgency=URGENCY         notification urgency; low, normal or critical
                               (default: normal)
  -c,--category=CATEGORY       notification category (default: none)
  -A,--action=NAME:LABEL       defines an action to display. Implies --wait. May
                               be set multiple times. The name of the
                               triggered action is output to stdout
  -H,--hint=TYPE:NAME:VALUE    specifies additional hints. Valid types are
                               boolean, byte, int, double and string
  -r,--replaces=ID             update an existing notification
  -t,--expire-time=TIME_MS     notification timeout, in milliseconds (default:
                               server defined)
     --transient               show a transient notification. Transient
                               notifications by-pass the server's persistence
                               capability, if any.
  -C,--close=ID                close an existing notification
  -p,--print-id                print the notification ID on stdout
  -R,--print-reason            print the reason the notification was closed
  -T,--print-token             print the activation token, if present
  -w,--wait                    wait for the notification to be closed before
                               exiting
     --server-info             display server name and version
     --server-capabilities     display server capabilities
  -v,--version                 show the version number and quit
Options (19)
OptionDescriptionSource
-a, --app-name NAMEapp-name, typically used for the icon, unlesshelp + man
-i, --icon ICONIcon to display, either as a symbolic icon name (e.g. firefox) or a filename.help + man
--image-data FILESets the image-data hint in the notification, with the raw pixel data from FILE.help + man
-u, --urgency URGENCYnotification urgency;help + man
-c, --category CATEGORYnotification category (default: none)help + man
-A, --action NAME:LABELDefines an action to display (e.g. as a button, or in a list, depending on notification daemon).help + man
-H, --hint TYPE:NAME:VALUEspecifies additional hints.help + man
-r, --replaces IDIf there is an existing notification with the specified ID, replace it.help + man
-t, --expire-time TIME_MSThe notification will be closed automatically after TIME milliseconds.help + man
--transientBy-pass the server's persistence capability, if any.help + man
-C, --close IDIf there is an existing notification with the specified ID, close it.help + man
-p, --print-idPrint the daemon assigned notification ID, in the format id=ID.help + man
-R, --print-reasonPrint the reason the notification was closed, in the format:help + man
-T, --print-tokenPrint the activation token, if any, in the format:help + man
-w, --waitWait for the notification to be closed before exiting.help + man
--server-infoDisplay notification daemon name and version.help + man
--server-capabilitiesDisplay notification daemon capabilities.help + man
-v, --versionShow the version number and quit.help + man
--image-size WIDTHxHEIGHTThe dimensions of the image loaded by --image-data. (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.