https://github.com/praj-foss/coucal
A Clojure library for parsing ID3 tags from MP3 files
https://github.com/praj-foss/coucal
clojure clojure-library id3v2 mp3-tags
Last synced: 3 months ago
JSON representation
A Clojure library for parsing ID3 tags from MP3 files
- Host: GitHub
- URL: https://github.com/praj-foss/coucal
- Owner: praj-foss
- License: mit
- Created: 2019-12-09T17:56:17.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-19T16:54:18.000Z (over 5 years ago)
- Last Synced: 2025-01-17T08:35:52.439Z (4 months ago)
- Topics: clojure, clojure-library, id3v2, mp3-tags
- Language: Clojure
- Homepage:
- Size: 24.4 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
coucal
======
A Clojure library for parsing ID3 tags from MP3 files.
It only supports ID3v2.3 tags currently, which is also the
most popular version as of writing this. Support for other
versions will be coming soon.
It's a fun project created while I was learning Clojure.
A lot more features have been planned including support
for writing out tags. Feel free to submit an issue or a
PR if you feel like it.
:relaxed:
### Examples
```clojure
;; First
(require '[coucal.core :as cou]
'[clojure.java.io :as io])
;; Read from MP3
(with-open [mp3 (io/input-stream "The Calling.mp3")]
(cou/read-tag mp3))
=>
{:version "2.3.0",
:size 4342,
:frames {:genre "(17)Rock",
:track-num "7",
:publisher "Exzel Music Co.",
:composers ["Rick Costello"],
:band "Angelwing",
:title "The Calling [Nymph Mix]",
:year 2001,
:length 199866,
:artists ["Angelwing"],
:album "The Nymphaeum"}}
```
## License
This project is licensed under the MIT License.
Please see the [LICENSE](LICENSE) file for more information.