Description

A library for playing and controlling sounds on MS Windows.

Prerequisites

* ffi
* test-unit 2 (Development only)

Installation

gem install win32-sound

Synopsis

require 'win32/sound'
include Win32
# Play a wav file
Sound.play("somefile.wav")
# Play a system sound
Sound.play("SystemAsterisk",Sound::ALIAS)
# Get the current volume of the waveform-audio output device.
p Sound.volume.join(", ") # left channel, right channel

Acknowledgements

API ideas derived (or not) from Perl's Win32::Sound module and Python's
winsound package.

Known Bugs

None that I'm aware of. Please report any bugs on the project page
at https://github.com/djberg96/win32-sound.

Future Plans

Add ability to retrieve information about WAV files.
Add MIDI support?

Developer’s Notes

The MessageBeep() function, which the Python "winsound" module contains,
is intentionally omitted here. I felt it was redundant, because you can
achieve the same effect with something like this:
  Sound.play("SystemAsterisk", Sound::ALIAS).

License

Artistic 2.0

Copyright

(C) 2004-2017, Daniel J. Berger, All Rights Reserved

Warranty

This package is provided "as is" and without any express or
implied warranties, including, without limitation, the implied
warranties of merchantability and fitness for a particular purpose.

Author(s)

Daniel Berger
Park Heesob
Dominic Muller