Skip to content
/ id3rw Public

PHP-Library for reading and writing ID3 tags.

License

Notifications You must be signed in to change notification settings

rhorber/id3rw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ID3rw

PHP-Library for reading and writing ID3 tags.

ℹ The Library supports versions 2.3.0 and 2.4.0.

ℹ The library is in early development stage, but if possible the current API (public methods) will not change.

⚠ As I have limited time to work on this library it progresses slowly. If you have any suggestions or questions, or you need a feature, feel free to file an issue.

This project adheres to Semantic Versioning.

Example

// Read frames from file.
$reader = new \Rhorber\ID3rw\Reader('/home/user/myfile.mp3');
$frames = $reader->getFrames();
print_r($frames);

// Change title.
$frames['TIT2']['information'] = '2018-10-21_'.$frames['TIT2']['information'];

// Write a new file (with modified title).
$writer = new \Rhorber\ID3rw\Writer();
$writer->writeNewFile($frames, '/home/user/mynewfile.mp3', '/home/user/myfile.mp3');

License

License

This project is licensed under the MIT License - see the LICENSE file for details

TODO

Features I will add:

  • Add functionality to Reader to return the frames as objects.
  • Write tests for the Writer.
  • Add more writing variants and expand their docs.
  • Improve parsing of non-text frames.
  • Return detailed info about frames (not only technical name).
  • Improve readme.
  • Eventually support more versions (2.3.0 and 2.4.0 are the most common ones).
  • Add names and/or descriptions to the frames.
  • Add the lists of frames (TCON, TFLT, TMED (TKEY), ETCO, APIC)
  • Add notices when displaying TCOP and TPRO

About/History

I needed a library for modifying some ID3 tags. I did not find any library for doing that (getid3 was not able to write correctly), so I started writing my own in plain PHP.

Version 2.3.0

The following frames can be parsed the same way is in version 2.4.0

  • ETCO
  • MCDI
  • TXXX
  • UFID
  • URL link frames (W000 - WZZZ)
  • WXXX

About

PHP-Library for reading and writing ID3 tags.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages