---
name: "gpgparticipants-filter"
section: "1"
platform: "linux"
package: "signing-party"
version: "2.12-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gpgparticipants-filter"
---

# gpgparticipants-filter(1)

filters a list of key ids as input to gpgparticipants

## NAME

gpgparticipants-filter - filters a list of key ids as input to gpgparticipants

## SYNOPSIS

**gpgparticipants-filter** \[-h\] \[-o FILE\] \[-b GPG\_BIN\] \[-d GPG\_HOME\] \[-a\] \[--version\] FILTER \[FILTER ...\]

## DESCRIPTION

This tool filters a list of key ids from your gpg keyring as input to gpgparticipants. It sorts the alphabetically list by the first uid of each key. Per default it skips over revoked and expired keys. The output can be piped into gpgparticipants or stored in a file.

## OPTIONS

### positional arguments:

- FILTER

  input query, which will be passed to gpg

### optional arguments:

- **-h**, **--help**

  show this help message and exit

- **-o** FILE, **--output** FILE

  specifies the file where the output should be written to (per default writes to stdout)

- **-b** GPG\_BIN, **--gpg-binary** GPG\_BIN

  custom path to gpg (default: "gpg")

- **-d** GPG\_HOME, **--homedir** GPG\_HOME

  custom homedir for gpg (see **--homedir** of gpg)

- **-a**, **--all-keys**

  show also revoked and expired keys

- **--version**

  output version information and exit

## SEE ALSO

[**gpgparticipants**(1)](/gpgparticipants/1.md),[**gpg**(1)](/gpg/1.md)