Audio-Play-Native

SYNOPSIS

    use Audio::Play::Native;

    # Asynchronous non-blocking playback
    Audio::Play::Native->play('explosion.wav');

    # Synchronous blocking playback
    Audio::Play::Native->play('intro.wav', async => 0);

    # Query active backend
    print "Using backend: " . Audio::Play::Native->detected_backend . "\n";
    
DESCRIPTION

Audio::Play::Native provides cross-platform audio playback for Perl. It does this by attempting to find and use available audio player tools to play the specified WAV file.

Linux:

Will try to use PipeWire (pw-play), PulseAudio (paplay), ALSA (aplay), SoX (play), and FFplay (ffplay).

Windows:

Will try to use Win32::Sound and PowerShell.

macOS:

Will try to use afplay.

AI

This module was developed with assistance from Gemini Flash 3.8.

INSTALLATION

To install this module, run the following commands:

	perl Makefile.PL
	make
	make test
	make install

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc Audio::Play::Native

You can also look for information at:

    RT, CPAN's request tracker (report bugs here)
        https://rt.cpan.org/NoAuth/Bugs.html?Dist=Audio-Play-Native

    Search CPAN
        https://metacpan.org/release/Audio-Play-Native


LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by Matt Johnson <mjohnson@affectivesilicon.com>.

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007

