Notices: This section not yet converted to new layout. Download stats are rolling back out.

Universal Pause Button

1.0.3

Package test results are passing.

Private CDN cached downloads available for licensed customers. Never experience 404 breakages again! Learn more...

This package was approved by moderator ferventcoder on 12/28/2015.

I like to play video games. I also have a significant other, and she often walks into the room to talk to me while I'm playing a video game. I would like to pause the game so that I can give her my undivided attention while she's talking to me, but a lot of games (particularly single-player ones) have these "un-pausable" cut scenes or other areas of the game where the normal pause functionality doesn't work. This annoys both me and her, because I'm supposed to be the computer expert, and it looks like I don't even know how to pause my stupid video game. So usually what ends up happening is I skip the cut scene and miss the story, or upset my SO by not paying attention to her as well as I should.

So that is why I wrote Universal Pause Button. It's a very simple Windows desktop app that sits in the system tray. Its icon resembles a pause button. When you hit the actual Pause key (also known as Break) on your keyboard, the program determines which window is currently in the foreground (i.e. your game's window,) and pauses it. No matter where you are in the game. Even in the middle of one of those pesky cut scenes that would otherwise be un-pausable. When you press the key again (as long as you haven't since re-focused to another window,) the game will un-pause.

As of v1.0.3 you can now customize the "Pause" key that you want to use. Read the settings.txt file. The program reads the custom pause key from the settings.txt file during startup.

I've currently been testing this with The Witcher 3, and it is working great. However, your mileage may vary. "Pausing" processes is something that usually only debuggers do, and I can't predict how your game will react to it. Pausing processes may lead to race conditions among the threads of that process, but like I said, testing has been very positive for me so far. I've already gotten great value out of the program, as there are lots of cut scenes in The Witcher 3, that I don't want to skip. The main use case for this app is single player games, as pausing your multi-player game will undoubtedly just get you kicked from the session, as if your computer had just crashed or hung. So don't use it in multi-player games. It also works on applications that are not games at all.

To install Universal Pause Button, run the following command from the command line or from PowerShell:

C:\> choco install universalpausebutton

To upgrade Universal Pause Button, run the following command from the command line or from PowerShell:

C:\> choco upgrade universalpausebutton

Files

Hide
  • tools\bins.ps1 Show
    <#
      .SYNOPSIS
    
      Create a .ignore file for a package binary.
    
      .DESCRIPTION
    
      Chocolatey automatically creates a "shim" in a special folder, on your
      machine's PATH, for any executables found in the package's installation
      directory. This is helpful when installing ZIP packages or any kind of
      command line tools.
    
      Chocolatey can be instructed to ignore a particular binary by creating a file
      at the same path with the same name as the binary to ignore, except ending
      with the file extension ".ignore".
    
      This function creates that file, given the binary's path.
    
      .PARAMETER Path
    
      The path of the binary to ignore.
    
      This parameter also accepts multiple paths or pipeline input.
    
      .EXAMPLE
    
      New-IgnoreBin -Path "foo.exe"
    
      .EXAMPLE
    
      New-IgnoreBin -Path $foo, $bar
    
      .EXAMPLE
    
      Get-ChildItem "$content\foo\*.exe" | New-IgnoreBin
    
      .LINK
    
      https://github.com/AnthonyMastrean/chocolateypackages/blob/master/helpers/bins.ps1
    #>
    function New-IgnoreBin {
      [CmdletBinding()]
      param(
        [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
        [ValidateNotNullOrEmpty()]
        [ValidateScript({ Test-Path $_ })]
        [string[]] $Path
      )
    
      PROCESS {
        foreach($item in $Path) {
          New-Item "$(Resolve-Path $item).ignore" -Type "File" -Force | Out-Null
        }
      }
    }
    
    <#
      .SYNOPSIS
    
      Create a .gui file for a package binary.
    
      .DESCRIPTION
    
      Chocolatey automatically creates a "shim" in a special folder, on your
      machine's PATH, for any executables found in the package's installation
      directory. This is helpful when installing ZIP packages or any kind of
      command line tools.
    
      Chocolatey can be instructed to treat a particular binary as a GUI application,
      meaning it will START the binary in a separate process and not block the
      console, by creating a file at the same path with the same name as the binary,
      except ending with the file extension ".gui".
    
      This function creates that file, given the binary's path.
    
      .PARAMETER Path
    
      The path of the binary to treat as a GUI application.
    
      This parameter also accepts multiple paths or pipeline input.
    
      .EXAMPLE
    
      New-GuiBin -Path "foo.exe"
    
      .EXAMPLE
    
      New-GuiBin -Path $foo, $bar
    
      .EXAMPLE
    
      Get-ChildItem "$content\foo\*.exe" | New-GuiBin
    
      .LINK
    
      https://github.com/AnthonyMastrean/chocolateypackages/blob/master/helpers/bins.ps1
    #>
    function New-GuiBin {
      [CmdletBinding()]
      param(
        [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
        [ValidateNotNullOrEmpty()]
        [ValidateScript({ Test-Path $_ })]
        [string[]] $Path
      )
    
      PROCESS {
        foreach($item in $Path) {
          New-Item "$(Resolve-Path $item).gui" -Type "File" -Force | Out-Null
        }
      }
    }
    
  • tools\chocolateyInstall.ps1 Show
    $id   = "universalpausebutton"
    $name = "Universal Pause Button"
    $url  = "https://github.com/ryanries/UniversalPauseButton/releases/download/v1.0.3/UniversalPauseButton.zip"
    
    $tools   = Split-Path $MyInvocation.MyCommand.Definition
    $content = Join-Path (Split-Path $tools) "content"
    $pause32 = Join-Path $content "UniversalPauseButton\UniversalPauseButton_x86.exe"
    $pause64 = Join-Path $content "UniversalPauseButton\UniversalPauseButton_x64.exe"
    $pause   = @{32=$pause32;64=$pause64}[(Get-ProcessorBits)]
    
    . $tools\bins.ps1
    . $tools\shortcut.ps1
    
    Install-ChocolateyZipPackage -PackageName $id -Url $url -UnzipLocation $content
    
    New-IgnoreBin -Path $pause32
    New-IgnoreBin -Path $pause64
    
    New-Shortcut -Link $name -Target $pause -SpecialFolder "CommonPrograms"
    New-Shortcut -Link $name -Target $pause -SpecialFolder "CommonStartup"
    
  • tools\chocolateyUninstall.ps1 Show
    $id   = "universalpausebutton"
    $name = "Universal Pause Button"
    
    $tools   = Split-Path $MyInvocation.MyCommand.Definition
    
    . $tools\shortcut.ps1
    
    Remove-Shortcut -Link $name -SpecialFolder "CommonPrograms"
    Remove-Shortcut -Link $name -SpecialFolder "CommonStartup"
    
  • tools\shortcut.ps1 Show
    <#
      .SYNOPSIS
    
      New-Shortcut creates a new shortcut to a file or program.
    
      .DESCRIPTION
    
      New-Shortcut wraps the COM Object, Wscript.Shell, and its arguments to create
      a shortcut to a file or program. It requires some very specific input, please
      review the notes on each parameter.
    
      .PARAMETER Link
    
      The shortcut to create.
    
      The underlying COM Object requires an absolute path. This function will
      attempt to properly expand that path, especially if you provide a
      SpecialFolder as a root directory.
    
      The underlying COM Object also requires that the link's path/name end in
      either .lnk or .url. This function will attempt to add that file extension if
      it is not provided.
    
      The underlying COM Object will fail silently in many cases, especially due to
      improperly formatted link paths. This function will test the existence of the
      expected link using this parameter and fail if it is not found.
    
      .PARAMETER Target
    
      The target of the shortcut.
    
      This path must exist. This function will attempt to expand the path to its
      absolute value.
    
      .PARAMETER SpecialFolder
    
      The Windows special folder to contain this shortcut.
    
      If you want to create a shortcut at one of the system managed paths, such as
      the Desktop or the Start Menu, you should use the special tokens provided.
      The most commonly used are
    
        * CommonDesktop
        * CommonStartup
        * CommonPrograms
    
      If you provide a special folder, the Link parameter may contain a simple
      "name" and not a file path.
    
      The full list of special folders can be found here:
    
      https://msdn.microsoft.com/en-us/library/system.environment.specialfolder(v=vs.110).aspx
    
      .PARAMETER Icon
    
      The icon of the shortcut.
    
      This can take several forms and, due to this, is not validated carefully. You
      can provide an absolute file path (this is your responsibility), like
    
        "C:\Windows\notepad.exe"
    
      Or, you can provide an absolute file path and an index into the resources of
      that program, like
    
        "C:\Windows\notepad.exe, 1"
    
      .PARAMETER Description
    
      The tooltip to display on the shortcut.
    
      .EXAMPLE
    
      New-Shortcut -Link "foo" -Target "foo.exe" -SpecialFolder "CommonDesktop" -Description "The Foo program"
    
      .EXAMPLE
    
      Remove-Shortcut -Link "foo" -SpecialFolder "CommonDesktop"
    
      .LINK
    
      https://github.com/AnthonyMastrean/chocolateypackages/blob/master/helpers/shortcut.ps1
    #>
    function New-Shortcut {
      [CmdletBinding()]
      param(
        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [string] $Link,
    
        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [ValidateScript({ Test-Path $_ })]
        [string] $Target,
    
        [string] $SpecialFolder,
        [string] $Icon,
        [string] $Description
      )
    
      $Link = Resolve-ShortcutLink -Link $Link -SpecialFolder $SpecialFolder
    
      $shell = New-Object -ComObject 'Wscript.Shell'
    
      $shortcut = $shell.CreateShortcut($Link)
      $shortcut.TargetPath = (Resolve-Path $Target)
      $shortcut.WorkingDirectory = (Split-Path (Resolve-Path $Target))
    
      if($Icon) {
        $shortcut.IconLocation = $Icon
      }
    
      if($Description) {
        $shortcut.Description = $Description
      }
    
      $shortcut.Save()
    
      if(-not(Test-Path $Link)) {
        throw "Failed to create shortcut: $Link"
      }
    }
    
    function Remove-Shortcut {
      [CmdletBinding()]
      param(
        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [string] $Link,
    
        [string] $SpecialFolder
      )
    
      $Link = Resolve-ShortcutLink -Link $Link -SpecialFolder $SpecialFolder
    
      Remove-Item $Link -Force | Out-Null
    }
    
    function Resolve-ShortcutLink {
      param(
        [Parameter(Mandatory = $true)]
        [ValidateNotNullOrEmpty()]
        [string] $Link,
    
        [string] $SpecialFolder
      )
    
      if(-not($Link.ToLower().EndsWith('.lnk') -or $Link.ToLower().EndsWith('.url'))) {
        $Link = "$Link.lnk"
      }
    
      if($SpecialFolder) {
        $Link = Join-Path ([System.Environment]::GetFolderPath($SpecialFolder)) $Link
      }
    
      $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($Link)
    }
    

Virus Scan Results

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Dependencies

This package has no dependencies.

Maintainer(s)

Software Author(s)

  • Ryan Ries

Tags

Version History

Version Downloads Last updated Status

Discussion for the Universal Pause Button Package

Ground rules:

  • This discussion is only about Universal Pause Button and the Universal Pause Button package. If you have feedback for Chocolatey, please contact the google group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or Universal Pause Button, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.

comments powered by Disqus