GNOME-TERMINAL(1)

💖 NAME 💖

okay so bestie, welcome to the manual page for gnome-terminal — and yes it lives in the User Commands section, we love that for it. It's a terminal emulator for GNOME. That's the whole vibe. 🫶

---

✨ SYNOPSIS ✨

gnome-terminal [OPTION...] [-- PROGRAM [ARG...]]

---

🌸 DESCRIPTION 🌸

gnome-terminal is a terminal emulator application for accessing a UNIX shell environment, which — and this is the fun part — you can use to run programs available on your system. no cap, that's literally the point.

It supports several profiles, multiple tabs, and it implements several keyboard shortcuts. it's giving main character energy in a window. 👑

---

💅 OPTIONS 💅

• --help, -h — shows you a brief lil overview of all the options. the tl;dr.
• --help-all — shows all the options in detail. the full lore drop.
• --help-gtk — shows all the GTK options.
• --help-terminal — shows all the options for picking between new terminal tabs or windows.
• --help-terminal-options — shows all the options that change the attributes of terminals, no matter whether they're in separate tabs or windows.
• --help-window-options — shows all the options that change the attributes of the windows containing the terminals.
• --load-config=FILE — restores the application to a previously saved state by loading it from a configuration file. glow-up from a save file, iconic.
• --preferences — shows the preferences window.
• --print-environment, -p — prints the environment variables you use to interact with newly created terminals.
• --quiet, -q — suppresses diagnostics. shhh. 🤫
• --verbose, -v — increases diagnostic verbosity. tell me EVERYTHING.
• --tab — opens a new tab containing a terminal in the last-opened window, using the default profile.
• --window — opens a new window with a tab containing a terminal with the default profile.
• --command, -e COMMAND — splits the argument to this option into a program and arguments the same way a shell would, then executes the resulting command-line inside the terminal.

🚨 this option is deprecated. Instead, use -- to terminate the options, and put the program and arguments to execute after it. For example, instead of gnome-terminal -e "python3 -q", prefer to use gnome-terminal -- python3 -q.

Also note that the COMMAND is not run via a shell: it gets split into words and executed as a program. If you need shell syntax, use the form gnome-terminal -- sh -c '...'.

• --execute PROGRAM [ARGS], -x PROGRAM [ARGS] — stops parsing options right here and interprets every subsequent option as a program and arguments to execute inside the terminal.

🚨 this option is deprecated: use -- instead. For example, instead of gnome-terminal -x python3 -q, prefer to use gnome-terminal -- python3 -q.

• --fd=FD — forwards a file descriptor.
• --profile=PROFILE-NAME — uses the given profile instead of the default profile.
• --title, -t TITLE — sets the initial terminal title.
• --wait — waits until the terminal's child exits. it'll sit there and hold your hand. 🫶
• --working-directory=DIRNAME — sets the terminal's working directory.
• --zoom=ZOOM — sets the terminal's zoom factor. 1.0 is normal size.
• --active — sets the last specified tab as the active one in its window.
• --full-screen — full-screens the window. cinema. 🎬
• --geometry=GEOMETRY — sets the window size as COLSxROWS+X+Y. For example, 80x24 or 80x24+200+200.
• --hide-menubar — turns off the menubar for the window.
• --show-menubar — turns on the menubar for the window.
• --maximize — maximizes the window.
• --role=ROLE — sets the X window role.
• --class=CLASS — program class, as used by the window manager.
• --display=DISPLAY — X display to use.
• --g-fatal-warnings — makes all warnings fatal. 💀 no gentle warnings allowed, they all get the axe.
• --gdk-debug=FLAGS — GDK debugging flags to set.
• --gdk-no-debug=FLAGS — GDK debugging flags to unset.
• --gtk-debug=FLAGS — GTK debugging flags to set.
• --gtk-no-debug=FLAGS — GTK debugging flags to unset.
• --gtk-module=MODULES — loads additional GTK modules.
• --name=NAME — program name, as used by the window manager.

---

🐛 BUGS 🐛

found a bug? pls read https://wiki.gnome.org/Apps/Terminal/ReportingBugs for how to report it. don't just yell into the void, bestie, there's a whole process. 🙈

---

🌈 EXAMPLES 🌈

Wanna run a terminal containing an interactive Python prompt? say less:

gnome-terminal --title=Python -- python3 -q

Wanna interpret shell syntax in a terminal? Either write it in a separate shell script, or use sh -c:

gnome-terminal -- sh -c 'if [ "$(id -u)" = 0 ]; then ...'

---

👀 SEE ALSO 👀

For further information, visit the website https://wiki.gnome.org/Apps/Terminal. There's also a list of frequently asked questions at https://wiki.gnome.org/Apps/Terminal/FAQ. iykyk, go read them. 📚

---

and that's the whole page, bestie!! 🎀 this one came from GNOME, dated June 2020, and it's the GNOME-TERMINAL(1) manual — periodt. 💜✨