Skip to content

Commit 6065365

Browse files
committed
Splits extra_keys into two parts
1 parent 602b8b7 commit 6065365

File tree

3 files changed

+49
-48
lines changed

3 files changed

+49
-48
lines changed

docs/termux/customisation/extra_keys.md

Lines changed: 0 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,5 @@
11
hero: Adding Extra Keys on the touch keyboard
22

3-
## Understanding Keys on Termux and Shortcuts
4-
You might have noticed that the keyboard at the bottom of the screen has some pretty useful keys by default!
5-
These are `ESC`, `TAB`, `CTRL`, `ALT`, `-`, `DOWN` and `UP`.
6-
7-
But you can always edit these if you want to!
8-
9-
Use of keys like `ALT`, `CTRL`, `ESC` is necessary for working with a CLI terminal.
10-
Termux touch keyboards do not include one.
11-
For that purpose Termux uses the Volume down button to emulate the `CTRL` key.
12-
For example, pressing `VOLUME DOWN+L` on a touch keyboard sends the same input
13-
as pressing Ctrl+L on a hardware keyboard.
14-
15-
The result of using `CTRL` in combination with a key depends on which program is used, but for many command line tools the following shortcuts works:
16-
17-
* `CTRL+A` → Move cursor to the beginning of line
18-
* `CTRL+C` → Abort (send SIGINT to) current process
19-
* `CTRL+D` → Logout of a terminal session
20-
* `CTRL+E` → Move cursor to the end of line
21-
* `CTRL+K` → Delete from cursor to the end of line
22-
* `CTRL+L` → Clear the terminal
23-
* `CTRL+Z` → Suspend (send SIGTSTP to) current process
24-
* `CTRL+ALT+C` → Open new session (only work in Hacker's Keyboard)
25-
26-
The Volume up key also serves as a special key to produce certain input:
27-
28-
* `VOLUME UP+E` → Escape key
29-
* `VOLUME UP+T` → Tab key
30-
* `VOLUME UP+1` → F1 (and Volume Up+2 → F2, etc)
31-
* `VOLUME UP+0` → F10
32-
* `VOLUME UP+B` → Alt+B, back a word when using readline
33-
* `VOLUME UP+F` → Alt+F, forward a word when using readline
34-
* `VOLUME UP+X` → Alt+X
35-
* `VOLUME UP+W` → Up arrow key
36-
* `VOLUME UP+A` → Left arrow key
37-
* `VOLUME UP+S` → Down arrow key
38-
* `VOLUME UP+D` → Right arrow key
39-
* `VOLUME UP+L` → | (the pipe character)
40-
* `VOLUME UP+H` → ~ (the tilde character)
41-
* `VOLUME UP+U` → _ (underscore)
42-
* `VOLUME UP+P` → Page Up
43-
* `VOLUME UP+N` → Page Down
44-
* `VOLUME UP+.` → Ctrl+\ (SIGQUIT)
45-
* `VOLUME UP+V` → Show the volume control
46-
* `VOLUME UP+Q` → Show extra keys view
47-
* `VOLUME UP+K` → Another variant to toggle extra keys view
48-
49-
503
## Adding extra keys
514

525
Termux also has an extra keys view which allows you to extend your current keyboard.
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
hero: Various Keyboard Shortcuts for Termux
2+
3+
## Understanding Keys on Termux and Shortcuts
4+
You might have noticed that the keyboard at the bottom of the screen has some pretty useful keys by default!
5+
These are `ESC`, `TAB`, `CTRL`, `ALT`, `-`, `DOWN` and `UP`.
6+
7+
But you can always edit these if you want to!
8+
9+
Use of keys like `ALT`, `CTRL`, `ESC` is necessary for working with a CLI terminal.
10+
Termux touch keyboards do not include one.
11+
For that purpose Termux uses the Volume down button to emulate the `CTRL` key.
12+
For example, pressing `VOLUME DOWN+L` on a touch keyboard sends the same input
13+
as pressing Ctrl+L on a hardware keyboard.
14+
15+
The result of using `CTRL` in combination with a key depends on which program is used, but for many command line tools the following shortcuts works:
16+
17+
* `CTRL+A` → Move cursor to the beginning of line
18+
* `CTRL+C` → Abort (send SIGINT to) current process
19+
* `CTRL+D` → Logout of a terminal session
20+
* `CTRL+E` → Move cursor to the end of line
21+
* `CTRL+K` → Delete from cursor to the end of line
22+
* `CTRL+L` → Clear the terminal
23+
* `CTRL+Z` → Suspend (send SIGTSTP to) current process
24+
* `CTRL+ALT+C` → Open new session (only work in Hacker's Keyboard)
25+
26+
The Volume up key also serves as a special key to produce certain input:
27+
28+
* `VOLUME UP+E` → Escape key
29+
* `VOLUME UP+T` → Tab key
30+
* `VOLUME UP+1` → F1 (and Volume Up+2 → F2, etc)
31+
* `VOLUME UP+0` → F10
32+
* `VOLUME UP+B` → Alt+B, back a word when using readline
33+
* `VOLUME UP+F` → Alt+F, forward a word when using readline
34+
* `VOLUME UP+X` → Alt+X
35+
* `VOLUME UP+W` → Up arrow key
36+
* `VOLUME UP+A` → Left arrow key
37+
* `VOLUME UP+S` → Down arrow key
38+
* `VOLUME UP+D` → Right arrow key
39+
* `VOLUME UP+L` → | (the pipe character)
40+
* `VOLUME UP+H` → ~ (the tilde character)
41+
* `VOLUME UP+U` → _ (underscore)
42+
* `VOLUME UP+P` → Page Up
43+
* `VOLUME UP+N` → Page Down
44+
* `VOLUME UP+.` → Ctrl+\ (SIGQUIT)
45+
* `VOLUME UP+V` → Show the volume control
46+
* `VOLUME UP+Q` → Show extra keys view
47+
* `VOLUME UP+K` → Another variant to toggle extra keys view

mkdocs.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ nav:
2424
- Installation: termux/installation.md
2525
- Customisation:
2626
- Introduction: termux/customisation/index.md
27+
- Keyboard Shortcuts: termux/customisation/keyboard_shortcuts.md
2728
- Extra Keys: termux/customisation/extra_keys.md
2829
# - Python: termux/python.md
2930
- Help & Support: support.md
@@ -85,7 +86,7 @@ extra:
8586
link: https://instagram.com/__axvin__
8687
- icon: material/coffee
8788
link: https://ko-fi.com/AXVin
88-
version: 1.3
89+
version: 1.4
8990

9091
# Extensions
9192
markdown_extensions:

0 commit comments

Comments
 (0)