www/mp3tool/mp3tool.html

   1 <!DOCTYPE html>
   2 <html lang="en">
   3 <head>
   4 <meta charset="UTF-8">
   5 <!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
   6 <meta name="viewport" content="width=device-width, initial-scale=1.0">
   7 <meta name="generator" content="Asciidoctor 1.5.5">
   8 <title>MP3Tool</title>
   9 <link rel="stylesheet" href="./../style.css">
  10 <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.2.4/jquery.min.js"></script>
  11 <script src="../nav.js"></script>
  12 </head>
  13 <body class="article">
  14 <div id="header">
  15 <h1>MP3Tool</h1>
  16 </div>
  17 <div id="content">
  18 <div id="preamble">
  19 <div class="sectionbody">
  20 <div class="paragraph">
  21 <p>The MP3 files contain information about the name of the artist, the
  22 name of the album, the sound title, etc.</p>
  23 </div>
  24 <div class="paragraph">
  25 <p>MP3Tool is a command line tool for moving a MP3 file according to these
  26 information. It can also output the information.</p>
  27 </div>
  28 </div>
  29 </div>
  30 <div class="sect1">
  31 <h2 id="_usage">Usage</h2>
  32 <div class="sectionbody">
  33 <div class="sect2">
  34 <h3 id="_display_mp3_information">Display MP3 information</h3>
  35 <div class="paragraph">
  36 <p>Displays the MP3 information of the file ‘file.mp3’:</p>
  37 </div>
  38 <div class="listingblock">
  39 <div class="content">
  40 <pre>mp3tool -i PATTERN file.mp3</pre>
  41 </div>
  42 </div>
  43 <div class="paragraph">
  44 <p>The format string <code>PATTERN</code> controls the contents of the mp3tool
  45 output.  It can contains MP3 tag information variables.  Move a MP3
  46 file</p>
  47 </div>
  48 <div class="paragraph">
  49 <p>Moves <code>files.mp3</code> to <code>dest</code>:</p>
  50 </div>
  51 <div class="listingblock">
  52 <div class="content">
  53 <pre>mp3tool -m PATTERN file.mp3</pre>
  54 </div>
  55 </div>
  56 <div class="paragraph">
  57 <p>The <code>PATTERN</code> string can contain MP3 tag information variables.</p>
  58 </div>
  59 <div class="paragraph">
  60 <p>MP3 tag information variables:</p>
  61 </div>
  62 <div class="ulist">
  63 <ul>
  64 <li>
  65 <p>%c comment</p>
  66 </li>
  67 <li>
  68 <p>%a name of the artist</p>
  69 </li>
  70 <li>
  71 <p>%l name of the album</p>
  72 </li>
  73 <li>
  74 <p>%t title</p>
  75 </li>
  76 <li>
  77 <p>%y year</p>
  78 </li>
  79 <li>
  80 <p>%% percent</p>
  81 </li>
  82 <li>
  83 <p>%n newline</p>
  84 </li>
  85 </ul>
  86 </div>
  87 <div class="paragraph">
  88 <p>Examples:</p>
  89 </div>
  90 <div class="listingblock">
  91 <div class="content">
  92 <pre>mp3tool -m "%a/%l/%f" file.mp3</pre>
  93 </div>
  94 </div>
  95 <div class="paragraph">
  96 <p>will move <code>file.mp3</code> into the directory <code>artist/album</code>.</p>
  97 </div>
  98 <div class="listingblock">
  99 <div class="content">
 100 <pre>mp3tool -m "%a - %l - %t.mp3" file.mp3</pre>
 101 </div>
 102 </div>
 103 <div class="paragraph">
 104 <p>will rename <code>file.mp3</code> to <code>artist – album – title.mp3</code>.</p>
 105 </div>
 106 </div>
 107 </div>
 108 </div>
 109 <div class="sect1">
 110 <h2 id="_installation_for_ubuntu">Installation for Ubuntu</h2>
 111 <div class="sectionbody">
 112 <div class="paragraph">
 113 <p>The easy way to install mp3tool on Ubuntu is to use the PPA:</p>
 114 </div>
 115 <div class="listingblock">
 116 <div class="content">
 117 <pre>sudo apt-add-repository ppa:jfi/mp3tool
 118 sudo apt-get update
 119 sudo apt-get install mp3tool</pre>
 120 </div>
 121 </div>
 122 <div class="paragraph">
 123 <p>Alternatively, it can be installed manually by downloading Ubuntu
 124 binary packages, see the ‘Download Links’ section of this page.</p>
 125 </div>
 126 </div>
 127 </div>
 128 <div class="sect1">
 129 <h2 id="_installation_from_source_archive">Installation from source archive</h2>
 130 <div class="sectionbody">
 131 <div class="paragraph">
 132 <p>MP3Tool should compile on any Linux plateform:</p>
 133 </div>
 134 <div class="listingblock">
 135 <div class="content">
 136 <pre>make clean all</pre>
 137 </div>
 138 </div>
 139 <div class="paragraph">
 140 <p>Then perform the installation:</p>
 141 </div>
 142 <div class="listingblock">
 143 <div class="content">
 144 <pre>make install</pre>
 145 </div>
 146 </div>
 147 </div>
 148 </div>
 149 <div class="sect1">
 150 <h2 id="_download_links">Download Links</h2>
 151 <div class="sectionbody">
 152 <div class="ulist">
 153 <ul>
 154 <li>
 155 <p><a href="files">Source archives</a>.</p>
 156 </li>
 157 </ul>
 158 </div>
 159 </div>
 160 </div>
 161 <div class="sect1">
 162 <h2 id="_contact_information">Contact Information</h2>
 163 <div class="sectionbody">
 164 <div class="paragraph">
 165 <p>Bugs and comments can be sent to <a href="mailto:wpitchoune@gmail.com">wpitchoune@gmail.com</a>.</p>
 166 </div>
 167 <div class="paragraph">
 168 <p>Released under GPLv2 license terms.</p>
 169 </div>
 170 </div>
 171 </div>
 172 </div>
 173 <div id="footer">
 174 <div id="footer-text">
 175 Last updated 2016-06-15 10:46:45 CEST
 176 </div>
 177 </div>
 178 </body>
 179 </html>