lib/mpg123
1
0
Fork 0
mirror of http://mpg123.de/trunk/.git synced 2025-08-07 21:02:55 +03:00
Code Activity

Update remote control doc and push version of interface to v3.

Browse Source 
git-svn-id: svn://scm.orgis.org/mpg123/trunk@1302 35dc7657-300d-0410-a2e5-dc2837fedb53
This commit is contained in:
thor
2007-12-23 10:35:03 +00:00
parent f1444c0f99
commit 49cf9767ab
2 changed files with 71 additions and 44 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
doc/README.remote
View File

@@ -20,7 +20,7 @@ The command respones are still sent to standard out or standard error (depending
COMMAND CODES
-------------
You can get this info via the control command "help"
You can get this info via the control command "help".
HELP/H: command listing (LONG/SHORT forms), command case insensitve
@@ -40,10 +40,22 @@ RVA off|(mix|radio)|(album|audiophile): set rva mode
EQ/E <channel> <band> <value>: set equalizer value for frequency band on channel
SEEK/K <sample>|<+offset>|<-offset>: jump to output sample position <samples> or change position by offset
SEQ <bass> <mid> <treble>: simple eq setting...
SILENCE: be silent during playback (meaning silence in text form)
TAG/T: Print all available (ID3) tag info, for ID3v2 that gives output of all collected text fields, using the ID3v2.3/4 4-character
names.
meaning of the @S stream info:
S <mpeg-version> <layer> <sampling freq> <mode(stereo/mono/...)> <mode_ext> <framesize> <stereo> <copyright> <error_protected> <emphasis> <bitrate> <extension> <vbr(0/1=yes/no)>
The @I lines after loading a track give some ID3 info, the format:
@I ID3:artist album year comment genretext
where artist,album and comment are exactly 30 characters each, year is 4 characters, genre text unspecified.
You will encounter "@I ID3.genre:<number>" and "@I ID3.track:<number>".
Then, there is an excerpt of ID3v2 info in the structure
RESPONSE CODES
--------------
@@ -51,8 +63,8 @@ RESPONSE CODES
Note: mpg123 returns errors on stderr, so your frontend should
look not only at stdout but also at stderr for responses.
@R MPG123
Startup version message
@R MPG123 (ThOr) v3
Startup version message. Rverything after MPG123 is auxilliary information about behaviour and command support, ID3v2 tag support is new in v3.
@I ID3:<a><b><c>
Status message after loading a song (ID3 song info)
@@ -63,6 +75,13 @@ Note: mpg123 returns errors on stderr, so your frontend should
e = comment (exactly 30 chars)
f = genre (string)
@I ID3.genre:<number>
@I ID3.track:<number>
Optional lines with additional ID3v1 info (if present): Genre ID and track number in set.
@I ID3v2.title:<text>
After loading a track with ID3v2 info, such lines occur for every line of the "title" data field and likewise for other fields (author, album, etc).
@I <a>
Status message after loading a song (no ID3 song info)
a = filename without path and extension
@@ -120,6 +139,14 @@ Note: mpg123 returns errors on stderr, so your frontend should
@bass: <b> mid: <m> treble: <t>
Set simple equalizer control for bass, mid, treble.
@T <response from TAG command>
The output is multiple lines, begin marked by "@T {", end by "@T }".
ID3v1 data is like in the @I info lines, just with "@T" in front.
An ID3v2 data field is introduced via ([ ... ] means optional):
@T ID3v2.<NAME>[ [lang(<LANG>)] desc(<description>)]:
The lines of data follow with "=" prefixed:
@T =<one line of content in UTF-8 encoding>
Info about the equalizer control:

2
src/control_generic.c
View File

@@ -261,7 +261,7 @@ int control_generic (mpg123_handle *fr)
#endif
/* the command behaviour is different, so is the ID */
/* now also with version for command availability */
fprintf(outstream, "@R MPG123 (ThOr) v2\n");
fprintf(outstream, "@R MPG123 (ThOr) v3\n");
#ifdef FIFO
if(param.fifo)
{