blob: d813998b41b844a7287931f4baa659a133aa2292 [file] [log] [blame]
General Information
id3lib is a software library for manipulating ID3v1/v1.1 and ID3v2 tags.
id3lib 3.0.x conforms to all ID3v2 standards up to and including the ID3v2.3.0
informal standard.
The id3lib project makes use of the resources available through Using SourceForge, the id3lib project is able to provide
several tools for developers, including a project homepage, a mailing list, a
patch manager, bug tracking, and cvs access, among other things.
The id3lib project page, which includes links to all of the above, is:
The official id3lib homepage is:
The id3lib developers' mailing list's address is:
You can subscribe, unsubscribe, and view mailing list archives at:
Information about ID3v2 and related standards can be found at:
See the file 'INSTALL'
In order to successfully compile and use id3lib, the following programs and
libraries are needed:
g++ 2.8/egcs 1.0.3 (or compatible)
GNU make
autoconf 2.13
automake 1.4
doxygen (optional, for creating documentation)
How to report bugs
To report a bug, submit it to the bug tracker, linked to from the id3lib
project page, or send mail to the id3lib-devel mailing list.
If you send it to the mailing list, please include the following:
* The version of id3lib
* Information about your system. For instance:
- What operating system and version
- For Linux, what version of the C library
And anything else you think is relevant.
* How to reproduce the bug.
Please include either a short test program that exhibits the
behavior or an example tag that isn't correctly parsed/rendered by
the library. As a last resort, you can also provide a pointer to
a larger piece of software or tagged file that can be downloaded.
* If the bug was a crash, the exact text that was printed out
when the crash occured.
* Further information such as stack traces may be useful, but
is not necessary.
Patches can be submitted to the patch manager at the id3lib project page, as
mentioned above. Please follow the instructions there. So as not to annoy
uniterested parties with large email messages, it is preferable that you not
send such patches to the mailing list.
For Further Reading
id3lib is free software. Please see the COPYING file for details.
For documentation, please see the files in the doc subdirectory.
See the HISTORY file for information about development up to version 3.05a.
See the NEWS file for information about development since 3.05a.
See the ChangeLog file for an account of changes made to files in the library.
See the AUTHORS and THANKS files to see who has contributed to id3lib.