Glances allow you to push small pieces of data to a frequently-updated screen such as a smartwatch or a lock screen. At least one of the title, text, subtext, count, or percent arguments must be specified.

update_glance(
  title = NULL,
  text = NULL,
  subtext = NULL,
  count = NULL,
  percent = NULL,
  user = get_pushover_user(),
  app = get_pushover_app(),
  device = NULL
)

Arguments

title

(optional) a description of the data being shown, such as "Widgets Sold" (max. 100 characters)

text

(optional) the main line of data, used on most screens (max. 100 characters)

subtext

(optional) a second line of data (max. 100 characters)

count

(optional) integer value shown on smaller screens; useful for simple counts

percent

(optional) integer percent value (0..100) shown on some screens as a progress bar/circle

user

user/group key (see set_pushover_user())

app

application token (see set_pushover_app())

device

(optional) name of the device(s) to send message to. Defaults to all devices.

Value

an invisible list containing the following fields:

  • status: request status (1 = success)

  • request: unique request ID

  • raw: the raw httr::response object

  • errors: a list of error messages (only for unsuccessful requests)

Note

Glances are currently in beta, and features may change.

Examples

if (FALSE) {
update_glance(count = 37)
}