1 3baa2617 2022-02-16 op .\" Copyright (c) 2022 Omar Polo <op@openbsd.org>
 2 3baa2617 2022-02-16 op .\"
 3 3baa2617 2022-02-16 op .\" Permission to use, copy, modify, and distribute this software for any
 4 3baa2617 2022-02-16 op .\" purpose with or without fee is hereby granted, provided that the above
 5 3baa2617 2022-02-16 op .\" copyright notice and this permission notice appear in all copies.
 6 3baa2617 2022-02-16 op .\"
 7 3baa2617 2022-02-16 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 8 3baa2617 2022-02-16 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 9 3baa2617 2022-02-16 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 3baa2617 2022-02-16 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 3baa2617 2022-02-16 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 3baa2617 2022-02-16 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 3baa2617 2022-02-16 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 3baa2617 2022-02-16 op .\"
15 3baa2617 2022-02-16 op .Dd February 16 2022
16 3baa2617 2022-02-16 op .Dt AMUSED 1
17 3baa2617 2022-02-16 op .Os
18 3baa2617 2022-02-16 op .Sh NAME
19 3baa2617 2022-02-16 op .Nm amused
20 3baa2617 2022-02-16 op .Nd music player
21 3baa2617 2022-02-16 op .Sh SYNOPSIS
22 3baa2617 2022-02-16 op .Nm
23 3baa2617 2022-02-16 op .Op Fl dv
24 3baa2617 2022-02-16 op .Op Fl s Ar socket
25 3baa2617 2022-02-16 op .Ar command
26 3baa2617 2022-02-16 op .Op Ar argument ...
27 3baa2617 2022-02-16 op .Sh DESCRIPTION
28 3baa2617 2022-02-16 op .Nm
29 3baa2617 2022-02-16 op is a music player daemon and command-line utility.
30 3baa2617 2022-02-16 op .Pp
31 3baa2617 2022-02-16 op If called without any sub-
32 3baa2617 2022-02-16 op .Ar command
33 3baa2617 2022-02-16 op it forks in the background and starts the daemon.
34 3baa2617 2022-02-16 op Once the daemon is running, music files can be enqueued and the reproduction
35 3baa2617 2022-02-16 op controlled.
36 3baa2617 2022-02-16 op .Pp
37 3baa2617 2022-02-16 op The following options are available:
38 3baa2617 2022-02-16 op .Bl -tag -width 12m
39 3baa2617 2022-02-16 op .It Fl d
40 3baa2617 2022-02-16 op Do not daemonize.
41 3baa2617 2022-02-16 op if this option is specified,
42 3baa2617 2022-02-16 op .Nm
43 3baa2617 2022-02-16 op will run in the foreground and log to
44 3baa2617 2022-02-16 op .Em stderr .
45 3baa2617 2022-02-16 op .It Fl v
46 3baa2617 2022-02-16 op Produce more verbose output.
47 3baa2617 2022-02-16 op .It Fl s Ar socket
48 3baa2617 2022-02-16 op Use
49 3baa2617 2022-02-16 op .Ar socket
50 3baa2617 2022-02-16 op instead of the default
51 3baa2617 2022-02-16 op .Pa /tmp/amused-$UID
52 3baa2617 2022-02-16 op to communicate with the daemon.
53 3baa2617 2022-02-16 op .El
54 3baa2617 2022-02-16 op .Pp
55 3baa2617 2022-02-16 op The following commands are available:
56 3baa2617 2022-02-16 op .Bl -tag -width 12m
57 3baa2617 2022-02-16 op .It Cm play
58 3baa2617 2022-02-16 op Start playing the playlist.
59 3baa2617 2022-02-16 op .It Cm pause
60 3baa2617 2022-02-16 op Pause the reproduction.
61 3baa2617 2022-02-16 op .It Cm toggle
62 3baa2617 2022-02-16 op Toggle pause state.
63 3baa2617 2022-02-16 op .It Cm stop
64 3baa2617 2022-02-16 op Stop the music player.
65 3baa2617 2022-02-16 op .It Cm restart
66 3baa2617 2022-02-16 op Restart the current song from the beginning.
67 3baa2617 2022-02-16 op .It Cm add Ar
68 3baa2617 2022-02-16 op Enqueue the given files.
69 3baa2617 2022-02-16 op .It Cm flush
70 3baa2617 2022-02-16 op Erase the playlist.
71 3baa2617 2022-02-16 op .El
72 3baa2617 2022-02-16 op .Sh FILES
73 3baa2617 2022-02-16 op .Bl -tag -width "/tmp/amused-$UID" -compact
74 3baa2617 2022-02-16 op .It Pa /tmp/amused-$UID
75 3baa2617 2022-02-16 op UNIX-domain socket used for communication with the daemon.
76 3baa2617 2022-02-16 op .El
77 3baa2617 2022-02-16 op .Sh AUTHORS
78 3baa2617 2022-02-16 op .An -nosplit
79 3baa2617 2022-02-16 op Then
80 3baa2617 2022-02-16 op .Nm
81 3baa2617 2022-02-16 op utility was written by
82 3baa2617 2022-02-16 op .An Omar Polo Aq Mt op@openbsd.org .