guitar-riff: A library for reading RIFF format files

Based on the description of the format at: https://johnloomis.org/cpe102/asgn/asgn1/riff.html

Purpose

Whilst this library can be used to read RIFF files, there are more mature alternatives out there (such as simply riff).

This was originally written in a few hours as a simple practice project to get to grips with rust.

Limitations

guitar-riff only supports 32-bit RIFF files. It does not support 64-bit extensions to the format (i.e. DS64).

riff-info currently does not report the correct size for LIST chunks.

riff-info

riff-info is a small utility which outputs IDs and sizes for all chunks in a file to demonstrate the library. It accepts one argument, which is a path to a file containing a RIFF container. Output is similar to the chunks.exe utility (but not identical).

You can run this using cargo from the riff-info/ directory:

cd ./riff-info/
cargo run ../1sec.wav

RIFF  353140
  code: WAVE
  fmt   16
  data  352800
  LIST  134
    code: INFO
    INAM  12
    IPRD  6
    IART  6
    ICMT  22
    ICRD  6
    IGNR  12
    ITRK  10
  id3   154

Possible improvements

• Ability to modify/add chunks and then save them. Allows writing files.
• Ability to quickly enumerate all top-level chunks in a file, without reading all their data into memory. For fast cataloguing purposes.
• Tests for reading chunks within LIST chunks. I got lazy and didn't want to write these.