README
1flac123 is a command-line program for playing flac-encoded files.
2
3To build flac123:
4
5 # ./configure
6 # make
7 # make install
8
9
10flac-tools
11
12flac-tools aims to be a complete set of tools for playing and
13manipulating audio files stored the the FLAC format. flac123 is the
14only component of flac-tools at this time.
15
16The flac123 and flac-tools homepage is http://flac-tools.sourceforge.net
17
18
19FLAC
20
21FLAC is an open format for losslessly compressing audio data. For
22more information on FLAC see http://flac.sourceforge.net
23
24flac123 and the flac-tools package are licensed under the GNU GPL. See
25the file COPYING for details.
26
README.remote
1flac123 implements mpg123's 'Remote Control' interface via option -R.
2This is useful if you're writing a frontend to flac123 which needs a
3consistent, reliable interface to control playback.
4
5There are several differences between the README.remote specifications
6of mpg123, mpg321, and flac123:
7
8a. mpg123 specifies @P as the output of the PAUSE command, whereas mpg321
9specifies @S but uses @P. flac123 uses @P.
10
11b. mpg123 and mpg321 use <frames> as the argument to JUMP. flac123 uses
12seconds as the argument to JUMP.
13
14c. mpg321 does not specify two output modes for @I. flac123 uses two
15output modes for @I.
16
17d. mpg123 and mpg321 output @S for MPEG3 stream information. flac123
18does not output @S.
19
20e. mpg123 use percentage for @V(OLUME) (range: 0-100) . flac123 uses
21a fraction for @V(OLUME) (0.0-1.0).
22
23
24COMMANDS: (All commands can be shortened to first character only)
25--------
26
27LOAD <file>
28
29Loads and starts playing <file>.
30
31JUMP [+-]<seconds>
32If '+' or '-' is specified, jumps <seconds> seconds forward, or backwards,
33respectively, in the the flac file. If neither is specifies, jumps to
34absolute second <second> in the flac file.
35
36PAUSE
37Pauses the playback of the flac file; if already paused, restarts playback.
38
39VOLUME
40Sets the decoder volume between 0.0 and 1.0, where 1.0 equals 100%.
41
42QUIT
43Quits flac123.
44
45
46OUTPUT:
47------
48
49@R FLAC123
50flac123 tagline. Output at startup.
51
52@I ID3:<a><b><c><d><e><f>
53Prints out the metadata information after loading the flac file.
54a = title (30 chars)
55b = artist (30 chars)
56c = album (30 chars)
57d = year (4 chars)
58e = comment (30 chars)
59f = genre (30 chars)
60
61@I filename
62Prints out the filename of the flac file, minus the extension. Happens after
63a flac file has been loaded and there is no metadata available.
64
65@F <current-frame> <frames-remaining> <current-time> <time-remaining>
66Frame decoding status updates (once per frame).
67Current-frame and frames-remaining are integers; current-time and
68time-remaining floating point numbers with two decimal places.
69
70@P {0, 1, 2}
71Stop/pause status.
720 - playing has stopped. When 'STOP' is entered, or the flac file is finished.
731 - Playing is paused. Enter 'PAUSE' or 'P' to continue.
742 - Playing has begun again.
75
76@V {0.00000 - 1.00000}
77Report the volume multiplication factor (Note: It can even be bigger than 1.0).
78
79
80