lsactivity(8)

NAME
lsactivity activity continuation companion - Query and control the lsuseractivityd daemon, part of the LaunchServices framework

SYNOPSIS
lsactivity [-] [-abcd] [-a path] [file] [file ...] arg0 arg2 ...

DESCRIPTION
lsactivity controls and helps with testing of the UserActivity feature and frameworks. The tool processes its arguments as command [ options... ] [ command [options...]]*

A list of commands that deal with user activity items, and descriptions of each:

create
    [-title t] [-payload key=value] [-payloadData hexEncodedPayloadData] [-payloadFile path] [-options key=value] [-bundleID bundleString] [-type suggestedActionType]

    Creates a new user activity

    -title t
        the title to give the activity

    -payload key=value
        Add the value item to the payload with the key key

    -payloadData hexData
        Uses NSKeyedUnarchiver to unarchive the given data

    -payloadFile path
        read the payload dictionary from path

    -options key=value
        Add the key,value pair to the options dictionary

    -type int
        Sets the activity type to the given LSSuggestedActionType, defaulting to LSSuggestedActionUserActivityType

    -url url
        Sets the webpageURL for the item to url

update
    activityID [-title t] [-payload key=value] [-payloadFile path] [-bundleID bundleString] [--]

    Updates the user activity with any given items

    -title t
        the title to give the activity

    -payload key=value
        Add the value item to the payload with the key key

    -payloadData hexData
        Uses NSKeyedUnarchiver to unarchive the given data

    -payloadFile path
        read the payload dictionary from path

    -url url
        Sets the webpageURL for the item to url
    activityID with the given new values.

delete activityID [activityID ...] [--]
    Deletes each individual activity given as activityID

    If activityID is all then deletes all activities.

list
    lists the user activity items

export activityID [activityID ...] [--]
    Exports each activity given by an activityID

Commands which track, control, and affect the ranking of activities which the user could choose to resume on this device include:

rank
    [-all] [-watch] [-open] [-show] [-remove]

    -all
        List all best apps, not just the top-ranked one.

    -watch
        Display the live changes to the best application as they happen. Control-c to exit.

    -open
        Attempt to open (as if selected by the user) each received item

    -show
        Fetch the activity from the remote device and display the information, including the payload

    -remove
        Remove the item from future consideration as a bestAppSuggestion until the item itself changes.

reflect [-duration duration]

    -duration duration
        The duration, in seconds, to reflect activities.

    Make whatever the most recently updated user activity is be 'reflected' back to this device, as if it was received from anther device with exactly the identifier and payload as given. This is helpful when testing, because you can run this in a shell, and then resume the activity from lock screen or notification center, and it should send that activity back to the same application to see that it receives an activity correctly.

    Anywhere activityID is shown, it can be any of a full UUID, the prefix or suffix part of a UUID, or the title for an activity.

ADMINISTRATIVE CONTROL COMMANDS
Commands that control the lsuseractivityd daemon.

status
    [-watch] [-interval duration]

    -watch
        Run in full-screen mode, showing status every second

    -interval duration Update every duration seconds

    Get the current status of many aspects of the daemon.

    terminate
        Ask the daemon to terminate itself.

        reload
            Reload the daemon from its launchd plist (effectively killing the daemon) Mac OS X only.

            restart
                Ase the daemon to restart.

BLUETOOTH ADVERTISING CONTROL
Commands that directly change what this machine is advertising or display what is being received via the BTLE subsystem.

advertiseBTLE [-identifier bundleidentifier] [-payload key=value] [-payloadFile path] [-options key=value] [-url url]

    -identifier bundleidentifier
        Advertise the given bundle identifier

    -payload key=value
        Add the key,value pair to the payload dictionary

    -payloadFile path
        Read an entire payload from the file at path

    -options key=value
        Add the key,value pair to the options dictionary

    -url url
        Add url to the set of resourceURLs in the payload being advertised

    Change the current BTLE advertisement to be the given bundleID, with the given payload. If no payload is specified then small random payload will be created so that the advertisement differs from any previous one.

listenBTLE

    Listen for BTLE advertisements from other machines, and log a line each time a new item is seen.

MISCELLANEOUS
Miscellaneous commands for different things.

showpayload hex-string
    Decode the hex string as the data format the daemon stores each payload item and print out the resulting object(s).

    showbtlepayload hex-string
        Decode the hex string as the data format a user activity item is encoded into when it is sent via BTLE between two devices.

        idle [-duration secondsToRun] [-statusInterval secondsBetweenStatus]
            Run for up to secondsToRun seconds, printing the idle state of the system every file ... secondsBetweenStatus seconds. Also print the status whenever the kIOUserActivityNotifyName notify() fires.

SEE ALSO
lsuseractivityd(8)