home *** CD-ROM | disk | FTP | other *** search
/ Dream 49 / Amiga_Dream_49.iso / amiga / applications / musique / mp3info.lha / mp3info.readme < prev   
Text File  |  1998-02-01  |  7KB  |  214 lines
  1. Short:        Read/Write MP3 TAG info. v0.2.13
  2. Author:        nagilum@chillout.org (amiga compile), xeno@mix.hive.no (author)
  3. Uploader:    nagilum@chillout.org
  4. Version:    v0.2.13
  5. Type:        mus/misc
  6.  
  7. ==============================================================================
  8. ..just a few notes from me, Nagilum:
  9.  
  10. Porting was no problem after installing gcc, the people from the Geek Gadgets
  11. project did a great job, all i did was extracting and typing make (basically).
  12. To do something more by myself i also wrote a small MUI GUI using Argue but
  13. you probably have to change some pathes depending on where you install it.
  14. Maybe someone could write a better GUI, or someone could port tcl/tk8.0
  15. so my tcl/tk-GUI, i'm just working on, would run on Amiga as well as it
  16. does under X11, i will include it anyways when it's finished.
  17. Now its Tavenard's turn to update mpega (add new genres) again ;-) ,
  18.  
  19. Summary:
  20. bin/        68000-68060 binaries of mp3info
  21. mp3info.old/    mp3info v0.25 ported by mikecheng@cryogen.com
  22.         included because he did a nice AmigaGuide file ;-)
  23. MUI-GUI/    All the needed files for the GUI exept the binary,
  24.         copy it from the bin/ directory, also in this directory
  25.         is the argue binary & guide, get the whole archive from
  26.         the aminet, it's really worth a look.
  27.  
  28.         latest change: Someone reported wrong returncodes
  29.         but i couldn't find a reason for that. :-\
  30.         I've also heard that the Argue archive has been
  31.         deleted from aminet, if you need it  download
  32.         CyberQT or CyberAVI, the archive is included there.
  33.  
  34. Cya.
  35. ==============================================================================
  36. **********************
  37.       mp3Info
  38. **********************
  39.  
  40. A small utility to read and write TAG info, as well as retrieve the MP3
  41. Header info and print it all out in a nice format.
  42.  
  43. Released under GNU GPL.
  44.  
  45. Features:
  46.  - Get, Set and Wipe MP3 TAG Info.
  47.  - Get MPEG Audio Version 1, 2 and 2.5 (All Layers) Header info.
  48.  - Userdefinable output formatting (rather advanced).
  49.  - Can rename files according to userdefined scheme.
  50.  - Can now also PLAY MP3s in a correct manner (Linux only).
  51.  
  52. Author is Thorvald Natvig <slicer@bimbo.hive.no>, if you in any way think this
  53. is a nice program, send me an email saying "Hi". Feedback is nice.
  54.  
  55. I have only tested it on Linux/x86, but people have reported it to work on
  56. a lot of other machines, and it should theoretically work on anything. I'm
  57. interested in having it compilable on other machines, so mail me any
  58. problems you may have.
  59.  
  60. A few people have tested this on other Unix-alike platforms, and gotten it
  61. to work, and it's even reported to work under OS/2 :) 
  62.  
  63. INSTALLATION INSTRUCTIONS:
  64.  
  65. If you're NOT on a Linux system, modify the Makefile and comment out all the
  66. player stuff. The player will only work on Linux.
  67.  
  68. Just run the file 'INSTALL' to install it, should theoretically work just
  69. fine.
  70.  
  71. Someday I'll learn how to do autoconfig and then it will be even finer.
  72.  
  73. If you change any of the source, please, Please send me a patch or the new
  74. source so I can include it. Also send me a email if you use this utility :)
  75.  
  76. NEW VERSIONS:
  77. New versions will be available on ftp://bimbo.hive.no/pub/mp3info/
  78. They will also be uploaded to sunsite
  79.  
  80. MP3 PLAYING:
  81.  
  82. There are three methods of playing:
  83.  
  84. If you DON'T have a Linux machine, but have some other program that CAN play
  85. mp3 files, use
  86. mp3info -e "programname \"%f\"" CoolMusic.mp3
  87.  
  88. This will run
  89. programname CoolMusic.mp3
  90. which will play the music for you
  91.  
  92. For AMP, use 
  93. mp3info -e "amp -q \"%f\"" filename.mp3
  94.  
  95. Another (at least on Linux) is to use l3dec
  96. (From Fraunhofer (http://www.iis.fhg.de/departs/amm/layer3/))
  97. Just put it anywhere in your path.
  98. The piper and audioplaying is done by the program
  99. itself, at optimum speed :) 
  100.  
  101. The last is to use splay (preferred, but much larger executable)
  102. Get it from ftp://sunsite.unc.edu/pub/Linux/apps/sound/splay-0.6.tar.gz
  103. This is the default method, as indicated in the Makefile.
  104.  
  105. Both versions can be forced to skip to the next song by sending the program
  106. a HUP signal.
  107. Very handy for putting the program in the background with a LARGE playlist.
  108.  
  109. I have included my playmp script, which I doubt will work on anything but
  110. Linux system where you are root (just edit it and it will work anywhere).
  111. What it does, is use locate to find all your MP3 tunes, and play them
  112. all randomly. It goes with a shell alias:
  113. alias mp='killall -HUP mp3info'
  114. Just type 'mp' to skip to the next song.
  115.  
  116. *****************************
  117. Output formatting magic
  118.  
  119. The output from the program can be 100% userdefines. There are two uses, one
  120. is -f <format> to set the output format, and the other is -N <format> to set
  121. a naming scheme. -N will RENAME the files specified according to the format.
  122.  
  123. The format is built up as a string, with the following special characters:
  124.  
  125. %% = %
  126. %I = IF (explained below)
  127. %! = Not-IF (also explained below)
  128. %t = title of song
  129. %a = Artist
  130. %l = album
  131. %y = year
  132. %c = comment
  133. %g = genre (text)
  134. %# = genre (number)
  135. %v = MPEG Version (1/2/2.5)
  136. %V = MPEG Version as text
  137. %L = Layer version (I, II, III)
  138. %A = Layer version as number
  139. %C = Error_Protection (0/1)
  140. %b = Bitrate (in kbit/s)
  141. %F = Sampling frequency
  142. %M = mode
  143. %O = Copyright (0/1)
  144. %o = Original (0/1)
  145. %m = length (minutes)
  146. %s = length (remaining seconds.. Ie 3m 2s is "%mm %ss")
  147. %S = length (ALL in seconds).
  148. %N = Newline
  149. %f = Filename (as specified on command line)
  150. %B = Base filename (path stripped)
  151. %i = Size of file (in bytes)
  152. %E = ANSI ESC-code (\0x1B [ )
  153.  
  154. If cases:
  155. If-cases are %I<WHAT>..
  156. %IT If TAG info present
  157. %IH If HEADER info present
  158. %Ia If Artist info present
  159. %It If Title of song present
  160. %Il If album name present
  161. %Iy If year present
  162. %Ic If comment present
  163. %IC If CRC.
  164. %IO If Copyrighted.
  165. %Io If Original
  166. %IS If Stereo
  167. %IE End-IF.
  168.  
  169. %! and the same characters means If NOT. So %!T means IF NOT TAG.
  170. %!E is ELSE.
  171.  
  172. Example..
  173. %IT Tag info present%IE %IHHeader info present %ICwith CRC%IE%IE
  174.  
  175. should explain it.
  176. As seen, ifs can be nested. 
  177.  
  178. There is a length limit on the formatting string and the output which can be
  179. set in mp3tools.h
  180.  
  181. Hint:
  182. Bash etc often has ! as a special char, meaning you can't use it on the
  183. command line, you have to have it in a bash-script of sorts.
  184.  
  185. Formatting:
  186. mp3info now understands normal printf formatting, so you can use
  187. "%m:%02s" to get 3:02 for the duration.
  188.  
  189. Naming: I use the following naming scheme :
  190. mp3info -N "%IH%It%t.mp3%IE%IE"
  191. Which calls the tune
  192. Rhythm is a dancer.mp3
  193.  
  194. Which names the files as <song name>.mp3, which is how I like it.
  195. As an alternative, you can use:
  196. mp3info -N "%IH%It%Ia(%a)-%IE%t.mp3%IE%IE"
  197. Which would produce
  198. (Snap)-Rhythm is a dancer.mp3
  199. as a name.
  200.  
  201. -------
  202. CREDITS
  203. -------
  204.  
  205. I got the info about the MPEG Headers from free software available to decode
  206. MPEG2 streams. 
  207.  
  208. ID3 format by NamkraD/DC (erick@marble.net)
  209. http://www.marble.net/~erick/mpeg3.htm
  210.  
  211. The debian stuff was added by Clint Adams <schizo@simons-rock.edu>
  212.  
  213. And a big thanks to all those who sent me an email :)
  214.