{"id":26926582,"url":"https://github.com/aalaqily/termux-clock","last_synced_at":"2026-02-10T09:02:15.673Z","repository":{"id":259568774,"uuid":"864890085","full_name":"aalaqily/termux-clock","owner":"aalaqily","description":"\u003e_ Termux tool to set alarms \u0026 timers headlessly.","archived":false,"fork":false,"pushed_at":"2024-12-15T10:48:49.000Z","size":167,"stargazers_count":2,"open_issues_count":5,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T15:18:01.496Z","etag":null,"topics":["rootless","termux","termux-tool","wip"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aalaqily.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-29T12:48:53.000Z","updated_at":"2025-02-21T18:54:34.000Z","dependencies_parsed_at":"2025-03-12T15:28:08.928Z","dependency_job_id":null,"html_url":"https://github.com/aalaqily/termux-clock","commit_stats":null,"previous_names":["iahmadgad/termux-clock","aalaqily/termux-clock"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalaqily%2Ftermux-clock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalaqily%2Ftermux-clock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalaqily%2Ftermux-clock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aalaqily%2Ftermux-clock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aalaqily","download_url":"https://codeload.github.com/aalaqily/termux-clock/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246752149,"owners_count":20827981,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rootless","termux","termux-tool","wip"],"created_at":"2025-04-02T03:33:37.242Z","updated_at":"2026-02-10T09:02:15.666Z","avatar_url":"https://github.com/aalaqily.png","language":"Rust","readme":"# Termux Clock\n[![WIP](https://img.shields.io/badge/%F0%9F%9B%A0-WIP-cyan)](#)\n[![GitLab: mirror](https://img.shields.io/badge/GitLab-mirror-blue?labelColor=black\u0026logo=gitlab)](https://gitlab.com/aalaqily/termux-clock)\n[![Rust CI workflow](https://img.shields.io/github/actions/workflow/status/aalaqily/termux-clock/rust.yml?label=Rust%20CI\u0026logo=rust)](https://github.com/aalaqily/termux-clock/actions/workflows/rust.yml)\n[![Release workflow](https://img.shields.io/github/actions/workflow/status/aalaqily/termux-clock/release.yml?label=Release\u0026logo=github)](https://github.com/aalaqily/termux-clock/actions/workflows/release.yml)\n[![Lines of code](https://tokei.rs/b1/github/aalaqily/termux-clock?category=code\u0026label=Lines%20of%20code\u0026style=flat)](#)\n[![Latest Tag](https://img.shields.io/github/v/tag/aalaqily/termux-clock?label=Latest%20tag\u0026sort=semver)](https://github.com/aalaqily/termux-clock/tags)\n[![Downloads](https://img.shields.io/github/downloads/aalaqily/termux-clock/total?label=Downloads%20(GH))](https://github.com/aalaqily/termux-clock/releases)\n[![PRs: welcome](https://img.shields.io/badge/PRs-welcome-lemon)](https://github.com/aalaqily/termux-clock/fork)\n\nTermux tool to set alarms \u0026 timers headlessly.\n\n# Requirements\n- [Termux](https://github.com/termux/termux-app) \u003e= `0.118.1` _(this version solves issue termux/termux-app#3990)_\n- [Termux: API](https://github.com/termux/termux-api)\n- Termux packages: `termux-api`, `at`, `cronie`\n\n# Install\n\u003e [!IMPORTANT]\n\u003e both 2 methods install `termux-api` package not the Android app, which needs to be installed manually.\n\u003e Read [Installation](https://github.com/termux/termux-api?tab=readme-ov-file#installation) on `termux/termux-api` repo to know how to install the Android app.\n## Pre-built Termux packages\n- Navigate to [GitHub Releases](https://github.com/aalaqily/termux-clock/releases), and choose package with your desired version \u0026 phone architecture (run `uname -m` in termux to know your phone's architecture).\n- copy deb file url \u0026 download it using `wget` or `curl`.\n- Install the downloaded package with `apt`:\n```sh\napt install ./\u003cpackage\u003e.deb\n```\n## From source\n- Install dependencies\n```sh\npkg install termux-api at cronie\n```\n- Compile and install from the latest commit on `main` branch:\n```sh\ncargo install --force --git https://github.com/aalaqily/termux-clock\n```\n- Or from tag (recommended):\n```sh\ncargo install --force --git https://github.com/aalaqily/termux-clock --tag \u003ctag\u003e\n```\nSee [`cargo-install(1)`](https://doc.rust-lang.org/cargo/commands/cargo-install.html) for more `cargo install` options.\n# Development\n## Requirements \n- [just](https://github.com/casey/just) \u003e= `1.19.0` _(for modules feature)_\n- [yq](https://github.com/mikefarah/yq)\n- [cross](https://github.com/cross-rs/cross) _(in case you are not building on termux)_\n- [termux-create-package](https://github.com/termux/termux-create-package)\n- bash\n\nInstall just:\n```sh\ncargo install just\n```\nOther tools (except bash) will be installed automatically during build process, or when you use `install-tool` recipe.\n\nThe `install-tool` recipe is designed to run on an AMD64 Linux machine. If your system does not meet these requirements, it is recommended to install the tools manually.\n\n## Just recipes\nList recipes in `justfile`:\n```sh\njust --list\n```\nList recipes in module:\n```sh\njust --list \u003cmodule\u003e\n```\nJust recipes are located in `justfile` and `justmodules` directory.\n\nIf you don't know just recipes read [just documentation](https://just.systems/man/en/).\n\n# Manpages\nDeb packages comes with manpages for `termux-clock`, `termux-clock timer` and `termux-clock alarm`\n\nYou can read them by running:\n```sh\nman termux-clock\nman termux-clock-timer\nman termux-clock-alarm\n```\n\nYou can also build these manpages from source with `man` recipe:\n```sh\njust man\n```\nOr with `build-man` [xtask](https://github.com/matklad/cargo-xtask) (but ensure you are in the project root directory):\n```sh\ncargo build-man\n```\n\nGenerated manpages are located in: `target/manpages`\n\n# Usage\n## `timer`\n| Option | Description |\n| ------ | ----------- |\n| `-H, --hours \u003cHOURS\u003e` | add hours to timer length. |\n| `-M, --minutes \u003cMINUTES\u003e` | add minutes to timer length. |\n| `-S, --seconds \u003cSECONDS\u003e` | add seconds to timer length. |\n| `-m, --message \u003cMESSAGE\u003e` | timer message. |\n| `-v, --vibrate` | enable vibration. _(not available in android timers, so use it with `--termux` option)_. |\n| `-t, --termux` | set timer in termux instead of android alarm clock. |\n### Example\n```sh\ntermux-clock timer -M 1 -S 30 -t -m \"Timer for 1 minute and 30 seconds in Termux\"\n```\n## `alarm`\n| Option | Description |\n| ------ | ----------- |\n| `-H, --hour \u003cHOUR\u003e` | alarm hour. |\n| `-M, --minutes \u003cMINUTES\u003e` | alarm extra minutes. |\n| `-d, --days \u003cDAYS\u003e` | days to recurr the alarm, denoted by comma-seperated numbers (e. g. `1,2,3`), where each number corresponds to a weekday, starting from sunday (i. e. sunday is `1`, monday is `2` and so on and so forth). |\n| `-m, --message \u003cMESSAGE\u003e` | alarm message. |\n| `-v, --vibrate` | enable vibration. |\n| `-t, --termux` | set alarm in termux instead of android alarm clock. |\n| `--pm` | set alarm hour in pm instead of am. |\n### Example\n```sh\ntermux-clock alarm -H 6 -M 30 -d 1,2,3 -v -m \"Alarm at 06:30 am 🕡 every Sunday, Monday and Tuesday with vibration enabled 📳\"\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faalaqily%2Ftermux-clock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faalaqily%2Ftermux-clock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faalaqily%2Ftermux-clock/lists"}