⬥ ID3 encoding/decoding library in Go ⬥
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

95 lines
1.3 KiB

# ID3ED (ID3 - Encoder - Decoder)
## Library for encoding/decoding ID3 tags
---
# Under construction !
---
# Installation
```
go get github.com/Unbewohnte/id3ed
```
---
# Usage
## Decoding ID3v1.1
```
package main
import(
"fmt"
"github.com/Unbewohnte/id3ed"
)
func main() {
mp3file, err := os.Open("/path/to/mp3/myMP3.mp3")
if err != nil {
panic(err)
}
// extract ID3v1.1 tags
mp3tags, err := GetID3v11Tags(mp3file)
if err != nil {
panic(err)
}
// print all tags
fmt.Printf("%+v",mp3tags)
songname := mp3tags.SongName
genre := mp3tags.Genre
// etc.
}
```
## Encoding ID3v1.1
```
f, err := os.OpenFile("/path/to/file/myfile.mp3",os.O_WRONLY, os.ModePerm)
if err != nil {
panic(err)
}
defer f.Close()
// create your tags struct
tags := &ID3v11Tags{
SongName: "mysong",
Artist: "me",
Album: "my album",
Year: 2021,
Comment: "Cool song",
Track: 1,
Genre: "Christian Gangsta Rap", // list of genres see "id3v1genres.go"
}
3 years ago
// write tags to file
err = tags.WriteToFile(f)
if err != nil {
panic(err)
}
```
---
# Testing
```
go test
```
or
```
go test -v
```
to get a verbose output
3 years ago
---
# License
[MIT LICENSE](https://github.com/Unbewohnte/id3ed/blob/main/LICENSE)