---
name: "ptcli"
section: "1"
platform: "linux"
package: "xdg-desktop-portal-phosh"
version: "0.58.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ptcli"
---

# ptcli(1)

A CLI to interact with phosh-thumbnailer.

## Name

ptcli - A CLI to interact with phosh-thumbnailer.

## SYNOPSIS

**ptcli \[OPTION…\] /path/to/directory**

**ptcli \[OPTION…\] /path/to/file\_1 /path/to/file\_2 …**

**ptcli \[OPTION…\] --stop**

## DESCRIPTION

**ptcli** can be used to interact with [**phosh-thumbnailer**(8)](/phosh-thumbnailer/8.md) service. It is primarily used to create thumbnails as per Thumbnail Managing Standard \<https://specifications.freedesktop.org/thumbnail-spec/latest/\>.

- **-h, --help**

  Print help options and exit.

- **-s, --stop**

  Stop the on-going thumbnailing operation.

- **-v, --version**

  Print version and exit.

## EXAMPLES

To create thumbnails for all files in the current directory:

```
ptcli .
```

To create thumbnails for all files in **$HOME/Pictures**:

```
ptcli $HOME/Pictures
```

To create thumbnails for a set of files:

```
ptcli $HOME/Pictures/foo.png bar.txt ../spam.ogg
```

To stop the on-going thumbnailing operation:

```
ptcli --stop
```

## SEE ALSO

[**phosh-thumbnailer**(8)](/phosh-thumbnailer/8.md)