5 The MP3 files contain information about the name of the artist, the
6 name of the album, the sound title, etc.
8 MP3Tool is a command line tool for moving a MP3 file according to these
9 information. It can also output the information.
13 === Display MP3 information
15 Displays the MP3 information of the file ‘file.mp3’:
18 mp3tool -i PATTERN file.mp3
21 The format string `PATTERN` controls the contents of the mp3tool
22 output. It can contains MP3 tag information variables. Move a MP3
25 Moves `files.mp3` to `dest`:
28 mp3tool -m PATTERN file.mp3
31 The `PATTERN` string can contain MP3 tag information variables.
33 MP3 tag information variables:
37 * %a name of the artist
39 * %l name of the album
52 mp3tool -m "%a/%l/%f" file.mp3
55 will move `file.mp3` into the directory `artist/album`.
58 mp3tool -m "%a - %l - %t.mp3" file.mp3
61 will rename `file.mp3` to `artist – album – title.mp3`.
63 == Installation for Ubuntu
65 The easy way to install mp3tool on Ubuntu is to use the PPA:
68 sudo apt-add-repository ppa:jfi/mp3tool
70 sudo apt-get install mp3tool
73 Alternatively, it can be installed manually by downloading Ubuntu
74 binary packages, see the ‘Download Links’ section of this page.
76 == Installation from source archive
78 MP3Tool should compile on any Linux plateform:
84 Then perform the installation:
92 * link:files[Source archives].
94 == Contact Information
96 Bugs and comments can be sent to wpitchoune@gmail.com.
98 Released under GPLv2 license terms.