PowerShell/Docs/play-mp3.md
2022-11-18 17:02:20 +01:00

89 lines
2.3 KiB
Markdown

## The *play-mp3.ps1* PowerShell Script
This PowerShell script plays a sound file in .MP3 file format.
## Parameters
```powershell
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
## Source Code
```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*