home *** CD-ROM | disk | FTP | other *** search
/ Dream 49 / Amiga_Dream_49.iso / amiga / applications / musique / mp3info.lha / mp3info.old / mp3info.readme < prev   
Text File  |  1997-05-28  |  4KB  |  148 lines
  1. Short: Read/Write MP3 TAG info. v0.25
  2. Author: mikecheng@cryogen.com (amiga compile), xeno@mix.hive.no (author)
  3. Uploader: mikecheng@cryogen.com
  4. Version: v0.25
  5. Type:mus/misc
  6.  
  7. **********************
  8.       mp3Info
  9. **********************
  10.  
  11. A small utility to read and write TAG info, as well as retrieve the MP3
  12. Header info and print it all out in a nice format.
  13.  
  14. Features:
  15.  - Get, Set and Wipe MP3 TAG Info.
  16.  - Get MPEG Audio Version 1, 2 and 2.5 (All Layers) Header info.
  17.  - Userdefinable output formatting (rather advanced).
  18.  - Can rename files according to userdefined scheme.
  19.  - Can now also PLAY MP3s in a correct manner (Linux only).
  20.  
  21. Author is Thorvald Natvig <xeno@mix.hive.no>, if you in any way think this
  22. is a nice program, send me an email saying "Hi". Feedback is nice.
  23.  
  24. Only tested on Linux/x86, but should theoretically work on anything. I'm
  25. interrested in having it compilable on other machines, so mail me any
  26. problems you may have.
  27.  
  28.  
  29. INSTALLATION INSTRUCTIONS:
  30. Just run the file 'INSTALL' to install it, should theoretically work just
  31. fine.
  32. Someday I'll learn how to do autoconfig and then it will be even finer.
  33.  
  34. If you change any of the source, please, Please send me a patch or the new
  35. source so I can include it. Also send me a email if you use this utility :)
  36.  
  37. genre.h is autogenerated from list.txt, whcih can be found on the homepage
  38. of Studio3 by NamkraD/DC.
  39.  
  40. If mkgenre doesn't work, copy genre.h.dist to genre.h and it should work.
  41.  
  42. NEW VERSIONS:
  43. New versions will be available on ftp://bimbo.hive.no/pub/mp3info/
  44. and if that should fail on my webpage, http://mix.hive.no/~xeno/
  45.  
  46. MP3 PLAYING:
  47.  
  48. There are two methods of playing:
  49.  
  50. One is to use l3dec
  51. (From Fraunhofer (http://www.iis.fhg.de/departs/amm/layer3/))
  52. Just put it anywhere in your path.
  53. The piper and audioplaying is done by the program
  54. itself, at optimium speed :) 
  55.  
  56. The other is to use splay(preferred, but much larger executable)
  57. Get it from ftp://sunsite.unc.edu/pub/Linux/apps/sound/splay-0.1.tar.gz
  58. This is the default method, as indicated in the Makefile.
  59.  
  60.  
  61. *****************************
  62. Output formatting magic
  63.  
  64. The output from the program can be 100% userdefines. There are two uses, one
  65. is -f <format> to set the output format, and the other is -N <format> to set
  66. a naming scheme. -N will RENAME the files specified according to the format.
  67.  
  68. The format is built up as a string, with the following special characters:
  69.  
  70. %% = %
  71. %I = IF (explained below)
  72. %! = Not-IF (also explained below)
  73. %t = title of song
  74. %a = Artist
  75. %l = album
  76. %y = year
  77. %c = comment
  78. %g = genre (text)
  79. %# = genre (number)
  80. %v = MPEG Version (1/2)
  81. %L = Layer version (I, II, III)
  82. %C = Error_Protection (0/1)
  83. %b = Bitrate (in kbit/s)
  84. %F = Sampling frequency
  85. %M = mode
  86. %O = Copyright (0/1)
  87. %o = Original (0/1)
  88. %m = length (minutes)
  89. %s = length (remainding seconds.. Ie 3m 2s is "%mm %ss")
  90. %S = length (ALL in seconds).
  91. %N = Newline
  92. %f = Filename (as specified on command line)
  93. %i = Size of file (in bytes)
  94.  
  95. If cases:
  96. If-cases are %I<WHAT>..
  97. %IT If TAG info present
  98. %IH If HEADER info present
  99. %Ia If Artist info present
  100. %It If Title of song present
  101. %Il If album name present
  102. %Iy If year present
  103. %Ic If comment present
  104. %IC If CRC.
  105. %IO If Copyrighted.
  106. %Io If Original
  107. %IS If Stereo
  108. %IE End-IF.
  109.  
  110. %! and the same characters means If NOT. So %!T means IF NOT TAG.
  111. %!E is ELSE.
  112.  
  113. Example..
  114. %IT Tag info present%IE %IHHeader info present %ICwith CRC%IE%IE
  115.  
  116. should explain it.
  117. As seen, if's can be nested. 
  118.  
  119. There is a length limit on the formatting string and the output which can be
  120. set in mp3tools.h
  121.  
  122. Hint:
  123. Bash etc often has ! as a special char, meaning you can't use it on the
  124. command line, you have to have it in a bash-script of sorts.
  125.  
  126. Naming: I use the following naming scheme :
  127. mp3info -N "%IH%It%t.mp3%IE%IE"
  128. Which calls the tune
  129. Rhythm is a dancer.mp3
  130.  
  131. Which names the files as <song name>.mp3, which is how I like it.
  132. As an alternative, you can use:
  133. mp3info -N "%IH%It%Ia(%a)-%IE%t.mp3%IE%IE"
  134. Which would produce
  135. (Snap)-Rhythm is a dancer.mp3
  136. as a name.
  137.  
  138. -------
  139. CREDITS
  140. -------
  141.  
  142. I got the info about the MPEG Headers from free software available to decode
  143. MPEG2 streams. 
  144.  
  145. ID3 format by NamkraD/DC (erick@marble.net)
  146. http://www.marble.net/~erick/mpeg3.htm
  147.  
  148.