PowerShell/docs/play-mp3.md
2024-03-27 17:36:59 +01:00

95 lines
2.3 KiB
Markdown

Script: *play-mp3.ps1*
========================
This PowerShell script plays a sound file in .MP3 file format.
Parameters
----------
```powershell
PS> ./play-mp3.ps1 [[-Path] <String>] [<CommonParameters>]
-Path <String>
Specifies the path to the .MP3 file
Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
Example
-------
```powershell
PS> ./play-mp3 C:\thunder.mp3
```
Notes
-----
Author: Markus Fleschutz | License: CC0
Related Links
-------------
https://github.com/fleschutz/PowerShell
Script Content
--------------
```powershell
<#
.SYNOPSIS
Plays a MP3 sound file
.DESCRIPTION
This PowerShell script plays a sound file in .MP3 file format.
.PARAMETER Path
Specifies the path to the .MP3 file
.EXAMPLE
PS> ./play-mp3 C:\thunder.mp3
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
param([string]$Path = "")
try {
if ($Path -eq "" ) { $Path = Read-Host "Enter the path to the MP3 sound file" }
if (-not(Test-Path "$Path" -pathType leaf)) { throw "Can't access sound file: $Path" }
$FullPath = (Get-ChildItem $Path).fullname
$Filename = (Get-Item "$FullPath").name
Add-Type -assemblyName PresentationCore
$MediaPlayer = New-Object System.Windows.Media.MediaPlayer
do {
$MediaPlayer.open($FullPath)
$Milliseconds = $MediaPlayer.NaturalDuration.TimeSpan.TotalMilliseconds
} until ($Milliseconds)
[int]$Minutes = $Milliseconds / 60000
[int]$Seconds = ($Milliseconds / 1000) % 60
"▶️ Playing $Filename for $($Minutes.ToString('00')):$($Seconds.ToString('00')) sec..."
$PreviousTitle = $host.ui.RawUI.WindowTitle
$host.ui.RawUI.WindowTitle = "▶️ $Filename"
$MediaPlayer.Volume = 1
$MediaPlayer.play()
Start-Sleep -milliseconds $Milliseconds
$MediaPlayer.stop()
$MediaPlayer.close()
$host.ui.RawUI.WindowTitle = $PreviousTitle
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
```
*(generated by convert-ps2md.ps1 using the comment-based help of play-mp3.ps1 as of 03/27/2024 17:36:31)*