.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.Dd May 9, 2022
+.Dd May 10, 2022
.Dt AMUSED 1
-is a music player daemon and command-line utility that plays music
-in the background.
-The server is automatically started when the user interacts with
+is a music player daemon and command-line utility to plays music.
+The server is started automatically in the background on demand.
The following options are available:
.Bl -tag -width Ds
will run in the foreground and log to standard error.
It's ignored if any commands are given on the command line or if the
-server was already running.
+server is already running.
.It Fl v
Produce more verbose output.
.It Fl s Ar socket
Load a playlist from
or standard input.
-A playlist is a list of paths to music files one per line optionally
+A playlist is a list of paths to music files given one per line
+and optionally prefixed by
.Sq > \&
or two spaces.
If the list was generated by
.Ic show Fl p
-restores also the currently played song, otherwise tries to match it in
-the new list.
+restores also the position in the playlist, otherwise if already playing
+something tries to match the currently playing song in the new list.
+Failing that, the playlist will be played from the first track onwards.
.It Cm monitor
-Stop indefinitely and print the events as happen.
-Events are print one per line and are triggered either by other
+Stop indefinitely and print the events as they happen one per line.
+The events are triggered either by other instances of
-issuing commands or the player itself anvancing the playing queue.
+issuing commands or the player itself anvancing through the playing
.It Cm next
Play the next song.
.It Cm pause
.It Cm prev
Play the previous song.
.It Cm repeat one|all on|off
-Enable or disable the repetition of the current track
+Enable or disable the automatic repetition of the current track
.Pq Cm one
-or of the playing queue
+or of the whole playing queue
.Pq Cm all .
.It Cm restart
Rewind the current song to the beginning.
$ amused load < state
-Randomize the current playlist:
+Shuffle the playlist:
.Bd -literal -offset indent
$ amused show | sort -R | amused load