Termux Clock

Termux tool to set alarms & timers headlessly.

Requirements

• Termux >= 0.118.1 (this version solves issue termux/termux-app#3990)
• Termux: API
• Termux packages: termux-api, at

Install

Important

both 2 methods install termux-api package not the Android app, which needs to be installed manually. Read Installation on termux/termux-api repo to know how to install the Android app.

Pre-built Termux packages

• Navigate to GitHub Releases, and choose package with your desired version & phone architecture.
• copy deb file url & download it using wget or curl.
• Install the downloaded package with apt:

apt install ./*.deb

From source

• Install dependencies

pkg install at termux-api

• Compile and install from the latest commit on main branch:

cargo install --force --git https://github.com/iahmadgad/termux-clock

• Or from tag (recommended):

cargo install --force --git https://github.com/iahmadgad/termux-clock --tag <tag>

See cargo-install(1) for more cargo install options.

Usage

timer

-l, --length <LENGTH>

timer length in seconds.

-m, --message <MESSAGE>

timer message.

-t, --termux

set timer in termux instead of android alarm clock.

Example

termux-clock timer -l 60 -m "Timer for 1 minute" -t

alarm

-H, --hour <HOUR>

alarm hour.

-M, --minutes <MINUTES>

alarm extra minutes.

-d, --days <DAYS>

Note

Not yet implemented in termux, so use it without --termux option.

days to recurr the alarm, denoted by space-seperated numbers between double quotes, e. g. "1 2 3", where each number corresponds to a weekday:

Weekday	Number
Sunday	1
Monday	2
Tuesday	3
Wednesday	4
Thursday	5
Friday	6
Saturday	7

-m, --message

alarm message.

-v, --vibrate <VIBRATE>

enable vibration, possible values: [true, false].

-t, --termux

set alarm in termux instead of android alarm clock.

Example

termux-clock alarm -H 6 -M 30 -m "Alarm at 06:30 🕡" -d "1 2 3" -v true