termux/termux.properties

   1 ### This is a `.properties` [https://en.wikipedia.org/wiki/.properties] file
   2 ### for termux app properties and is loaded with the `java.util.Properties.load()`
   3 ### [https://developer.android.com/reference/java/util/Properties#load(java.io.Reader)]
   4 ### call by the termux app and must be formatted as per its spec.
   5 ### To make changes to a property value, uncomment the property line by removing
   6 ### any hash `#` characters at the start of the line.
   7 ### After making required changes, save the file and run `termux-reload-settings`
   8 ### in the terminal for changes to take effect. Some properties require app
   9 ### process to be restarted to be updated which can be done by force stopping
  10 ### the app from Android app settings.
  11 ### All information here can also be found on the
  12 ### wiki: https://wiki.termux.com/wiki/Terminal_Settings
  13
  14 ###############
  15 # General
  16 ###############
  17
  18 ### Allow external applications to execute arbitrary commands within Termux.
  19 ### This potentially could be a security issue, so option is disabled by
  20 ### default. Uncomment to enable.
  21 # allow-external-apps = true
  22
  23 ### Default working directory that will be used when launching the app.
  24 # default-working-directory = /data/data/com.termux/files/home
  25
  26 ### Uncomment to disable toasts shown on terminal session change.
  27 # disable-terminal-session-change-toast = true
  28
  29 ### Uncomment to not show soft keyboard on application start.
  30 # hide-soft-keyboard-on-startup = true
  31
  32 ### Uncomment to let keyboard toggle button to enable or disable software
  33 ### keyboard instead of showing/hiding it.
  34 # soft-keyboard-toggle-behaviour = enable/disable
  35
  36 ### Adjust terminal scrollback buffer. Max is 50000. May have negative
  37 ### impact on performance.
  38 # terminal-transcript-rows = 2000
  39
  40 ### Uncomment to use volume keys for adjusting volume and not for the
  41 ### extra keys functionality.
  42 # volume-keys = volume
  43
  44 ###############
  45 # Fullscreen mode
  46 ###############
  47
  48 ### Uncomment to let Termux start in full screen mode.
  49 fullscreen = true
  50
  51 ### Uncomment to attempt workaround layout issues when running in
  52 ### full screen mode.
  53 # use-fullscreen-workaround = true
  54
  55 ###############
  56 # Cursor
  57 ###############
  58
  59 ### Cursor blink rate. Values 0, 100 - 2000.
  60 # terminal-cursor-blink-rate = 0
  61
  62 ### Cursor style: block, bar, underline.
  63 # terminal-cursor-style = block
  64
  65 ###############
  66 # Extra keys
  67 ###############
  68
  69 ### Settings for choosing which set of symbols to use for illustrating keys.
  70 ### Choose between default, arrows-only, arrows-all, all and none
  71 # extra-keys-style = default
  72 extra-keys-style = all
  73
  74 ### Force capitalize all text in extra keys row button labels.
  75 # extra-keys-text-all-caps = true
  76
  77 ### Default extra-key configuration
  78 # extra-keys = [[ESC, TAB, CTRL, ALT, {key: '-', popup: '|'}, DOWN, UP]]
  79
  80 ### Two rows with more keys
  81 # extra-keys = [['ESC','/','-','HOME','UP','END','PGUP'], \
  82 #               ['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']]
  83 extra-keys = [[DRAWER, KEYBOARD]]
  84
  85 ### Configuration with additional popup keys (swipe up from an extra key)
  86 # extra-keys = [[ \
  87 #   {key: ESC, popup: {macro: "CTRL f d", display: "tmux exit"}}, \
  88 #   {key: CTRL, popup: {macro: "CTRL f BKSP", display: "tmux ←"}}, \
  89 #   {key: ALT, popup: {macro: "CTRL f TAB", display: "tmux →"}}, \
  90 #   {key: TAB, popup: {macro: "ALT a", display: A-a}}, \
  91 #   {key: LEFT, popup: HOME}, \
  92 #   {key: DOWN, popup: PGDN}, \
  93 #   {key: UP, popup: PGUP}, \
  94 #   {key: RIGHT, popup: END}, \
  95 #   {macro: "ALT j", display: A-j, popup: {macro: "ALT g", display: A-g}}, \
  96 #   {key: KEYBOARD, popup: {macro: "CTRL d", display: exit}} \
  97 # ]]
  98
  99 ### Another configuration with advanced popup key usage designed for more
 100 ### specific use-cases. In this case, it is designed for working with Vim-like
 101 ### editors for faster navigation
 102 #extra-keys = [ \
 103 #  [ \
 104 #    { key: ESC, popup: { macro: ":q\n", display: "QuickExit" } }, \
 105 #    { key: '/', popup: '\\\\' }, \
 106 #    { key: '-', popup: '_' }, \
 107 #    { key: HOME, popup: { macro: "CTRL HOME", display: "Top" } }, \
 108 #    { key: UP, popup: { macro: "CTRL UP", display: "UP" } }, \
 109 #    { key: END, popup: { macro: "CTRL END", display: "End" } }, \
 110 #    { key: ":", popup: ";" }, \
 111 #    { key: "(", popup: "{" } \
 112 #  ], \
 113 #  [ \
 114 #    { key: TAB, popup: { macro: ":wq\n", display: "Write And Exit" } }, \
 115 #    { key: CTRL, popup: { macro: ":w\n", display: "Write" } }, \
 116 #    ALT, \
 117 #    { key: LEFT, popup: { macro: "CTRL LEFT", display: "Left" } }, \
 118 #    { key: DOWN, popup: { macro: "CTRL DOWN", display: "Bottom" } }, \
 119 #    { key: RIGHT, popup: { macro: "CTRL RIGHT", display: "Right" } }, \
 120 #    { key: "#", popup: "$" }, \
 121 #    { key: ")", popup: "}" } \
 122 #  ] \
 123 #]
 124
 125 ###############
 126 # Colors/themes
 127 ###############
 128
 129 ### Force black colors for drawer and dialogs
 130 # use-black-ui = true
 131
 132 ###############
 133 # HW keyboard shortcuts
 134 ###############
 135
 136 ### Disable hardware keyboard shortcuts.
 137 # disable-hardware-keyboard-shortcuts = true
 138
 139 ### Open a new terminal with ctrl + t (volume down + t)
 140 # shortcut.create-session = ctrl + t
 141
 142 ### Go one session down with (for example) ctrl + 2
 143 # shortcut.next-session = ctrl + 2
 144
 145 ### Go one session up with (for example) ctrl + 1
 146 # shortcut.previous-session = ctrl + 1
 147
 148 ### Rename a session with (for example) ctrl + n
 149 # shortcut.rename-session = ctrl + n
 150
 151 ###############
 152 # Bell key
 153 ###############
 154
 155 ### Vibrate device (default).
 156 # bell-character = vibrate
 157
 158 ### Beep with a sound.
 159 # bell-character = beep
 160
 161 ### Ignore bell character.
 162 # bell-character = ignore
 163
 164 ###############
 165 # Back key
 166 ###############
 167
 168 ### Send the Escape key.
 169 # back-key=escape
 170
 171 ### Hide keyboard or leave app (default).
 172 # back-key=back
 173
 174 ###############
 175 # Keyboard issue workarounds
 176 ###############
 177
 178 ### Letters might not appear until enter is pressed on Samsung devices
 179 # enforce-char-based-input = true
 180
 181 ### ctrl+space (for marking text in emacs) does not work on some devices
 182 # ctrl-space-workaround = true
 183
 184 ###############
 185 # Terminal Margin adjustments
 186 ###############
 187
 188 ### Horizontal (left/right) Margin
 189 # terminal-margin-horizontal=3
 190
 191 ### Vertical (top/bottom) Margin
 192 # terminal-margin-vertical=0