apc.1 (1357B)
1 .Dd May 26, 2023 2 .Dt APC 1 3 .Os 4 .Sh NAME 5 .Nm apc 6 .Nd audio player client 7 .Sh SYNOPSIS 8 .Nm apc 9 .Op Ar command Op Ar arguments ... 10 .Sh DESCRIPTION 11 The 12 .Nm 13 utility connects to 14 .Xr aps 1 15 and sends the given commands, printing their output (with the 16 exception of the status line which, if 17 .Sq ok , 18 is suppressed.) 19 .Pp 20 A command passed as arguments to 21 .Nm 22 is processed as described in 23 .Sx "Caret Handling" , 24 if no command is given as an argument, 25 .Nm 26 reads commands from the standard input until EOF occurs. 27 .Ss Caret Handling 28 If caret 29 .Sq ( ^ ) 30 is the first character that appears in the final argument given to 31 .Nm apc , 32 it is removed. If there are no more characters in the argument, the 33 argument is replaced by arguments taken from the standard input, 34 one per line, until EOF is encountered. (It is an error to have no 35 arguments from stdin in this case.) 36 .Sh ENVIRONMENT 37 .Bl -tag -width apsock 38 .It Ev apsock 39 The path to the socket used to connect to 40 .Xr aps 1 . 41 If 42 .Ev apsock 43 is not set, 44 .Pa /tmp/aps 45 is used. 46 .El 47 .Sh EXIT STATUS 48 .Ex -std 49 .Sh EXAMPLES 50 Sort the items in the queue: 51 .Dl $ apc list | sort | apc truncate ^ 52 .Pp 53 Reorder items matching 54 .Sq regex 55 to come next in the queue: 56 .Dl $ apc remove /regex | apc add ^ 57 .Pp 58 Add 59 .Sq ^caret 60 to the queue: 61 .Dl $ apc add ^^caret 62 .Sh SEE ALSO 63 .Xr aps 1 64 .Sh AUTHORS 65 .An Jacob R. Edwards Aq Mt jacob@jacobedwards.org