Skip to content

Instantly share code, notes, and snippets.

@iacchus
Created May 27, 2026 13:10
Show Gist options
  • Select an option

  • Save iacchus/bd16bad9b4b9115ed4ddafb094b68417 to your computer and use it in GitHub Desktop.

Select an option

Save iacchus/bd16bad9b4b9115ed4ddafb094b68417 to your computer and use it in GitHub Desktop.
termux phone extra-keys
### After making changes and saving you need to run `termux-reload-settings`
### to update the terminal. All information here can also be found on the
### wiki: https://wiki.termux.com/wiki/Terminal_Settings
fullscreen = true
#fullscreen = false
# use-fullscreen-workaround = true
###############
# Extra keys
###############
### Settings for choosing which set of symbols to use for illustrating keys.
### Choose between default, arrows-only, arrows-all, all and none
# extra-keys-style = default
#extra-keys = none
# extra-keys-style = none
extra-keys-style = default
### Default extra-key configuration
# extra-keys = [[ESC, TAB, CTRL, ALT, {key: '-', popup: '|'}, DOWN, UP]]
# extra-keys = [[]]
### Two rows with more keys
#extra-keys = [['ESC','/','-','HOME','UP','END','PGUP'], \
# ['TAB','CTRL','ALT','LEFT','DOWN','RIGHT','PGDN']]
# https://www.gnu.org/software/bash/manual/html_node/Bindable-Readline-Commands.html
#
# end-of-line (C-e) Move to the end of the line.
# unix-line-discard (C-u) Kill backward from the cursor to the beginning of the current line.
#
# So, "CTRL e CTRL u " at the beginning of macros kill the previous line
extra-keys = [ \
[ \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: "CTRL e CTRL u mosh SPACE --predict=always SPACE gcloud-yoke ENTER", display: "𝚖𝚘𝚜𝚑", popup: \
{macro: "CTRL e CTRL u ssh SPACE gcloud-yoke ENTER", display: "𝚜𝚜𝚑"}}, \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: 'vi"', display: '𝚟𝚒"', popup: \
{macro: "vi'", display: "𝚟𝚒'"}}, \
{macro: "viw", display: "𝚟𝚒𝚠", popup: \
{macro: "viW", display: "𝚟𝚒𝚆"}}, \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: "/", display: "/", popup: {macro: "", display: ""}}, \
{macro: "CTRL e CTRL u lg ENTER ", display: "𝚕𝚐𝚒𝚝", popup: {macro: "", display: ""}}, \
{macro: "ESC :set SPACE wrap! ENTER", display: "𝚠𝚛𝚊𝚙!", popup: {macro: "", display: ""}}, \
{macro: "CTRL e CTRL u cd SPACE TAB", display: "𝚌𝚍", popup: \
{macro: "CTRL e CTRL u cd SPACE . TAB", display: "𝚌𝚍 ."}}, \
{macro: "", display: "", popup: {macro: "", display: ""}} \
], \
[ \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: "ESC", display: "𝙴𝚂𝙲", popup: {macro: "", display: ""}}, \
{macro: "CTRL", display: "𝙲𝚃𝚁𝙻", popup: {macro: "", display: ""}}, \
{macro: "!$ ENTER", display: "!$", popup: \
{macro: "CTRL e CTRL u cd SPACE !$ ENTER ENTER", display: "cd !$"}}, \
{macro: "CTRL e CTRL u cd SPACE - ENTER", display: "–", popup: {macro: "", display: ""}}, \
{macro: "ESC :q ENTER", display: ":𝚚", popup: {macro: "", display: ""}}, \
{macro: "CTRL d", display: "<C-𝚍>", popup: {macro: "", display: ""}}, \
{macro: "TAB", popup: {macro: "", display: ""}}, \
{macro: "CTRL r", display: "<C-𝚛>", popup: {macro: "", display: ""}}, \
{macro: "UP", display: "👆🏻", popup: {macro: "", display: ""}}, \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: "", display: "", popup: {macro: "", display: ""}} \
], \
[ \
{macro: "", display: "", popup: {macro: "", display: ""}}, \
{macro: "KEYBOARD", popup: {macro: "", display: ""}}, \
{macro: "ALT", display: "𝙰𝙻𝚃", popup: {macro: "", display: ""}}, \
{macro: "cd SPACE ~ ENTER", display: "~", popup: {macro: "", display: ""}}, \
{macro: "cd SPACE .. ENTER", display: "··", popup: {macro: "", display: ""}}, \
{macro: "ESC :w ENTER", display: ":𝚠", popup: {macro: "", display: ""}}, \
{macro: "CTRL c", display: "<C-𝚌>", popup: {macro: "", display: ""}}, \
{macro: "ENTER", display: "🔨", popup: {macro: "", display: ""}}, \
{macro: "LEFT", display: "👈🏿", popup: {macro: "", display: ""}}, \
{macro: "DOWN", display: "👇🏾", popup: {macro: "", display: ""}}, \
{macro: "RIGHT", display: "👉", popup: {macro: "", display: ""}}, \
{macro: "", display: "", popup: {macro: "", display: ""}} \
] \
]
# EMPTY ROW IN CASE YOU NEED
# [ \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}}, \
# {macro: "", display: "", popup: {macro: "", display: ""}} \
# ], \
# extra-keys = [ \
# [ \
# {key: "ESC", display: ""}, \
# {key: ESC, popup: {macro: "CTRL f d", display: "tmux exit"}}, \
# {key: CTRL, popup: {macro: "CTRL f BKSP", display: "tmux ←"}}, \
# {macro: "ESC ,t", display: "🌳", popup: {macro: ", n", display: "focus"}}, \
# {macro: "lsd ENTER", display: "lsd", popup: {macro: 'lsd SPACE -a ENTER', display: "lsd -a"}}, \
# {macro: 'mosh SPACE --predict=always SPACE gcloud-yoke ENTER', display: "MOSH", \
# popup: {macro: 'ssh SPACE gcloud-yoke ENTER', display: "SSH"}}, \
# {macro: 'CTRL f', display: "<C-𝚏>", popup: {macro: 'CTRL r', display: "<C-r>"}}, \
# {macro: 'vim SPACE TAB', display: "VIM", \
# popup: {macro: 'vimfunc ENTER', display: "VI📁"}}, \
# {macro: "!$ ENTER", display: "!$", popup: {macro: "cd SPACE !$ ENTER ENTER", display: "cd !$"}}, \
# {macro: "cd SPACE - ENTER", display: "-", popup: {macro: "ALT g", display: A-g}}, \
# {macro: "quartz-sync ENTER", display: "𝚚𝚛𝚝𝚣", popup: {macro: ',w', display: "easyw"}}, \
# {macro: "ESC :q ENTER", display: ":q", popup: {macro: "ALT g", display: A-g}}, \
# {macro: "CTRL d", display: "<C-𝚍>", popup: {macro: "ALT g", display: A-g}}, \
# {key: TAB, popup: {macro: "ALT a", display: A-a}}, \
# {macro: "CTRL r", display: "<C-𝚛>", popup: {macro: ",h", display: "buffp"}}, \
# {key: UP, popup: {macro: "CTRL u", display: "<C-u>"}}, \
# {key: UP, display: "", popup: {macro: ",l", display: "buffn"}}, \
# {key: UP, display: "", popup: {macro: ",l", display: "buffn"}} \
# ], \
# [ \
# {key: KEYBOARD, display: ""}, \
# {key: KEYBOARD, display: "⌨️", popup: {macro: "CTRL d", display: exit}}, \
# {key: ALT, popup: {macro: "CTRL f TAB", display: "tmux →"}}, \
# {macro: "CTRL o d CTRL d", display: "DTX", popup: {macro: "CTRL p n", display: "newpn"}}, \
# {macro: "lsd SPACE -l ENTER", display: "lsd -l", popup: {macro: "lsd SPACE -la ENTER", display: "lsd -la"}}, \
# {macro: "ranger ENTER", display: "📁", popup: {macro: "", display: ""}}, \
# {macro: 'vi"', display: '𝚟𝚒"', popup: {macro: "vi'", display: "𝚟𝚒'"}}, \
# {macro: 'vw SPACE ENTER', display: "vwki", \
# popup: {macro: 'vwfunc ENTER', display: "vw📁"}}, \
# {macro: "cd SPACE ~ ENTER", display: "~", popup: {macro: "~/", display: "~/"}}, \
# {macro: "cd SPACE .. ENTER", display: "ꞏ ꞏ", popup: {macro: "", display: ""}}, \
# {macro: "gogit ENTER", display: "𝚐𝚘𝚐𝚒𝚝", popup: {macro: ',/', display: "easy/"}}, \
# {macro: "ESC :w ENTER", display: ":w", popup: {macro: "", display: ""}}, \
# {macro: "CTRL c", display: "<C-𝚌>", popup: {macro: "", display: ""}}, \
# {key: ENTER, popup: {macro: "RIGHT ENTER", display: "⇒↲"}}, \
# {key: LEFT, popup: {macro: "ALT h", display: "buffp"}}, \
# {key: DOWN, popup: {macro: "CTRL d", display: "<C-d>"}}, \
# {key: RIGHT, popup: {macro: "ALT l", display: "buffn"}}, \
# {key: RIGHT, display: "", popup: {macro: ",l", display: "buffn"}} \
# ] \
# ]
# {macro: ENTER, display: "<CR>"}, \
# ## Configuration with additional popup keys (swipe up from an extra key)
# extra-keys = [[ \
# {key: ESC, popup: {macro: "CTRL f d", display: "tmux exit"}}, \
# {key: CTRL, popup: {macro: "CTRL f BKSP", display: "tmux ←"}}, \
# {key: ALT, popup: {macro: "CTRL f TAB", display: "tmux →"}}, \
# {key: TAB, popup: {macro: "ALT a", display: A-a}}, \
# {key: LEFT, popup: HOME}, \
# {key: DOWN, popup: PGDN}, \
# {key: UP, popup: PGUP}, \
# {key: RIGHT, popup: END}, \
# {key: ESC, popup: {macro: "CTRL f d", display: "tmux exit"}}, \
# # {macro: "ALT j", display: A-j, popup: {macro: "ALT g", display: A-g}}, \
# {key: KEYBOARD, popup: {macro: "CTRL d", display: exit}} \
# ]]
###############
# Colors/themes
###############
### Force black colors for drawer and dialogs
# use-black-ui = true
###############
# Keyboard shortcuts
###############
### Open a new terminal with ctrl + t (volume down + t)
# shortcut.create-session = ctrl + t
### Go one session down with (for example) ctrl + 2
# shortcut.next-session = ctrl + 2
### Go one session up with (for example) ctrl + 1
# shortcut.previous-session = ctrl + 1
### Rename a session with (for example) ctrl + n
# shortcut.rename-session = ctrl + n
###############
# Bell key
###############
### Vibrate device (default).
# bell-character = vibrate
### Beep with a sound.
# bell-character = beep
bell-character = beep
### Ignore bell character.
# bell-character = ignore
###############
# Back key
###############
### Send the Escape key.
# back-key=escape
### Hide keyboard or leave app (default).
# back-key=back
###############
# Keyboard issue workarounds
###############
### Letters might not appear until enter is pressed on Samsung devices
# enforce-char-based-input = true
# enforce-char-based-input = true
### ctrl+space (for marking text in emacs) does not work on some devices
# ctrl-space-workaround = true
terminal-margin-horizontal=0
terminal-margin-vertical=0
terminal-cursor-blink-rate=100
allow-external-apps = true
volume-keys = volume
# terminal-onclick-url-open = true
@DEAD1nsane

Copy link
Copy Markdown

Hey! I forked your properties file to add a few things and clean it up a bit

Here's the Patch:

From bda23aa490c2b8d77d9749010da1d2b2f731c0a0 Mon Sep 17 00:00:00 2001
From: DEAD1nsane
Date: Fri, 21 Aug 2026 05:58:21 -0500
Subject: [PATCH] style(termux): fix syntax crashes and map native session
 macros

---
 termux.properties | 104 ++++++++++++++++++++--------------------------
 1 file changed, 45 insertions(+), 59 deletions(-)

diff --git a/termux.properties b/termux.properties
index c65f04a..afd0d20 100644
--- a/termux.properties
+++ b/termux.properties
@@ -1,22 +1,42 @@
 ### After making changes and saving you need to run `termux-reload-settings`
 ### to update the terminal.  All information here can also be found on the
 ### wiki: https://wiki.termux.com/wiki/Terminal_Settings
+### if the option is true, it can also be false
+
+###############
+# Useful
+###############
+
+soft-keyboard-toggle-behavior = resize
+terminal-onclick-url-open = true
+terminal-cursor-blink-rate = 1000
+terminal-margin-horizontal = 10
+terminal-transcript-rows = 2000
 
 fullscreen = true
-#fullscreen = false
-# use-fullscreen-workaround = true
+extra-keys-text-all-caps = false
+allow-external-apps = true
+volume-keys = volume
+
+### Force black colors for drawer and dialogs
+use-black-ui = true
+
+
+##################
+# Keyboard ⌨ Icon
+##################
+
+
+### this will give ⌨ to Hide/Show
+{key: KEYBOARD, popup: 'KEYBOARD'}, \
+### this will give ⌨ to Hide/Show with macro
+{key: 'KEYBOARD', popup: {macro: "F1", display: "F1"}}, \
+
 
 ###############
 # Extra keys
 ###############
 
-### Settings for choosing which set of symbols to use for illustrating keys.
-### Choose between default, arrows-only, arrows-all, all and none
-# extra-keys-style = default
-#extra-keys = none
-# extra-keys-style = none
-extra-keys-style = default
-
 ### Default extra-key configuration
 # extra-keys = [[ESC, TAB, CTRL, ALT, {key: '-', popup: '|'}, DOWN, UP]]
 # extra-keys = [[]]
@@ -27,10 +47,9 @@ extra-keys-style = default
 
 
 # https://www.gnu.org/software/bash/manual/html_node/Bindable-Readline-Commands.html
-#
+
 # end-of-line (C-e) Move to the end of the line.
 # unix-line-discard (C-u) Kill backward from the cursor to the beginning of the current line.
-#
 # So, "CTRL e CTRL u " at the beginning of macros kill the previous line
 
 
@@ -123,10 +142,10 @@ extra-keys = [ \
 #  {macro: 'vim SPACE TAB', display: "VIM", \
 #   popup: {macro: 'vimfunc ENTER', display: "VI📁"}}, \
 #  {macro: "!$ ENTER", display: "!$", popup: {macro: "cd SPACE !$ ENTER ENTER", display: "cd !$"}}, \
-#  {macro: "cd SPACE - ENTER", display: "-", popup: {macro: "ALT g", display: A-g}}, \
+#  {macro: "cd SPACE - ENTER", display: "-", popup: {macro: "ALT g", display: "A-g"}}, \
 #  {macro: "quartz-sync ENTER", display: "𝚚𝚛𝚝𝚣", popup: {macro: ',w', display: "easyw"}}, \
-#  {macro: "ESC :q ENTER", display: ":q", popup: {macro: "ALT g", display: A-g}}, \
-#  {macro: "CTRL d", display: "<C-𝚍>", popup: {macro: "ALT g", display: A-g}}, \
+#  {macro: "ESC :q ENTER", display: ":q", popup: {macro: "ALT g", display: "A-g"}}, \
+#  {macro: "CTRL d", display: "<C-𝚍>", popup: {macro: "ALT g", display: "A-g"}}, \
 #  {key: TAB, popup: {macro: "ALT a", display: A-a}}, \
 #  {macro: "CTRL r", display: "<C-𝚛>", popup: {macro: ",h", display: "buffp"}}, \
 #  {key: UP, popup: {macro: "CTRL u", display: "<C-u>"}}, \
@@ -134,8 +153,8 @@ extra-keys = [ \
 #  {key: UP, display: "", popup: {macro: ",l", display: "buffn"}} \
 # ], \
 # [ \
-#  {key: KEYBOARD, display: ""}, \
-#  {key: KEYBOARD, display: "⌨️", popup: {macro: "CTRL d", display: exit}}, \
+#  {key: KEYBOARD, popup: 'KEYBOARD'}, \
+#  {key: KEYBOARD, popup: {macro: "CTRL d", display: "exit"}}, \
 #  {key: ALT, popup: {macro: "CTRL f TAB", display: "tmux →"}}, \
 #  {macro: "CTRL o d CTRL d", display: "DTX", popup: {macro: "CTRL p n", display: "newpn"}}, \
 #  {macro: "lsd SPACE -l ENTER", display: "lsd -l", popup: {macro: "lsd SPACE -la ENTER", display: "lsd -la"}}, \
@@ -152,7 +171,7 @@ extra-keys = [ \
 #  {key: LEFT, popup: {macro: "ALT h", display: "buffp"}}, \
 #  {key: DOWN, popup: {macro: "CTRL d", display: "<C-d>"}}, \
 #  {key: RIGHT, popup: {macro: "ALT l", display: "buffn"}}, \
-#  {key: RIGHT, display: "", popup: {macro: ",l", display: "buffn"}} \
+#  {key: RIGHT, popup: {macro: ",l", display: "buffn"}} \
 # ] \
 # ]
 # {macro: ENTER, display: "<CR>"}, \
@@ -161,38 +180,27 @@ extra-keys = [ \
 #  {key: ESC, popup: {macro: "CTRL f d", display: "tmux exit"}}, \
 #  {key: CTRL, popup: {macro: "CTRL f BKSP", display: "tmux ←"}}, \
 #  {key: ALT, popup: {macro: "CTRL f TAB", display: "tmux →"}}, \
-#  {key: TAB, popup: {macro: "ALT a", display: A-a}}, \
+#  {key: TAB, popup: {macro: "ALT a", display: "A-a"}}, \
 #  {key: LEFT, popup: HOME}, \
 #  {key: DOWN, popup: PGDN}, \
 #  {key: UP, popup: PGUP}, \
 #  {key: RIGHT, popup: END}, \
 #  {key: ESC, popup: {macro: "CTRL f d", display: "tmux exit"}}, \
-#  # {macro: "ALT j", display: A-j, popup: {macro: "ALT g", display: A-g}}, \
-#  {key: KEYBOARD, popup: {macro: "CTRL d", display: exit}} \
+#  # {macro: "ALT j", display: A-j, popup: {macro: "ALT g", display: "A-g"}}, \
+#  {key: KEYBOARD, popup: {macro: "CTRL d", display: "exit"}} \
 # ]]
 
-###############
-# Colors/themes
-###############
 
-### Force black colors for drawer and dialogs
-# use-black-ui = true
 
 ###############
 # Keyboard shortcuts
 ###############
 
-### Open a new terminal with ctrl + t (volume down + t)
-# shortcut.create-session = ctrl + t
-
-### Go one session down with (for example) ctrl + 2
-# shortcut.next-session = ctrl + 2
-
-### Go one session up with (for example) ctrl + 1
-# shortcut.previous-session = ctrl + 1
-
-### Rename a session with (for example) ctrl + n
-# shortcut.rename-session = ctrl + n
+### Force system overrides for clean session control
+# shortcut.create-session = ctrl+t
+# shortcut.next-session = ctrl+2
+# shortcut.previous-session = ctrl+1
+# shortcut.rename-session = ctrl+n
 
 ###############
 # Bell key
@@ -203,7 +211,6 @@ extra-keys = [ \
 
 ### Beep with a sound.
 # bell-character = beep
-bell-character = beep
 
 ### Ignore bell character.
 # bell-character = ignore
@@ -216,25 +223,4 @@ bell-character = beep
 # back-key=escape
 
 ### Hide keyboard or leave app (default).
-# back-key=back
-
-###############
-# Keyboard issue workarounds
-###############
-
-### Letters might not appear until enter is pressed on Samsung devices
-# enforce-char-based-input = true
-# enforce-char-based-input = true
-
-### ctrl+space (for marking text in emacs) does not work on some devices
-# ctrl-space-workaround = true
-terminal-margin-horizontal=0
-terminal-margin-vertical=0
-
-terminal-cursor-blink-rate=100
-
-allow-external-apps = true
-
-volume-keys = volume
-
-# terminal-onclick-url-open = true
\ No newline at end of file
+back-key = hide keyboard
-- 
2.55.0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment