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, and so forth from a Wave file, even if it’s 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.

For Example

Let’s say you have these three Wave files:

one.wav :
two.wav :
three.wav :

The program below will concatenate them into one file:

one_two_three.wav :

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

Intrigued? Check out more examples.

Or, check out the Getting Started guide for a tutorial.

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"

Note: It’s recommended that you use a Ruby version manager such as rvm or 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.

WaveFile Gem

Read/Write Common Formats

Seamless Conversions

Query Metadata

Easy to Install

For Example

Installation