.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "SAKURA 1" .TH SAKURA 1 2024-08-19 3.8.8 "" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME sakura \- A simple but powerful libvte\-based terminal emulator. .SH SYNOPSIS .IX Header "SYNOPSIS" sakura [options...] .SH DESCRIPTION .IX Header "DESCRIPTION" sakura is a terminal emulator based on GTK+ and VTE. It's a terminal emulator with few dependencies, so you don't need a full GNOME desktop installed to have a decent terminal emulator. .SH "HELP OPTIONS" .IX Header "HELP OPTIONS" .IP "\fB\-?, \-\-help\fR" 8 .IX Item "-?, --help" Show help options. .IP \fB\-\-help\-all\fR 8 .IX Item "--help-all" Show all help options .IP \fB\-\-help\-gtk\fR 8 .IX Item "--help-gtk" Show GTK+ Options .SH "APPLICATION OPTIONS" .IX Header "APPLICATION OPTIONS" .IP "\fB\-v, \-\-version\fR" 8 .IX Item "-v, --version" Print version number .IP "\fB\-f, \-\-font\fR" 8 .IX Item "-f, --font" Select initial terminal font .IP "\fB\-n, \-\-ntabs\fR" 8 .IX Item "-n, --ntabs" Select initial number of tabs .IP "\fB\-x, \-\-execute\fR" 8 .IX Item "-x, --execute" Execute command .IP "\fB\-e, \-\-xterm\-execute\fR" 8 .IX Item "-e, --xterm-execute" Execute command (compatible with xterm's \-e option) .IP "\fB\-l, \-\-login\fR" 8 .IX Item "-l, --login" Login shell .IP "\fB\-c, \-\-columns\fR" 8 .IX Item "-c, --columns" Set columns number .IP "\fB\-r, \-\-rows\fR" 8 .IX Item "-r, --rows" Set rows number .IP "\fB\-h, \-\-hold\fR" 8 .IX Item "-h, --hold" Hold window after execute command .IP "\fB\-d, \-\-working\-directory\fR" 8 .IX Item "-d, --working-directory" Set working directory .IP "\fB\-m, \-\-maximize\fR" 8 .IX Item "-m, --maximize" Maximize window .IP "\fB\-s, \-\-fullscreen\fR" 8 .IX Item "-s, --fullscreen" Fullscreen mode .IP \fB\-\-display=DISPLAY\fR 8 .IX Item "--display=DISPLAY" X display to use .IP \fB\-\-config\-file=FILENAME\fR 8 .IX Item "--config-file=FILENAME" Use alternate configuration file. Path is relative to the sakura config dir. (Example: ~/.config/sakura/FILENAME). .SH "GTK+ OPTIONS" .IX Header "GTK+ OPTIONS" .IP \fB\-\-class=CLASS\fR 8 .IX Item "--class=CLASS" Program class as used by the window manager .IP \fB\-\-name=NAME\fR 8 .IX Item "--name=NAME" Program name as used by the window manager .IP \fB\-\-screen=SCREEN\fR 8 .IX Item "--screen=SCREEN" X screen to use .IP \fB\-\-sync\fR 8 .IX Item "--sync" Make X calls synchronous .IP \fB\-\-gtk\-module=MODULES\fR 8 .IX Item "--gtk-module=MODULES" Load additional GTK+ modules .IP \fB\-\-g\-fatal\-warnings\fR 8 .IX Item "--g-fatal-warnings" Make all warnings fatal .SH CONFIGURATION .IX Header "CONFIGURATION" .IP "show_tab_bar=[always | multiple | never]" 8 .IX Item "show_tab_bar=[always | multiple | never]" This list of options is currently incomplete. .SH "KEYBINDINGS SUPPORT" .IX Header "KEYBINDINGS SUPPORT" \&\fBsakura\fR supports keyboard bindings. They are configurable by setting the following properties in your sakura config file (~/.config/sakura/sakura.conf). .SS ACCELERATORS .IX Subsection "ACCELERATORS" Accelerators can be set to any mask value from the GdkModifierType in gdktypes.h; see: .PP http://gtk.php.net/manual/en/html/gdk/gdk.enum.modifiertype.html .PP Mask values can be combined by ORing them. .PP For example, to set the delete tab accelerator to Ctrl + Shift: .PP del_tab_accelerator=5 .PP because GDK_SHIFT_MASK has a value of 1 (1 << 0), and GDK_CONTROL_MASK has a value of 4 (1 << 2); ORing them together, you get 5. .PP I realise that this configuration is not so friendly to non-programmers, but it is a start. :) .SS KEYS .IX Subsection "KEYS" For example, to set the add tab key to 'T': .PP add_tab_key=T .PP Before sakura used keycodes instead of strings. They're still valid. .SS DEFAULTS .IX Subsection "DEFAULTS" .Vb 10 \& 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 .Ve .PP You can also increase and decrease the font size in the GTK+ standard way (not configurable): .PP .Vb 2 \& Ctrl + \*(Aq+\*(Aq \-> Increase font size \& Ctrl + \*(Aq\-\*(Aq \-> Decrease font size .Ve .SH BUGS .IX Header "BUGS" \&\fBsakura\fR is hosted on Launchpad. Bugs can be filed at: .PP https://bugs.launchpad.net/sakura .SH AUTHORS .IX Header "AUTHORS" \&\fBsakura\fR was written by David Gómez . .PP This manual page was written by Andrew Starr-Bochicchio . .PP Both are released under the GNU General Public License, version 2 or later.