1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="keywords" content="MP3, diags, diagnosis, tag editor, tagger, normalizer, repair, VBR" />
<meta name="description" content="End-user documentation for MP3 Diags, an MP3 analysis tool that also includes correction and tag editing functionality" />
<title>MP3 Diags</title>
<link rel="stylesheet" type="text/css" media="screen" href="style.css" />
<!--[if lte IE 6]> <link rel="stylesheet" type="text/css" href="style_ie6.css" /> <![endif]-->
<!--[if IE 7]> <link rel="stylesheet" type="text/css" href="style_ie7.css" /> <![endif]-->
</head>
<link rel="icon" href="favicon.ico" type="image/x-icon" />
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon" />
<body>
<!-- Z:\windows\suse_10.3\home\ciobi\cpp\Mp3Utils\Mp3TagDoctorQt4\doc\html\index.html -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!--
<div class="HeaderText RegFnt ChpCol1">
<table width=100% class="HeaderTable">
<tr>
<td border="0" class="HeaderText">
<img src="logo.png" border="0" alt="MP3 Diags" align=middle />
</td>
<td border="0" class="RightAlign">
Hosted by SF
</td>
</tr>
</table>
</div>
QQQ
-->
<!-- add_this_conf -->
<div class="HeaderTableText RegFnt ChpCol1">
<table width="100%" class="HeaderTable">
<tr>
<td border="0" class="HeaderText">
<span class="HeaderPadLeft">
<span class="HeaderPadLeft RightMargin"><img src="logo.png" border="0" alt="MP3 Diags" align="middle" /></span>
<!-- add_this_link -->
</span>
</td>
<!-- sf_hosting -->
</tr>
</table>
</div>
<!--
QQQ
<div class="NormalText RegFnt ChpCol1">
<table width="100%" border="0" cellpadding="5" cellspacing="2" class="TitleText RegFnt">
<tr>
<td border="0" class="TitleText">
<img src="logo.png" border="0" alt="MP3 Diags" align="middle" />
</td>
<td border="0" class="RightAlign">
Hosted by SF
</td>
</tr>
</table>
</div>
QQQ
-->
<!--
<table>
<tr>
<td border="2" class="NormalText ChpCol2">
Hosted by
</td>
<td border="2" class="NormalText ChpCol2">
qq ve rt trvgertv trv tr rtb rtbh
</td>
</tr>
</table>
-->
<!-- <a href="http://sourceforge.net"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=203477&type=5" width="210" height="62" border="0" alt="SourceForge.net Logo" /></a> -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!--[if lte IE 6]>
<div class="RegFnt NoteCol FreeNormalText">
<span class="NoteCol">While some effort was put into making this site look OK and be usable with Internet Explorer 6, this browser and earlier versions have limitations that prevent it from looking the way it was meant to look. So you are encouraged to use something else.</span>
</div>
<![endif]-->
<div class="SubChapterText RegFnt ChpCol2">
Motivation
</div>
<div class="NormalText RegFnt ChpCol2">
In May 2008 I decided to improve my MP3 collection, by properly tagging all the files (including composer data), adding album cover art, fixing VBR headers, re-ripping albums that have poor sound quality, and more. I tried several programs, but I wasn't happy with how they worked. None of them did all the things that I wanted, and some corrupted the files. Worse, none allowed me to "look inside" an MP3 file, so the best way to see what was wrong with a file was to open it with a hex editor and try to see how some specifications mapped to the various pieces of the file. After a while I decided to give up on the tools I was experimenting with and write my own. The result is MP3 Diags.
</div>
<div class="NormalText RegFnt ChpCol2">
There are many programs that create and edit MP3 files, and many of them are broken. As a result, many MP3 files have various issues, ranging from values that are not standards-conforming but that are tolerated by all players and tools (so they look perfectly fine to the end user) to files that play correctly only on some players or even cause players and tools to crash. Many of the tools are quite tolerant of errors in an MP3 file, but some are less so. Also, there are reasons to change a file even if it technically doesn't have errors; for example you may want to add the picture from the album cover, or the lyrics.
</div>
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<div class="SubChapterText RegFnt ChpCol1">
<a name="screenshots">Screenshots</a>
</div>
<div class="NormalText RegFnt ChpCol1">
<a href="004_screenshot01.html"><img src="screenshot1_thumb.jpg" class="ImgNoBorder" align="middle" /></a> <img src="1pixel.png" class="ImgNoBorder" />
<a href="005_screenshot02.html"><img src="screenshot2_thumb.jpg" class="ImgNoBorder" align="middle" /></a> <img src="1pixel.png" class="ImgNoBorder" />
<a href="006_screenshot03.html"><img src="screenshot3_thumb.jpg" class="ImgNoBorder" align="middle" /></a>
</div>
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<div class="SubChapterText RegFnt ChpCol2">
What is MP3 Diags and what does it do?
</div>
<div class="NormalText RegFnt ChpCol2">
In a few words, MP3 Diags is a GUI-based application that allows end-users to identify issues with their MP3 files, fix some of the issues and make other changes, like adding track information. It also lets you "look inside" an MP3 file.
</div>
<div class="NormalText RegFnt ChpCol2">
Unlike some programs that are designed to deal with a single topic (like fixing VBR headers or adding cover art), MP3 Diags is a one stop solution that identifies more than 50 different issues in MP3 files and provides the means to fix many of them (well, not everything is fixable; you can't make a 64kbps file sound like a 256kbps one.)
</div>
<div class="NormalText RegFnt ChpCol2">
Some of the more important issues that are found:
<ul class="ListLev1">
<li> broken tags / headers / audio </li>
<li> duplicate tags / headers </li>
<li> incorrect placement of tags / headers (ID3V2, ID3V1, LAME, Xing, ...) </li>
<li> low quality audio </li>
<li> missing VBR header </li>
<li> missing track info / cover art </li>
<li> broken track info / cover art </li>
<li> missing normalization data </li>
<li> character encoding issues (for languages other than English) </li>
</ul>
</div>
<div class="NormalText RegFnt ChpCol2">
Some of the fixes and changes that MP3 Diags can do:
<ul class="ListLev1">
<li> Adding / fixing track info, including album cover; information can be retrieved from several sources: Internet, clipboard, file name, local files, and (obviously) keyboard </li>
<li> Correcting files that show incorrect song duration </li>
<li> Correcting files in which the player cannot seek correctly </li>
<li> Converting characters for non-English names </li>
<li> Adding composer name to the artist field, for players that don't handle the composer field </li>
<li> Renaming files based on their fields </li>
<li> Changing word case for track info </li>
</ul>
</div>
<div class="NormalText RegFnt ChpCol2">
<b>Intended target</b>: this program is not really meant for those who want to push a button and have everything fixed automatically, but rather for people who have some technical background, who are rather picky about what's in their MP3 files, and who are willing to spend some time to get them right. Automatic fixing of non-ID3V2 issues can be done using the <a href="140_main_window_tools.html">4th custom transformation list</a>, which is as close to "fix all" as MP3 Diags can get, but some may not be so happy with it. Automatic tagging is neither implemented nor planned.
</div>
<div class="SubChapterText RegFnt ChpCol1">
Reviews, opinions, mentions
</div>
<div class="NormalText RegFnt ChpCol1">
Some sites notified me that they reviewed the program (or, well, copied the home page and changed a few words here and there), but this list is mainly based on the web traffic they generated:
<ul class="ListLev1">
<li><a href="http://www.softpedia.com/reviews/linux/MP3-Diags-Review-124030.shtml">softpedia.com</a></li>
<li><a href="http://lifehacker.com/5342197/mp3-diags-scans-and-repairs-your-mp3-collection">lifehacker.com</a></li>
<li><a href="http://www.freewaregenius.com/2009/10/28/mp3-diags-diagnose-and-repair-your-mp3-audio-library/">freewaregenius.com</a></li>
<li><a href="http://www.geekissimo.com/2009/08/24/mp3-diags-ordiniamo-e-controlliamo-con-un-unico-software-la-nostra-raccolta-musicale/">geekissimo.com</a> (Italian)</li>
<li><a href="http://www.makeuseof.com/tag/scan-your-music-library-and-repair-track-information-with-mp3-diags/">makeuseof.com</a></li>
<li><a href="http://www.ghacks.net/2009/08/20/diagnose-your-mp3-collection-with-mp3-diag/">ghacks.net</a></li>
<li><a href="http://mp3-diags.findmysoft.com/">Short review and Quick Look Video at findmysoft.com</a></li>
<li><a href="http://www.doxaliber.it/di-tag-copertine-cover-art-e-quantaltro/1328">doxaliber.it</a> (Italian)</li>
<li><a href="http://www.aranzulla.it/riparare-file-mp3-danneggiati-8184.html">aranzulla.it</a> (Italian)</li>
<li><a href="http://mp3-diags.softonic.it/">softonic.it</a> (Italian)</li>
<li><a href="http://www.softsea.com/review/MP3-Diags.html">softsea.com</a></li>
<li><a href="http://www.designcontest.com/show/mp3diags-clicknet-fi">Michael Sirola's Finnish translation of the home page</a></li>
</ul>
(There seems to be a relatively large Italian following.)
</div>
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<!-- ========================================================================================================== -->
<div class="SubChapterText RegFnt WarnCol">
<span class="WarnCol"> WARNING</span>
</div>
<div class="WarnCol NormalText RegFnt">
<span class="WarnCol"> If you want to use those parts of MP3 Diags functionality that alter existing files, it is highly advisable to back up your files first, because there is a real chance of data loss. It can be caused by both user error and bugs in the program. </span>
</div>
<div class="WarnCol NormalText RegFnt">
<span class="WarnCol"> Now if you wonder just how big this chance is, I don't have any answer. As far as I know, there are no bugs that may cause data corruption, but there may be some that I don't know about. I didn't lose any data in my own files, but you'll have to try it for yourself. </span>
</div>
<div class="WarnCol NormalText RegFnt">
<span class="WarnCol"> I guess the biggest risk is in a mismatch between what you expect MP3 Diags to do and what it was designed to do. So reading the documentation could help. </span>
</div>
<div class="SubChapterText RegFnt ChpCol1">
Documentation
</div>
<div class="NormalText RegFnt ChpCol1">
<table border="0" cellpadding="0" cellspacing="0" class="NoBrdTableText RegFnt ChpCol1">
<tr> <td> <a href="010_getting_the_program.html"> Getting the program </a> </td> </tr>
<tr> <td> <a href="020_mp3_introduction.html"> MP3 introduction </a> </td> </tr>
<tr> <td> <a href="030_users_guide.html"> User's guide </a> </td> </tr>
<tr> <td>
<table border="0" cellpadding="0" cellspacing="0" class="NoBrdTableText RegFnt ChpCol1 SubtableSpace">
<tr> <td> <a href="035_suggested_usage.html">Suggested usage</a> </td> </tr>
<tr> <td> <a href="110_first_run.html">First run</a> </td> </tr>
<tr> <td> <a href="120_first_scan.html">Scanning MP3 files</a> </td> </tr>
<tr> <td> <a href="130_main_window.html">Main window</a> </td> </tr>
<tr> <td> <a href="140_main_window_tools.html">Main window - Tools</a> </td> </tr>
<tr> <td> <a href="145_transformations_list.html">Transformations - Details</a> </td> </tr>
<tr> <td> <a href="150_main_window_all_notes.html">Main window - All notes</a> </td> </tr>
<tr> <td> <a href="160_main_window_tag_details.html">Main window - Tag details</a> </td> </tr>
<tr> <td> <a href="170_note_filter.html">Note filter</a> </td> </tr>
<tr> <td> <a href="180_folder_filter.html">Folder filter</a> </td> </tr>
<tr> <td> <a href="190_tag_editor.html">Tag editor</a> </td> </tr>
<tr> <td> <a href="200_discogs_query.html">Querying Discogs or MusicBrainz</a> </td> </tr>
<tr> <td> <a href="210_tag_editor_assign_image.html">Tag editor - Assigning images</a> </td> </tr>
<tr> <td> <a href="220_tag_editor_patterns.html">Tag editor - Patterns</a> </td> </tr>
<tr> <td> <a href="230_normalize.html">Normalization</a> </td> </tr>
<tr> <td> <a href="240_file_renamer.html">File renamer</a> </td> </tr>
<tr> <td> <a href="250_config_files.html">Config - Files</a> </td> </tr>
<tr> <td> <a href="260_config_ignored_notes.html">Config - Ignored notes</a> </td> </tr>
<tr> <td> <a href="270_config_custom_transf.html">Config - Custom transformations</a> </td> </tr>
<tr> <td> <a href="290_config_transf_params.html">Config - Transformation parameters</a> </td> </tr>
<tr> <td> <a href="292_config_visible_transf.html">Config - Visible transformations</a> </td> </tr>
<tr> <td> <a href="295_config_quality.html">Config - Audio quality</a> </td> </tr>
<tr> <td> <a href="297_config_colors.html">Config - Colors</a> </td> </tr>
<tr> <td> <a href="298_config_shell.html">Config - Shell integration</a> </td> </tr>
<tr> <td> <a href="299_ext_tools.html">Config - External tools</a> </td> </tr>
<tr> <td> <a href="300_config_others.html">Config - Others</a> </td> </tr>
<tr> <td> <a href="310_advanced.html">Advanced features</a> </td> </tr>
</table>
</td> </tr>
<tr> <td> <a href="040_limitations.html"> Limitations </a> </td> </tr>
<tr> <td> <a href="050_feedback.html"> Feedback and support </a> </td> </tr>
<tr> <td> <a href="060_notes_for_programmers.html"> Notes for programmers </a> </td> </tr>
<tr> <td> <a href="070_miscellaneous.html"> Miscellaneous </a> </td> </tr>
<tr> <td> <a href="008_licence.html"> Licence and acknowledgements </a> </td> </tr>
</table>
</div>
<div class="FreeNormalText RegFnt ChpCol2">
I'd appreciate <a href="050_feedback.html">feedback</a> about your experience with MP3 Diags (things like if it compiles or not, if it crashes, if it corrupts files, if you'd like a binary available for some platform, parts that you like or dislike, new features ... )<br/>
</div>
<div class="FreeNormalText RegFnt ChpCol2">
Ciobi
</div>
<!--
<span class="NormalText RegFnt ChpCol2" style="padding-left:30px"></span>
<br/>
<script src="http://digg.com/tools/diggthis.js" type="text/javascript"></script> </td>
class="NavTable"
-->
<!--
<div class="FreeNormalText RegFnt ChpCol1">
<table border="1" cellpadding="1" cellspacing="5" >
<tr>
<td align="left">
<script type="text/javascript">
digg_url = 'http://mp3diags.sourceforge.net/';
</script>
<script src="http://digg.com/tools/diggthis.js" type="text/javascript"> </script>
</td>
<td align="left" valign="top">
<table border="1" cellpadding="1" cellspacing="1" >
<tr valign="top">
<td align="left">
<a href="http://www.stumbleupon.com/submit?url=http://mp3diags.sourceforge.net/"> <img border="0" src="http://cdn.stumble-upon.com/images/120x20_su_black.gif" alt="" align="absmiddle" /></a>
</td>
</tr>
<tr valign="bottom">
<td align="left">
<img src="http://static.delicious.com/img/delicious.small.gif" height="10" width="10" alt="Delicious" />
<a href="http://delicious.com/save" onclick="window.open('http://delicious.com/save?v=5&noui&jump=close&url='+encodeURIComponent(location.href)+'&title='+encodeURIComponent(document.title), 'delicious','toolbar=no,width=550,height=550'); return false;"> Bookmark this on Delicious</a>
</td>
</tr>
<tr valign="bottom">
<td align="left">
< !- - AddThis Button BEGIN - - >
<a class="addthis_button" href="http://www.addthis.com/bookmark.php?v=250&pub=xa-4a8e66ee1f75de1f"><img src="http://s7.addthis.com/static/btn/v2/lg-share-en.gif" width="125" height="16" alt="Bookmark and Share" style="border:0"/></a><script type="text/javascript" src="http://s7.addthis.com/js/250/addthis_widget.js?pub=xa-4a8e66ee1f75de1f"></script>
< !- - AddThis Button END - - >
</td>
</tr>
</table>
</td>
</tr>
</table>
</div>
-->
<!-- AddThis Button BEGIN -->
<!--
<a class="addthis_button" href="http://www.addthis.com/bookmark.php?v=250" addthis:url="http://mp3diags.sourceforge.net/" addthis:title="MP3 Diags">
<img src="http://s7.addthis.com/static/btn/v2/lg-share-en.gif" width="125" height="16" alt="Bookmark and Share" style="border:0"/>
</a>
<script type="text/javascript" src="http://s7.addthis.com/js/250/addthis_widget.js"></script>
-->
<!-- AddThis Button END -->
<div class="NavPadTable RegFnt ChpCol1">
<div style="width:100%">
<table border="0" cellpadding="0" cellspacing="0" width="100%" class="NavTable">
<tr>
<td width="30%" align="left"> </td>
<td width="40%" align="center" valign="middle" class="NavBarText"> MP3 Diags </td>
<td width="30%" align="right"> <a href="010_getting_the_program.html"> Getting the program</a> <a href="010_getting_the_program.html"> <img src="arrow_right_small.png" class="ImgNoBorder NavPadRight" align="absmiddle" /> </a> </td>
</tr>
</table>
</div>
</div>
<!--QQQStatCounterQQQ-->
</body>
</html>
|
