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.4">
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>
13 <body class="article">
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>
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>
31 <h2 id="_usage">Usage</h2>
32 <div class="sectionbody">
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>
38 <div class="listingblock">
40 <pre>mp3tool -i PATTERN file.mp3</pre>
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
48 <div class="paragraph">
49 <p>Moves <code>files.mp3</code> to <code>dest</code>:</p>
51 <div class="listingblock">
53 <pre>mp3tool -m PATTERN file.mp3</pre>
56 <div class="paragraph">
57 <p>The <code>PATTERN</code> string can contain MP3 tag information variables.</p>
59 <div class="paragraph">
60 <p>MP3 tag information variables:</p>
68 <p>%a name of the artist</p>
71 <p>%l name of the album</p>
87 <div class="paragraph">
90 <div class="listingblock">
92 <pre>mp3tool -m "%a/%l/%f" file.mp3</pre>
95 <div class="paragraph">
96 <p>will move <code>file.mp3</code> into the directory <code>artist/album</code>.</p>
98 <div class="listingblock">
100 <pre>mp3tool -m "%a - %l - %t.mp3" file.mp3</pre>
103 <div class="paragraph">
104 <p>will rename <code>file.mp3</code> to <code>artist – album – title.mp3</code>.</p>
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>
115 <div class="listingblock">
116 <div class="content">
117 <pre>sudo apt-add-repository ppa:jfi/mp3tool
119 sudo apt-get install mp3tool</pre>
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>
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>
134 <div class="listingblock">
135 <div class="content">
136 <pre>make clean all</pre>
139 <div class="paragraph">
140 <p>Then perform the installation:</p>
142 <div class="listingblock">
143 <div class="content">
144 <pre>make install</pre>
150 <h2 id="_download_links">Download Links</h2>
151 <div class="sectionbody">
155 <p><a href="files">Source archives</a>.</p>
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>
167 <div class="paragraph">
168 <p>Released under GPLv2 license terms.</p>
174 <div id="footer-text">
175 Last updated 2016-12-18 19:07:34 CET