Multimedia processing graphs
Find a file
Wim Taymans 082463efd0 protocol: add v0 compatibility
For flatpaks we need to be able to support older v0 protocol clients.
To handle this we have:

- the connection detects an old client when it receives the first
  message. It can do this by checking the sequence number, on old
  versions it contains the message size and is never 0, on new
  clients the sequence number is 0.

- We add a new signal at the start of the connection with the detected
  version number. This installs the right version of the core proxy.
  We also move the binding of the client until the hello message is
  received. This way we can have a new client connect (portal),
  hand over the connection to an old client, which then removes the
  client binding again in the hello request with a v0 version.
  There are some changes to the passing of fds in v0 vs v3 which need
  to investigated some more.

- bump version of our interfaces to 3. This makes it possible to
  have v0 and v3 protocol marshal functions.

- Add version number in the proxy. This is mostly automatically done
  internally based on the version numbers the library is compiled
  with. Where the version number was in the API before, it is now
  actually used to look up the right protocol marshal functions. For
  Proxies there is usually just 1 version, the current one. It is the
  server that will support different versions.

- Add v0 compat marshal functions to convert from and to v0 format.
  This has some complications. v0 has a type map it keeps in sync
  with the server. For this we have a static type map with mappings
  to our own v3 types. Pods are mostly the same except for objects
  that used to have arbitrary pods in v0 vs spa_pod_prop in v3. Also
  convert between v0 spa_pod_prop and v3 spa_pod_choice.
  Formats and commands are also slightly different so handle those
  mappings as well.
  We only have marshal functions for the server side (resource)
  v0 functions.

- Add v0 compatible client-node again. It's a bit tricky to map, v0
  client-node basically lets the server to the mixing and teeing
  and just does the processing of the internal node.
2019-10-08 23:20:18 +02:00
doc update docs 2017-09-05 13:35:25 +02:00
man Relicense as MIT/X11 2018-11-05 17:48:52 +01:00
pipewire-alsa@dddaaf4db4 channelmix: implement per channel volume 2019-08-12 15:14:39 +02:00
pipewire-jack@0bc34d5301 flags: change flag macros 2019-10-02 18:00:42 +02:00
pipewire-pulseaudio@694ae6dd84 flags: change flag macros 2019-10-02 18:00:42 +02:00
po Update POTFILES.in 2017-09-19 17:42:12 +02:00
spa improve debug and error reporting 2019-10-08 22:33:31 +02:00
src protocol: add v0 compatibility 2019-10-08 23:20:18 +02:00
.editorconfig add .editorconfig files 2019-02-13 11:19:21 +01:00
.gitignore gitignore: Add vim files 2018-10-31 07:54:22 +00:00
.gitmodules update url 2018-10-28 10:34:08 +00:00
.travis.yml travis: disable vulkan option 2019-08-19 16:39:24 +02:00
_config.yml Set theme jekyll-theme-slate 2017-09-04 19:55:46 +02:00
autogen.sh autogen.sh: Immediately fail on command errors 2019-05-23 10:15:14 +02:00
check_missing_headers.sh travis: run make install and check for headers that have not been installed 2019-05-31 09:51:30 +02:00
config.h.meson add systemd socket activation 2018-10-18 12:36:10 +02:00
COPYING Relicense as MIT/X11 2018-11-05 17:48:52 +01:00
LICENSE Relicense as MIT/X11 2018-11-05 17:48:52 +01:00
Makefile.in Add PortConfig parameter 2019-08-06 12:45:20 +02:00
meson.build Improve some debug 2019-10-02 18:02:07 +02:00
meson_options.txt jack: add jack source and sink 2019-08-20 20:35:41 +02:00
NEWS Fix typo 2019-10-03 09:36:55 +02:00
PROTOCOL Initial commit 2015-04-16 16:58:33 +02:00
pw-uninstalled.sh uninstalled: update uninstalled 2018-10-10 18:04:28 +02:00
README Relicense as MIT/X11 2018-11-05 17:48:52 +01:00

PipeWire
--------

PipeWire is a server and user space API to deal with multimedia
pipelines. This includes:

  - Making available sources of video (such as from a capture devices or
       application provided streams) and multiplexing this with
       clients.
  - Accessing sources of video for consumption.
  - Generating graphs for audio and video processing.

Nodes in the graph can be implemented as separate processes,
communicating with sockets and exchanging multimedia content using fd
passing.

Building
--------

Pipewire uses the Meson and Ninja build system to compile. If you're not
familiar with these tools, the included "autogen.sh" script will
automatically run the correct meson/ninja commands, and output a Makefile.
It follows that there are two methods to build Pipewire, however both rely
on Meson and Ninja to actually perform the compilation:

$ ./autogen.sh
$ make

or the Meson/Ninja native method:

$ meson build
$ cd build
$ ninja

You can see the available meson options in meson_options.txt file.