Module keys

Source
Expand description

A collection of keys that are used to add extra information on objects.

use pipewire::properties::properties;

let props = properties! {
  *pipewire::keys::REMOTE_NAME => "pipewire-0"
};

Statics§

ACCESS
how the client access is controlled
APP_ICON
aa base64 blob with PNG image data
APP_ICON_NAME
an XDG icon name for the application. Ex: “totem”
APP_ID
a textual id for identifying an application logically. Ex: “org.gnome.Totem”
APP_LANGUAGE
application language if applicable, in standard POSIX format. Ex: “en_GB”
APP_NAME
application name. Ex: “Totem Music Player”
APP_PROCESS_BINARY
binary name
APP_PROCESS_HOST
host name
APP_PROCESS_ID
process id (pid)
APP_PROCESS_MACHINE_ID
the D-Bus host id the application runs on
APP_PROCESS_SESSION_ID
login session of the application, on Unix the value of $XDG_SESSION_ID.
APP_PROCESS_USER
user name
APP_VERSION
application version. Ex: “1.2.0”
AUDIO_CHANNEL
an audio channel. Ex: “FL”
AUDIO_CHANNELS
number of audio channels
AUDIO_FORMAT
an audio format. Ex: “S16LE”
CLIENT_ACCESS
how the client wants to be access controlled Must be obtained from trusted sources by the protocol and placed as read-only properties.
CLIENT_API
the client api used to access PipeWire
CLIENT_ID
a client id
CLIENT_NAME
the client name
CONFIG_NAME
a config file name
CONFIG_PREFIX
a config prefix directory
CONTEXT_PROFILE_MODULES
a context profile for modules, deprecated
CORE_DAEMON
If the core is listening for connections.
CORE_ID
the core id
CORE_MONITORS
the apis monitored by core.
CORE_NAME
The name of the core. Default is pipewire-<username>-<pid>, overwritten by env(PIPEWIRE_CORE)
CORE_VERSION
The version of the core.
CPU_CORES
number of cores
CPU_MAX_ALIGN
maximum alignment needed to support all CPU optimizations
DEVICE_API
API this device is accessed with. Ex. “alsa”, “v4l2”
DEVICE_BUS
bus of the device if applicable. One of “isa”, “pci”, “usb”, “firewire”, “bluetooth”
DEVICE_BUS_PATH
bus path to the device in the OS’ format. Ex. “pci-0000:00:14.0-usb-0:3.2:1.0”
DEVICE_CACHE_PARAMS
cache the device spa params
DEVICE_CLASS
device class
DEVICE_DESCRIPTION
localized human readable device one-line description. Ex. “Foobar USB Headset”
DEVICE_FORM_FACTOR
form factor if applicable. One of “internal”, “speaker”, “handset”, “tv”, “webcam”, “microphone”, “headset”, “headphone”, “hands-free”, “car”, “hifi”, “computer”, “portable”
DEVICE_ICON
icon for the device. A base64 blob containing PNG image data
DEVICE_ICON_NAME
an XDG icon name for the device. Ex. “sound-card-speakers-usb”
DEVICE_ID
device id
DEVICE_INTENDED_ROLES
intended use. A space separated list of roles (see PW_KEY_MEDIA_ROLE) this device is particularly well suited for, due to latency, quality or form factor.
DEVICE_NAME
device name
DEVICE_NICK
a short device nickname
DEVICE_PLUGGED
when the device was created. As a uint64 in nanoseconds.
DEVICE_PRODUCT_ID
product ID if applicable
DEVICE_PRODUCT_NAME
product name if applicable
DEVICE_SERIAL
Serial number if applicable
DEVICE_STRING
device string in the underlying layer’s format. Ex. “surround51:0”
DEVICE_SUBSYSTEM
device subsystem
DEVICE_VENDOR_ID
vendor ID if applicable
DEVICE_VENDOR_NAME
vendor name if applicable
FACTORY_ID
the factory id
FACTORY_NAME
the name of the factory
FACTORY_TYPE_NAME
the name of the type created by a factory
FACTORY_TYPE_VERSION
the version of the type created by a factory
FACTORY_USAGE
the usage of the factory
FORMAT_DSP
a dsp format. Ex: “32 bit float mono audio”
HOST_NAME
The host name of the machine
LIBRARY_NAME_DBUS
name of the dbus library to use
LIBRARY_NAME_LOOP
name of the loop library to use
LIBRARY_NAME_SYSTEM
name of the system library to use
LINK_FEEDBACK
indicate that a link is a feedback link and the target will receive data in the next cycle
LINK_ID
a link id
LINK_INPUT_NODE
input node id of a link
LINK_INPUT_PORT
input port id of a link
LINK_OUTPUT_NODE
output node id of a link
LINK_OUTPUT_PORT
output port id of a link
LINK_PASSIVE
indicate that a link is passive and does not cause the graph to be runnable.
MEDIA_ARTIST
artist. Ex: “Pink Floyd”
MEDIA_CATEGORY
Media Category: Playback, Capture, Duplex, Monitor, Manager
MEDIA_CLASS
class Ex: “Video/Source”
MEDIA_COMMENT
extra comment
MEDIA_COPYRIGHT
copyright string
MEDIA_DATE
date of the media
MEDIA_FILENAME
filename
MEDIA_FORMAT
format of the media
MEDIA_ICON
icon for the media, a base64 blob with PNG image data
MEDIA_ICON_NAME
an XDG icon name for the media. Ex: “audio-x-mp3”
MEDIA_LANGUAGE
language in POSIX format. Ex: en_GB
MEDIA_NAME
media name. Ex: “Pink Floyd: Time”
MEDIA_ROLE
Role: Movie, Music, Camera, Screen, Communication, Game, Notification, DSP, Production, Accessibility, Test
MEDIA_SOFTWARE
generator software
MEDIA_TITLE
title. Ex: “Time”
MEDIA_TYPE
Media type, one of Audio, Video, Midi
MODULE_AUTHOR
the author’s name
MODULE_DESCRIPTION
a human readable one-line description of the module’s purpose.
MODULE_ID
the module id
MODULE_NAME
the name of the module
MODULE_USAGE
a human readable usage description of the module’s arguments.
MODULE_VERSION
a version string for the module.
NODE_ALWAYS_PROCESS
process even when unlinked
NODE_AUTOCONNECT
node wants to be automatically connected to a compatible node
NODE_CACHE_PARAMS
cache the node params
NODE_DESCRIPTION
localized human readable node one-line description. Ex. “Foobar USB Headset”
NODE_DONT_RECONNECT
don’t reconnect this node. The node is initially linked to target.object or the default node. If the target is removed, the node is destroyed
NODE_DRIVER
node can drive the graph
NODE_EXCLUSIVE
node wants exclusive access to resources
NODE_GROUP
the group id this node is part of. Nodes in the same group are always scheduled with the same driver.
NODE_ID
node id
NODE_LATENCY
the requested latency of the node as a fraction. Ex: 128/48000
NODE_MAX_LATENCY
the maximum supported latency of the node as a fraction. Ex: 1024/48000
NODE_NAME
node name
NODE_NICK
short node name
NODE_PASSIVE
indicate that a node wants passive links on output/input/all ports when the value is “out”/“in”/“true” respectively
NODE_PAUSE_ON_IDLE
pause the node when idle
NODE_PLUGGED
when the node was created. As a uint64 in nanoseconds.
NODE_SESSION
the session id this node is part of
NODE_STREAM
node is a stream, the server side should add a converter
NODE_VIRTUAL
the node is some sort of virtual object
OBJECT_ID
a global object id
OBJECT_LINGER
the object lives on even after the client that created it has been destroyed
OBJECT_PATH
unique path to construct the object
PORT_ALIAS
port alias
PORT_CACHE_PARAMS
cache the node port params
PORT_CONTROL
if this port is a control port
PORT_DIRECTION
the port direction, one of “in” or “out” or “control” and “notify” for control ports
PORT_EXTRA
api specific extra port info, API name should be prefixed. “jack:flags:56”
PORT_ID
port id
PORT_MONITOR
if this port is a monitor port
PORT_NAME
port name
PORT_PHYSICAL
if this is a physical port
PORT_TERMINAL
if this port consumes the data
PRIORITY_DRIVER
priority to be a driver
PRIORITY_SESSION
priority in session manager
PROTOCOL
protocol used for connection
REMOTE_INTENTION
The intention of the remote connection, “generic”, “screencast”
REMOTE_NAME
The name of the remote to connect to, default pipewire-0, overwritten by env(PIPEWIRE_REMOTE)
SEC_GID
client gid, set by protocol
SEC_LABEL
client security label, set by protocol
SEC_PID
Client pid, set by protocol
SEC_UID
Client uid, set by protocol
STREAM_CAPTURE_SINK
Try to capture the sink output instead of source output
STREAM_DONT_REMIX
don’t remix channels
STREAM_IS_LIVE
Indicates that the stream is live.
STREAM_LATENCY_MAX
The maximum latency of the stream
STREAM_LATENCY_MIN
The minimum latency of the stream.
STREAM_MONITOR
Indicates that the stream is monitoring and might select a less accurate but faster conversion algorithm.
USER_NAME
The user name that runs pipewire
VIDEO_FORMAT
a video format
VIDEO_RATE
a video framerate
VIDEO_SIZE
a video size as “<width>x<height>”
WINDOW_X11_DISPLAY
the X11 display string. Ex. “:0.0”