xref: /freebsd/usr.sbin/virtual_oss/virtual_bt_speaker/virtual_bt_speaker.8 (revision 9cab9fde5edad9b409dd2317a2aec7815e6d6bed)
1*9cab9fdeSChristos Margiolis.\"
2*9cab9fdeSChristos Margiolis.\" Copyright (c) 2019 Google LLC, written by Richard Kralovic <riso@google.com>
3*9cab9fdeSChristos Margiolis.\"
4*9cab9fdeSChristos Margiolis.\" All rights reserved.
5*9cab9fdeSChristos Margiolis.\"
6*9cab9fdeSChristos Margiolis.\" Redistribution and use in source and binary forms, with or without
7*9cab9fdeSChristos Margiolis.\" modification, are permitted provided that the following conditions
8*9cab9fdeSChristos Margiolis.\" are met:
9*9cab9fdeSChristos Margiolis.\" 1. Redistributions of source code must retain the above copyright
10*9cab9fdeSChristos Margiolis.\"    notice, this list of conditions and the following disclaimer.
11*9cab9fdeSChristos Margiolis.\" 2. Redistributions in binary form must reproduce the above copyright
12*9cab9fdeSChristos Margiolis.\"    notice, this list of conditions and the following disclaimer in the
13*9cab9fdeSChristos Margiolis.\"    documentation and/or other materials provided with the distribution.
14*9cab9fdeSChristos Margiolis.\"
15*9cab9fdeSChristos Margiolis.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16*9cab9fdeSChristos Margiolis.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17*9cab9fdeSChristos Margiolis.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18*9cab9fdeSChristos Margiolis.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19*9cab9fdeSChristos Margiolis.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20*9cab9fdeSChristos Margiolis.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21*9cab9fdeSChristos Margiolis.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22*9cab9fdeSChristos Margiolis.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23*9cab9fdeSChristos Margiolis.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24*9cab9fdeSChristos Margiolis.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25*9cab9fdeSChristos Margiolis.\" SUCH DAMAGE.
26*9cab9fdeSChristos Margiolis.\"
27*9cab9fdeSChristos Margiolis.\"
28*9cab9fdeSChristos Margiolis.Dd February 12, 2025
29*9cab9fdeSChristos Margiolis.Dt VIRTUAL_BT_SPEAKER 8
30*9cab9fdeSChristos Margiolis.Os
31*9cab9fdeSChristos Margiolis.Sh NAME
32*9cab9fdeSChristos Margiolis.Nm virtual_bt_speaker
33*9cab9fdeSChristos Margiolis.Nd virtual bluetooth speaker
34*9cab9fdeSChristos Margiolis.Sh SYNOPSIS
35*9cab9fdeSChristos Margiolis.Nm
36*9cab9fdeSChristos Margiolis.Op Fl h
37*9cab9fdeSChristos Margiolis.Sh DESCRIPTION
38*9cab9fdeSChristos Margiolis.Nm
39*9cab9fdeSChristos Margiolisprovides bluetooth speaker functionality.
40*9cab9fdeSChristos MargiolisIt receives connections from bluetooth devices that stream music, and
41*9cab9fdeSChristos Margiolisforwards the received stream to the given OSS device.
42*9cab9fdeSChristos MargiolisThis utility depends on
43*9cab9fdeSChristos Margiolis.Xr sdpd 8
44*9cab9fdeSChristos Margiolisrunning in the background.
45*9cab9fdeSChristos Margiolis.Pp
46*9cab9fdeSChristos MargiolisThe following options are available:
47*9cab9fdeSChristos Margiolis.Bl -tag -width indent
48*9cab9fdeSChristos Margiolis.It Fl B
49*9cab9fdeSChristos MargiolisRun program in background.
50*9cab9fdeSChristos Margiolis.It Fl d Ar devname
51*9cab9fdeSChristos MargiolisOSS device to play the received streams.
52*9cab9fdeSChristos Margiolis.It Fl p Ar socketpath
53*9cab9fdeSChristos MargiolisPath to SDP control socket.
54*9cab9fdeSChristos MargiolisDefault is to use default location.
55*9cab9fdeSChristos Margiolis.It Fl i Ar priority
56*9cab9fdeSChristos MargiolisSet real-time priority.
57*9cab9fdeSChristos Margiolis.It Fl h
58*9cab9fdeSChristos MargiolisShow usage.
59*9cab9fdeSChristos Margiolis.El
60*9cab9fdeSChristos Margiolis.Sh EXAMPLES
61*9cab9fdeSChristos Margiolis.Bd -literal -offset indent
62*9cab9fdeSChristos Margiolisvirtual_bt_speaker -d /dev/dspX
63*9cab9fdeSChristos Margiolis.Ed
64*9cab9fdeSChristos Margiolis.Sh SEE ALSO
65*9cab9fdeSChristos Margiolis.Xr sdpd 8
66*9cab9fdeSChristos Margiolisand
67*9cab9fdeSChristos Margiolis.Xr virtual_oss 8
68*9cab9fdeSChristos Margiolis.Sh AUTHORS
69*9cab9fdeSChristos Margiolis.Nm
70*9cab9fdeSChristos Margioliswas written by
71*9cab9fdeSChristos Margiolis.An Richard Kralovic riso@google.com .
72