Functions/GenXdev.Media/Start-VlcMediaPlayerNextInPlaylist.ps1
|
################################################################################ <# .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. .LICENSE Copyright (C) 2026 René Vaessen / GenXdev This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. .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\Open-VlcMediaPlayer -KeysToSend 'n' -RestoreFocus Microsoft.PowerShell.Utility\Write-Verbose ` 'Successfully sent next command to VLC Media Player' } } end { } } ################################################################################ |