---
name: "gnome-session-inhibit"
section: "1"
platform: "linux"
package: "gnome-session"
version: "51.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnome-session-inhibit"
---

# gnome-session-inhibit(1)

Inhibit gnome-session functionality

## NAME

gnome-session-inhibit - Inhibit gnome-session functionality

## SYNOPSIS

**gnome-session-inhibit** \[OPTION...\] \[COMMAND\]

## DESCRIPTION

**gnome-session-inhibit** can inhibit certain gnome-session functionality while executing the given COMMAND. To achieve this, it calls the Inhibit() method of the gnome-session D-Bus API and creates an inhibitor. The inhibitor is automatically removed when gnome-session-inhibit exits.

A typical use case is to prevent the session from going idle (and thus locking the screen) while a movie player is running.

## OPTIONS

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

  Print help and exit

- **--version**

  Print version information and exit

- **--app-id** ID

  The application id to use when calling the gnome-session Inhibit() method. If this option is not specified, "unknown" is used.

- **--reason** REASON

  A human-readable reason to pass along when calling the gnome-session Inhibit() method. If this option is not specified, "not specified" is used.

- **--inhibit** ACTION

  ACTION specifies the actions to inhibit. This option can be repeated to inhibit multiple actions. The possible values for an ACTION are: logout, switch-user, suspend, idle, automount. If this option is not specified, "idle" is assumed.

- **--inhibit-only**

  Do not launch COMMAND and wait forever instead

- **-l**, **--list**

  List the existing inhibitions and exit

## SEE ALSO

[**systemd-inhibit**(1)](/systemd-inhibit/1.md)