SAKURA(1)

๐ŸŒธ SAKURA(1) ๐ŸŒธ

okay bestie, sit down, hydrate, because i'm about to tell you about the cutest little terminal emulator in the whole entire game ๐Ÿ’– this is the manual page for sakura, section 1 of the manual, and honestly? she ate.


โœจ NAME โœจ

sakura โ€” a simple but powerful libvte-based terminal emulator. no cap.


๐ŸŽ€ SYNOPSIS ๐ŸŽ€

sakura [options...]

๐Ÿฆ‹ DESCRIPTION ๐Ÿฆ‹

so like, sakura is a terminal emulator built on GTK+ and VTE. that's the whole vibe. she's a terminal emulator with very few dependencies, which lowkey means you do NOT need a whole entire GNOME desktop installed just to have a decent terminal emulator. iconic behavior, honestly. main character energy fr fr ๐Ÿ‘‘


๐Ÿ’… HELP OPTIONS ๐Ÿ’…

  • -?, --help โ€” show help options. the classic "help me pls" move ๐Ÿซถ
  • --help-all โ€” show all help options. the deluxe version.
  • --help-gtk โ€” show the GTK+ options specifically. bestie-ception.

๐Ÿ”ฅ APPLICATION OPTIONS ๐Ÿ”ฅ

  • -v, --version โ€” print the version number. how old is she? find out.
  • -f, --font โ€” select the initial terminal font. pick her outfit ๐Ÿ’…
  • -n, --ntabs โ€” select the initial number of tabs. how many tabs you opening at launch, be honest.
  • -x, --execute โ€” execute a command.
  • -e, --xterm-execute โ€” execute a command (compatible with xterm's -e option). for the xterm girlies.
  • -l, --login โ€” login shell.
  • -c, --columns โ€” set the columns number.
  • -r, --rows โ€” set the rows number.
  • -h, --hold โ€” hold the window after executing the command. yes, -h is hold here, not help โ€” don't get got ๐Ÿ˜ญ (help is -?, remember?)
  • -d, --working-directory โ€” set the working directory.
  • -m, --maximize โ€” maximize the window.
  • -s, --fullscreen โ€” fullscreen mode. she takes up the WHOLE screen.
  • --display=DISPLAY โ€” X display to use.
  • --config-file=FILENAME โ€” use an alternate configuration file. the path is relative to the sakura config dir. (Example: ~/.config/sakura/FILENAME).

๐ŸŒˆ GTK+ OPTIONS ๐ŸŒˆ

  • --class=CLASS โ€” program class as used by the window manager.
  • --name=NAME โ€” program name as used by the window manager.
  • --screen=SCREEN โ€” X screen to use.
  • --sync โ€” make X calls synchronous.
  • --gtk-module=MODULES โ€” load additional GTK+ modules.
  • --g-fatal-warnings โ€” make all warnings fatal. spicy. ๐ŸŒถ๏ธ

๐Ÿ“ CONFIGURATION ๐Ÿ“

  • show_tab_bar=[always | multiple | never] โ€” controls the tab bar, obvs.
heads up: this list of options is currently incomplete. so if you're looking for more, this ain't it (yet). ๐Ÿ™ˆ

๐Ÿงš KEYBINDINGS SUPPORT ๐Ÿงš

sakura supports keyboard bindings!! and they're configurable โ€” you set the following properties in your sakura config file, which lives at ~/.config/sakura/sakura.conf. yes, you can customize her. she's flexible like that ๐Ÿ’œ

โญ ACCELERATORS โญ

Accelerators can be set to any mask value from the GdkModifierType in gdktypes.h; see:

http://gtk.php.net/manual/en/html/gdk/gdk.enum.modifiertype.html

Mask values can be combined by ORing them together. โœจ

for example, to set the delete tab accelerator to Ctrl + Shift:

del_tab_accelerator=5

because GDK_SHIFT_MASK has a value of 1 (1 << 0), and GDK_CONTROL_MASK has a value of 4 (1 << 2); OR them together and you get 5. math girlies rise ๐Ÿงฎ

ngl, this configuration is not exactly friendly to non-programmers, but it's a start. :) (that's basically a direct quote, bestie, i'm not gonna lie to you.)

๐ŸŽ€ KEYS ๐ŸŽ€

for example, to set the add tab key to 'T':

add_tab_key=T

fun fact: back in the day sakura used keycodes instead of strings โ€” and those keycodes are still valid. retro queen ๐Ÿ‘‘

๐Ÿ’– DEFAULTS ๐Ÿ’–

  • Ctrl + Shift + T โ†’ New tab
  • Ctrl + Shift + W โ†’ Close current tab
  • Ctrl + Shift + C โ†’ Copy selected text
  • Ctrl + Shift + V โ†’ Paste selected text
  • Ctrl + Left cursor โ†’ Previous tab
  • Ctrl + Right cursor โ†’ Next tab
  • Ctrl + [1-9] โ†’ Switch to tab N (1-9)
  • Ctrl + Shift + S โ†’ Toggle scrollbar
  • Ctrl + Shift + Mouse left button โ†’ Open link
  • F11 โ†’ Fullscreen
  • Shift + PageUp โ†’ Move up through scrollback by page
  • Shift + PageDown โ†’ Move down through scrollback by page
  • Ctrl + Shift + Up โ†’ Move up through scrollback by line
  • Ctrl + Shift + Down โ†’ Move down through scrollback by line

and also โ€” you can increase and decrease the font size the GTK+ standard way (this one is not configurable, periodt):

  • Ctrl + '+' โ†’ Increase font size
  • Ctrl + '-' โ†’ Decrease font size

๐Ÿ˜ญ BUGS ๐Ÿ˜ญ

sakura is hosted on Launchpad. bugs can be filed at:

https://bugs.launchpad.net/sakura

found a bug? don't gatekeep, file it ๐Ÿ’€


๐Ÿ‘‘ AUTHORS ๐Ÿ‘‘

sakura was written by David Gรณmez <david@pleyades.net>.

this manual page was written by Andrew Starr-Bochicchio <a.starr.b@gmail.com>.

both are released under the GNU General Public License, version 2 or later. slay. legal girlies stay winning ๐Ÿซถ


okay that's the whole page bestie, you're officially educated โœจ this was sakura version 3.8.9, dated 2026-02-09 โ€” go forth and terminal, ily, bye ๐Ÿ’–๐ŸŒธ๐Ÿฆ‹

๐Ÿ“ฆ where this page comes from