Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update peek.md #5168

Open
wants to merge 7 commits into
base: docs
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added hub/images/pt-peek-delete-confirmation.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
31 changes: 27 additions & 4 deletions hub/powertoys/peek.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
---
title: PowerToys Peek utility for Windows
description: A system-wide utility for Windows to quickly preview file content.
ms.date: 11/19/2024
ms.date: 01/28/2025
ms.topic: concept-article
no-loc: [PowerToys, Windows, Peek, Win]
# Customer intent: Learn how to configure and use the Peek utility in PowerToys.
---

# Peek utility

A system-wide utility for Windows to preview file content without the need to open multiple applications or interrupt your workflow. It offers a seamless and quick file preview experience for various file types, including images, Office documents, web pages, Markdown files, text files, and developer files.
A system-wide utility for Windows to preview file content without the need to open multiple applications or interrupt your workflow. It offers a seamless and quick file preview experience for various file types, including images, Office documents, videos, web pages, Markdown files, text files, and developer files. Peek also lets you see summary information about folders.

![Screenshot of PowerToys Peek utility](../images/powertoys-peek.png)

Expand All @@ -21,12 +21,34 @@ Using <kbd>Left</kbd> and <kbd>Right</kbd> or <kbd>Up</kbd> and <kbd>Down</kbd>,

## Pin preview window position and size

The Peek window adjusts its size based on the dimensions of the images being previewed. However, if you prefer to keep the window's size and position, you can use the pinning feature. By selecting the pinning button, the window will preserve the current size and position. Selecting the pinning button again will unpin the window. When unpinned, the Peek window will return to the default position and size when previewing the next file.
The Peek window adjusts its size based on the dimensions of the images being previewed. However, if you prefer to keep the window's size and position, you can use the pinning feature.

By selecting the pinning button, the window will preserve the current size and position. Selecting the pinning button again will unpin the window. When unpinned, the Peek window will return to the default position and size when previewing the next file.

## Open file with the default program

Select **Open with** or <kbd>Enter</kbd> to open the current file with the default program.

## See extra information about the current file

Hover over the preview to see extra information about the file, including its size, type, and when it was last modified.

## Delete files

Press the <kbd>Delete</kbd> key to move the current file to the Recycle Bin.

By default, a confirmation dialog will appear before deletions. To skip future confirmations, either:

- Check the "Don't show this warning again" checkbox in the dialog.
- Uncheck the "Ask for confirmation before deleting files" option in Peek's settings page.

![A screenshot of Peek's file deletion confirmation dialog](../images/pt-peek-delete-confirmation.png)

After deleting the file, Peek will automatically preview the next file. If there are no more files to preview, a message will be displayed.

> [!TIP]
> Only files may be deleted. Folders may not be deleted, even if they are empty.

## Settings

From the settings page, the following options can be configured:
Expand All @@ -35,6 +57,7 @@ From the settings page, the following options can be configured:
| :--- | :--- |
| Activation shortcut | The customizable keyboard command to open Peek for the selected file(s). |
| Always run not elevated, even when PowerToys is elevated | Tries to run Peek without elevated permissions, to fix access to network shares. |
| Automatically close the Peek window after it loses focus | |
| Automatically close the Peek window after it loses focus | |
| Ask for confirmation before deleting files | When enabled, Peek shows a confirmation dialog before deleting files. |

[!INCLUDE [install-powertoys.md](../includes/install-powertoys.md)]