FLATPAK PS(1)

    .SH "NAME" flatpak-ps - Enumerate running instances
    .SH "SYNOPSIS"
            .HP u
                flatpak ps
                 [OPTION...]

    .SH "DESCRIPTION"

        .PP Lists useful information about running Flatpak instances.
        .PP To see full details of a running instance, you can open the file /run/user/$UID/.flatpak/$INSTANCE/info, where $INSTANCE is the instance ID reported by flatpak ps.

    .SH "OPTIONS"

        .PP The following options are understood:

            .PP -h, --help

                    Show help options and exit.
                .RE
                .PP -v, --verbose

                        Print debug information during command processing.
                    .RE
                    .PP --ostree-verbose

                            Print OSTree debug information during command processing.
                        .RE
                        .PP --columns=FIELD,...

                                Specify what information to show about each instance. You can list multiple fields, or use this option multiple times.

                Append :s[tart], :m[iddle], :e[nd] or :f[ull] to column names to change ellipsization.
                            .RE

                    .SH "FIELDS"

                        .PP The following fields are understood by the --columns option:

                            .PP instance

                                    Show the instance ID
                                .RE
                                .PP application

                                        Show the application ID
                                    .RE
                                    .PP arch

                                            Show the architecture
                                        .RE
                                        .PP branch

                                                Show the application branch
                                            .RE
                                            .PP commit

                                                    Show the application commit
                                                .RE
                                                .PP runtime

                                                        Show the runtime ID
                                                    .RE
                                                    .PP runtime-branch

                                                            Show the runtime branch
                                                        .RE
                                                        .PP runtime-commit

                                                                Show the runtime commit
                                                            .RE
                                                            .PP pid

                                                                    Show the PID of the wrapper process
                                                                .RE
                                                                .PP child-pid

                                                                        Show the PID of the sandbox process
                                                                    .RE
                                                                    .PP active

                                                                            Show whether the app is active (i.e. has an active window)
                                                                        .RE
                                                                        .PP background

                                                                                Show whether the app is in the background (with no open windows)
                                                                            .RE
                                                                            .PP all

                                                                                    Show all columns
                                                                                .RE
                                                                                .PP help

                                                                                        Show the list of available columns
                                                                                    .RE

                                                                                .PP Note that field names can be abbreviated to a unique prefix.

                                                                            .SH "EXAMPLES"

                                                                                .PP $ flatpak ps --columns=application,pid,runtime,runtime-branch

                                                                            .SH "SEE ALSO"

                                                                                .PP flatpak(1), flatpak-run(1)