Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/termux/termux-boot
Termux add-on app allowing programs to be run at boot.
https://github.com/termux/termux-boot
android termux
Last synced: 6 days ago
JSON representation
Termux add-on app allowing programs to be run at boot.
- Host: GitHub
- URL: https://github.com/termux/termux-boot
- Owner: termux
- Created: 2016-12-29T00:03:51.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2024-03-07T17:54:57.000Z (11 months ago)
- Last Synced: 2024-04-13T21:41:33.748Z (10 months ago)
- Topics: android, termux
- Language: Java
- Homepage: https://f-droid.org/en/packages/com.termux.boot
- Size: 270 KB
- Stars: 807
- Watchers: 83
- Forks: 207
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-android-root - Termux:Boot - Run scripts at device boot. `FOSS` (Root Apps / Termux)
- awesome-android-root - Termux:Boot - Run scripts at device boot. `FOSS` (Root Apps / Termux)
README
# Termux:Boot
[](https://github.com/termux/termux-boot/actions)
[](https://gitter.im/termux/termux)
A [Termux](https://termux.dev) add-on app to run programs at boot.
When developing (or packaging), note that this app needs to be signed with the
same key as the main Termux app in order to have the permission to execute scripts.
## Installation
Termux:Boot application can be obtained from [F-Droid](https://f-droid.org/en/packages/com.termux.boot/).
Additionally we provide per-commit debug builds for those who want to try
out the latest features or test their pull request. This build can be obtained
from one of the workflow runs listed on [Github Actions](https://github.com/termux/termux-boot/actions/workflows/github_action_build.yml?query=branch%3Amaster+event%3Apush)
page.
Signature keys of all offered builds are different. Before you switch the
installation source, you will have to uninstall the Termux application and
all currently installed plugins. Check https://github.com/termux/termux-app#Installation for more info.
## How to use
1. Install the Termux:Boot app.
2. Start the Termux:Boot app once by clicking on its launcher icon. This allows the app to be run at boot.
3. Create the `~/.termux/boot/` directory.
4. Put scripts you want to execute inside the `~/.termux/boot/` directory. If there are multiple files, they will be executed in a sorted order.
5. Note that you may want to run `termux-wake-lock` as first thing if you want to ensure that the device is prevented from sleeping.
### Examples
To start an sshd server and prevent the device from sleeping at boot,
create the following file at `~/.termux/boot/start-sshd`:
```sh
#!/data/data/com.termux/files/usr/bin/sh
termux-wake-lock
sshd
```
To start
[termux-services](https://wiki.termux.com/wiki/Termux-services), which
in turn starts enabled services, you can put the following in
`~/.termux/boot/start-services`:
```sh
#!/data/data/com.termux/files/usr/bin/sh
termux-wake-lock
source /data/data/com.termux/files/usr/etc/profile.d/start-services.sh
```
## License
Released under [the GPLv3 license](https://www.gnu.org/licenses/gpl.html).