WaveFile Gem

• Read/Write Common Formats

  • PCM Integer – 8, 16, 24, or 32 bits per sample
  • PCM Float – 32 or 64 bits per sample
  • Any number of channels

• Seamless Conversions

  Convert back and forth between any format the gem supports. Read from an 8-bit mono file as if it were 16-bit stereo. Generate floating point samples, but write them as 16-bit integers.

• Query Metadata

  Get the sample format, sample rate, number of channels, number of sample frames, etc. from a Wave file, even if the samples are in a format this gem can’t read or write.

• Easy to Install

  Written in pure Ruby, so there’s no need to compile a separate extension in order to use it.

require "wavefile"
include WaveFile    # To avoid prefixing classes with "WaveFile::"

FILES_TO_APPEND = ["one.wav", "two.wav", "three.wav"]
OUTPUT_FORMAT = Format.new(:stereo, :pcm_16, 44100)

Writer.new("one_two_three.wav", OUTPUT_FORMAT) do |writer|
  FILES_TO_APPEND.each do |file_name|
    Reader.new(file_name).each_buffer do |buffer|
      writer.write(buffer)
    end
  end
end

Installation

First, install the WaveFile gem from rubygems.org:

gem install wavefile

…and include it in your Ruby program:

require "wavefile"

…or Gemfile:

gem "wavefile"

The WaveFile gem requires Ruby 2.0 or greater.

Note: It’s recommended that you use a Ruby version manager such as rbenv. But if using the system Ruby that comes pre-installed on macOS, you should used sudo gem install wavefile. Otherwise you might run into a file permission error.