Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hreikin/termux-dev-setups
An easy to use script for installation of a simple developer setup in termux.
https://github.com/hreikin/termux-dev-setups
code-oss code-server developer-setup termux termux-desktop termux-xfce
Last synced: 23 days ago
JSON representation
An easy to use script for installation of a simple developer setup in termux.
- Host: GitHub
- URL: https://github.com/hreikin/termux-dev-setups
- Owner: hreikin
- License: mit
- Created: 2023-01-01T20:22:52.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-02-08T16:29:00.000Z (over 1 year ago)
- Last Synced: 2024-03-15T23:54:43.805Z (8 months ago)
- Topics: code-oss, code-server, developer-setup, termux, termux-desktop, termux-xfce
- Language: Shell
- Homepage:
- Size: 28.3 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Termux Developer Setups
An easy to use script for installation of a simple developer setup in termux.
## Requirements
- No root permission is required to make this work
- Android 7+ phone
- VNC or Xserver client on phone (bVNC or XserverXSDL)
- Termux installed from F-Droid
- TermuxAPI installed from F-Droid
> **NOTE**: Termux from Google Play is unmaintained due to API requirements, please use F-Droid instead.
## Installation
To start the installation follow the steps below.
```
pkg update -y && pkg upgrade -y
pkg install wget
wget https://raw.githubusercontent.com/hreikin/termux-dev-setups/main/install.sh
chmod +x install.sh
./install.sh
```
### Installation Options
- **Minimal** - A minimal installation with `code-server` and the `Micro` code editor installed.
- **Desktop (VNC)** - An XFCE desktop environment accessible via VNC with everything from the Minimal install plus `code-oss`, `leafpad` and `firefox` installed.
- **Desktop (Xserver)** - An XFCE desktop environment accessible via Xserver with everything from the Minimal install plus `code-oss`, `leafpad` and `firefox` installed.
## Usage
Below are some basic usage examples for each type of installation.
### Minimal
To start code-server use the following command:
```
code-server &
```
This will run code-server in the background and generate a default config.yaml file on first run. The password used to access code-server in the browser can be found using the config.yaml file available at:
```
~/.config/code-server/config.yaml
```
Next open a browser on Android (I recommend Kiwi Browser if doing Web Development because it comes with the developer console but Firefox, Chrome, etc will work perfectly as well.) and go to the following address:
```
https//127.0.0.1:8080
```
### Desktop (VNC)
To view the installed desktop you will need to use a VNC viewer installed on Android. I recommend bVNC.
To start the VNC server use the following command:
```
vncserver
```
To view running VNC servers use the following command:
```
vncserver -list
```
To stop a VNC server running on display 1 use the following command:
```
vncserver -kill :1
```
### Desktop (Xserver)
To view the installed desktop you will need to use an Xserver
client installed on Android. I recommend Xserver XSDL.
To start the XFCE desktop run one of the following commands:
```
startxfce4 &
xfce4-session &
```
Then open your Xserver app on Android to view the desktop.
You can also launch single applications such as code-oss or firefox like so:
```
xfwm4 & code-oss
xfwm4 & firefox
```
### Post Installation
The script `post-install.sh` is a small convenience script which handles a few tasks such as:
- Configuring git user.name
- Configuring git user.email
- Configuring git core.editor to use `nano`
- Generate an SSH key and add it to the SSH agent
To use it once you have succesfully installed your developer setup run the following commands:
```
wget https://raw.githbusercontent.com/hreikin/termux-dev-setups/main/post-install.sh
chmod +x post-install.sh
./post-install.sh
```