1 3baa2617 2022-02-16 op .\" Copyright (c) 2022 Omar Polo <op@openbsd.org>
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.
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.
15 2b907c6d 2022-02-17 op .Dd February 17, 2022
20 3baa2617 2022-02-16 op .Nd music player
24 3baa2617 2022-02-16 op .Op Fl s Ar socket
26 3baa2617 2022-02-16 op .Op Ar argument ...
27 3baa2617 2022-02-16 op .Sh DESCRIPTION
29 3baa2617 2022-02-16 op is a music player daemon and command-line utility.
31 3baa2617 2022-02-16 op If called without any sub-
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
37 3baa2617 2022-02-16 op The following options are available:
38 3baa2617 2022-02-16 op .Bl -tag -width 12m
40 3baa2617 2022-02-16 op Do not daemonize.
41 3baa2617 2022-02-16 op if this option is specified,
43 3baa2617 2022-02-16 op will run in the foreground and log to
46 3baa2617 2022-02-16 op Produce more verbose output.
47 3baa2617 2022-02-16 op .It Fl s 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.
55 3baa2617 2022-02-16 op The following commands are available:
56 3baa2617 2022-02-16 op .Bl -tag -width 12m
58 fe69a8fc 2022-02-16 op Start or resume playing the playlist.
60 fe69a8fc 2022-02-16 op Pause the playback.
62 fe69a8fc 2022-02-16 op Play/pause the playback.
64 3baa2617 2022-02-16 op Stop the music player.
65 3baa2617 2022-02-16 op .It Cm restart
66 fe69a8fc 2022-02-16 op Rewind the current song from the beginning.
68 3baa2617 2022-02-16 op Enqueue the given files.
70 3baa2617 2022-02-16 op Erase the playlist.
72 fe69a8fc 2022-02-16 op Print the current playlist.
74 fe69a8fc 2022-02-16 op Print playback status and current song.
76 60697f73 2022-02-17 op Play the next song.
78 60697f73 2022-02-17 op Play the previous song.
79 ba7595d8 2022-02-17 op .It Cm load Op Ar file
80 ba7595d8 2022-02-17 op Load a playlist from
82 ba7595d8 2022-02-17 op which has one song per line.
83 ba7595d8 2022-02-17 op If not specified, reads from
87 3baa2617 2022-02-16 op .Bl -tag -width "/tmp/amused-$UID" -compact
88 3baa2617 2022-02-16 op .It Pa /tmp/amused-$UID
89 3baa2617 2022-02-16 op UNIX-domain socket used for communication with the daemon.
92 2c35cd80 2022-02-17 op Enqueue all mp3 files in the current directory:
93 2c35cd80 2022-02-17 op .Bd -literal -offset indent
94 2c35cd80 2022-02-17 op $ amused add *.mp3
97 2c35cd80 2022-02-17 op Recursively add all opus files:
98 2c35cd80 2022-02-17 op .Bd -literal -offset indent
99 2c35cd80 2022-02-17 op $ find . -type f -iname \\*.opus -exec amused add {} +
102 2c35cd80 2022-02-17 op Save the state of the player to the file
104 2c35cd80 2022-02-17 op .Bd -literal -offset indent
105 2c35cd80 2022-02-17 op $ amused show > state
108 2c35cd80 2022-02-17 op Load a previous state:
109 2c35cd80 2022-02-17 op .Bd -literal -offset indent
110 2c35cd80 2022-02-17 op $ amused load < state
116 3baa2617 2022-02-16 op utility was written by
117 3baa2617 2022-02-16 op .An Omar Polo Aq Mt op@openbsd.org .