72 lines
2.3 KiB
Markdown
72 lines
2.3 KiB
Markdown
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
|
|
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
|
|
# Termux
|
|
|
|
- [Install](#install)
|
|
- [Upgrade](#upgrade)
|
|
- [Known Issues](#known-issues)
|
|
- [Search doesn't work](#search-doesnt-work)
|
|
- [Backspace doesn't work](#backspace-doesnt-work)
|
|
|
|
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
|
|
|
|
Termux is a terminal application and Linux environment that you can also use to
|
|
run code-server from your Android phone.
|
|
|
|
## Install
|
|
|
|
1. Install Termux from [F-Droid](https://f-droid.org/en/packages/com.termux/).
|
|
1. Make sure it's up-to-date: `apt update && apt upgrade`
|
|
1. Install required packages: `apt install build-essential python git nodejs-lts yarn`
|
|
1. Install code-server: `yarn global add code-server`
|
|
1. Run code-server: `code-server` and navigate to localhost:8080 in your browser
|
|
|
|
## Upgrade
|
|
|
|
To upgrade run: `yarn global upgrade code-server --latest`
|
|
|
|
## Known Issues
|
|
|
|
The following details known issues and suggested workarounds for using
|
|
code-server with Termux.
|
|
|
|
### Search doesn't work
|
|
|
|
There is a known issue with search not working on Android because it's missing
|
|
`bin/rg` ([context](https://github.com/cdr/code-server/issues/1730#issuecomment-721515979)). To fix this:
|
|
|
|
1. Install `ripgrep` with `pkg`
|
|
|
|
```sh
|
|
pkg install ripgrep
|
|
```
|
|
|
|
1. Make a soft link using `ln -s`
|
|
|
|
```sh
|
|
# run this command inside the code-server directory
|
|
ln -s $PREFIX/bin/rg ./vendor/modules/code-oss-dev/vscode-ripgrep/bin/rg
|
|
```
|
|
|
|
### Backspace doesn't work
|
|
|
|
When using Android's on-screen keyboard, the backspace key doesn't work
|
|
properly. This is a known upstream issue:
|
|
|
|
- [Issues with backspace in Codespaces on Android (Surface Duo)](https://github.com/microsoft/vscode/issues/107602)
|
|
- [Support mobile platforms](https://github.com/xtermjs/xterm.js/issues/1101)
|
|
|
|
There are two workarounds.
|
|
|
|
**Option 1:** Modify keyboard dispatch settings
|
|
|
|
1. Open the Command Palette
|
|
2. Search for **Preferences: Open Settings (JSON)**
|
|
3. Add `"keyboard.dispatch": "keyCode"`
|
|
|
|
The backspace button should work at this point.
|
|
|
|
_Thanks to @Nefomemes for the [suggestion](https://github.com/cdr/code-server/issues/1141#issuecomment-789463707)!_
|
|
|
|
**Option 2:** Use a Bluetooth keyboard.
|