Functions/GenXdev.Console.Vlc/Start-VlcMediaPlayerNextInPlaylist.ps1
|
<##############################################################################
Part of PowerShell module : GenXdev.Console.Vlc Original cmdlet filename : Start-VlcMediaPlayerNextInPlaylist.ps1 Original author : René Vaessen / GenXdev Version : 1.300.2025 ################################################################################ Copyright (c) René Vaessen / GenXdev Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. ################################################################################> ################################################################################ <# .SYNOPSIS Advances VLC Media Player to the next item in the current playlist. .DESCRIPTION This function sends the 'n' keystroke to VLC Media Player to skip to the next track or media item in the currently loaded playlist. It focuses the VLC window, sends the next command, and restores focus to the PowerShell console. The function includes ShouldProcess support for confirmation prompts when needed. .EXAMPLE Start-VlcMediaPlayerNextInPlaylist .EXAMPLE vlcnext #> function Start-VlcMediaPlayerNextInPlaylist { [CmdletBinding(SupportsShouldProcess)] [Alias('vlcnext')] param( ) begin { # check if shouldprocess is enabled and user wants to proceed Microsoft.PowerShell.Utility\Write-Verbose ` 'Preparing to advance VLC Media Player to next playlist item' } process { # verify user confirmation before sending next command to vlc if ($PSCmdlet.ShouldProcess('VLC Media Player', 'Next in playlist')) { Microsoft.PowerShell.Utility\Write-Verbose ` 'Sending next command to VLC Media Player' # send the 'n' key to vlc to advance to next playlist item # restore focus ensures powershell regains control after command GenXdev.Console\Open-VlcMediaPlayer -KeysToSend 'n' -RestoreFocus Microsoft.PowerShell.Utility\Write-Verbose ` 'Successfully sent next command to VLC Media Player' } } end { } } ################################################################################ |