supplementary_scripts/mp3fix/README

   1 <div align="center"><b>Mp3Fixer (v0.9.4)</b></div>
   2
   3 <p>
   4 <b>About:</b><br>
   5 Mp3Fixer is a script for repairing MP3 files which display a bogus track length or bitrate in your
   6 audio player.
   7 </p>
   8 <p>
   9 For example, if you have a track that you know is really <i>five minutes</i> long, but
  10 Amarok shows the length as <i>one hour</i>, then this script is for you. Mp3Fixer calculates the
  11 real track length and adds the missing XING header to the file. Additionally, Mp3Fixer is capable
  12 of repairing broken MPEG header frames.
  13 </p>
  14 <p>
  15 It is recommended that you <i>back up</i> your MP3 file before using this script on it. Although the
  16 script is designed not to harm your file, the operation is not reversible and should therefore
  17 be used with caution.
  18 </p>
  19
  20 <p>
  21 <b>Usage:</b><br>
  22 Select a track in the playlist, then start Mp3Fixer from the context-menu (right mouse click).
  23 </p>
  24 <p>
  25 It is also possible to use Mp3Fixer as a command line tool, by calling the mp3fix.rb script
  26 contained in this package. mp3fix.rb only requires Ruby to be installed, not Amarok.
  27 The Mp3Fixer Amarok Script is a frontend for this tool.
  28 </p>
  29
  30 <p>
  31 <b>Dependencies:</b><br>
  32 <ul>
  33 <li>Amarok 1.3.1</li>
  34 <li>Ruby 1.8</li>
  35 </ul>
  36 </p>
  37
  38 <p>
  39 <b>ChangeLog:</b><br>
  40 Version 0.9.4:<br>
  41 <ul>
  42 <li>Fixed potential runtime error with some files.</li>
  43 </ul>
  44 Version 0.9.3:<br>
  45 <ul>
  46 <li>Show detailed repair summary.</li>
  47 <li>Some mp3 encoders (e.g. lame) add a block of zeros as padding to the beginning
  48 of the file. This is now correctly handled.</li>
  49 <li>mp3fix.rb did not work with source != destination.</li>
  50 </ul>
  51 Version 0.9.2:<br>
  52 <ul>
  53 <li>Automatically update the collection after repairing files.</li>
  54 <li>Automatically refresh the playlist.</li>
  55 </ul>
  56 Version 0.9.1:<br>
  57 <ul>
  58 <li>Fixed a bug that could make the script crap out with a runtime error.</li>
  59 <li>Show current filename in the statusbar.</li>
  60 </ul>
  61 Version 0.9:<br>
  62 <ul>
  63 <li>mp3fix.rb can now repair broken MPEG frames.</li>
  64 <li>Batch processing of multiple selected files.</li>
  65 <li>Using Amarok's statusbar for feedback instead of kdialog. This means, KDE-base is
  66 no longer required.</li>
  67 <li>More reliable, better error checking.</li>
  68 </ul>
  69 </p>
  70
  71 <p>
  72 <b>Author:</b><br>
  73 Mark Kretschmann (markey@web.de)
  74 </p>
  75