A cross-platform, multi-format audio conversion and tagging suite for .NET and PowerShell. Formats currently supported are MP3, MP4 AAC, FLAC, Apple Lossless (ALAC), Opus, Ogg Vorbis and Wave.
A full user interface (Windows only) is in development.
This project supplants PowerShell Audio by targetting both Windows PowerShell and PowerShell Core (Windows, Linux and MacOS).
Platform | Build Status (master) | Build Status (dev) | Deployment Status |
---|---|---|---|
Windows | |||
Linux | |||
MacOS |
System Requirements
AudioWorks runs on Windows 7+, MacOS 10.13+, and Ubuntu 16.04+. Other 64-bit Linux distributions may work, but may require additional dependencies and are currently untested. Currently, most extensions only support the x86 architecture.
On Windows:
- PowerShell Core 6.2+ (recommended) and/or Windows PowerShell 5.1
- .NET Framework 4.6.2+ (if using Windows PowerShell)
- iTunes (optional, for AAC and ALAC support. Requires the classic installer, not the Windows Store version. Technically only the Apple Application support packages are required)
On Ubuntu 20.04 or 18.04:
- Via
apt-get install
:- libebur128-1
On Ubuntu 18.04:
- Via
apt-get install
:- libebur128-1
On Ubuntu 16.04:
- Via
apt-get install
:- libmp3lame0
- libebur128-1
Installation
The AudioWorks PowerShell module can found on the PowerShell Gallery. If you are using Windows PowerShell 5.1, you may need to update PowerShellGet to a version that supports pre-release modules.
Keep the module up to date with Update-Module -Name AudioWorks.Commands -AllowPrerelease
.
The .NET API is available via NuGet.
Additional Requirements for Building / Testing
- .NET Core SDK 2.1
- .NET Core SDK 3.1
- PowerShell Core 6.1+ (recommended) and/or Windows PowerShell 5.1.
- Windows 7+, MacOS 10.13+, Ubuntu 16.04, 18.04 or 20.04.
- Visual Studio 2019 16.4 (optional - Windows only)
- Visual Studio 2019 for Mac 8.4+ (optional - Mac only)
- Visual Studio Code (optional - all platforms)
- ReSharper 2019.3+ (optional - Windows only)
Special Thanks
This project wouldn't be possible without the work of these other fine projects and organizations:
- Hydrogen Audio Forums, a wonderful, scientifically-minded community of digital audio enthusiasts.
- The LAME Project, maintainers of the high-quality MP3 encoder.
- The Xiph.Org Foundation, maintainers of Ogg Vorbis and FLAC (the Free Lossless Audio Codec).
- libebur128, a library implementing the EBU R.128 loudness standard.
- QAAC, a command-line front-end for Apple's AAC and Apple Lossless encoders.