1. Walton Hoops
  2. cl-taglib


Walton Hoops  committed c19ce08


  • Participants
  • Parent commits e4e7b16
  • Branches master

Comments (0)

Files changed (1)

File README.md

View file
  • Ignore whitespace
     (with-tag-file (file "turtles.mp3")
            (let ((tag (file-tag file)))
              (setf (tag-comment tag) "turtles all the way down")
-             (file-save file)))
+             (file-save file)))
+## API
+(*file-new* pathname) Takes a pathname or a string and returns the tagfile.  The the tagfile MUST be freed manually, use *with-open-tagfile* instead
+(*file-free* tagfile) Frees the provided tagfile, returns nil.
+(*file-save* tagfile) Saves any changes to the files tags.  Returns T on success, nil on failure.
+(*with-tag-file* (var-name pathname) &body) Opens the file, runs &body and closes it, similar to with-open-file.  The file is NOT automatically saved.
+### Working with tags
+(*file-tag* tagfile) Returns the tag structure associated with the file.  Will be automatically be freed along with the file.
+(*tag-<property>* tag) Returns the given property.  All tag operations are setf-able.  Available accessors are (title album artist genre comment track year)
+### Reading audio information
+(*file-audioproperties* file) returns the audio properties for the given file
+(*audio-<property>* audio) Returns the given property as an integer.  Properties are (length bitrate samplerate channels).  Audio properties are NOT setf-able.