]>
Commit | Line | Data |
---|---|---|
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 |