git404hub

what is taskwarrior-tnt fr?

catanadj/taskwarrior-tnt — explained in plain English

Analysis updated 2026-05-18

1ShellAudience · developerComplexity · 3/5Setup · moderate

tl;dr

Shell scripts that connect Taskwarrior to Android via Termux and Tasker, posting due-task notifications with start, stop, done, and snooze actions.

vibe map

mindmap
  root((taskwarrior-tnt))
    What it does
      Due-task notifications
      Start Stop Done actions
      Snooze to tomorrow
      Quiet hours
    Tech stack
      Shell
      Termux
      Tasker
      Taskwarrior
    Use cases
      Mobile task reminders
      Time tracking via jot
      Optional GUI dashboard
    Audience
      Termux users
      Taskwarrior users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Get Android notifications for Taskwarrior tasks due within a configurable time window.

VIBE 2

Start, stop, complete, or snooze tasks directly from a phone notification.

VIBE 3

Track task time with optional jot timelog integration triggered by notification actions.

what's the stack?

ShellTermuxTaskerTaskwarriorPython

how it stacks up fr

catanadj/taskwarrior-tnt100/dotfilesadams549659584/my-openwrt-actions
Stars111
LanguageShellShellShell
Last pushed2016-11-182020-06-06
MaintenanceDormantDormant
Setup difficultymoderateeasyhard
Complexity3/51/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Termux, Termux:API, and a Tasker profile configured to run the notification script on a schedule.

License terms are not stated in the README.

in plain english

Taskwarrior TNT brings Android notifications to Taskwarrior, the command line task manager, by connecting it to Termux and Tasker on your phone. The name stands for Termux Notifications through Tasker. It is a set of shell scripts that scan your pending Taskwarrior tasks and post a notification for each one that is due around the current time, by default anything due from two hours ago through two hours from now. Each notification includes buttons right in the notification itself: you can start or stop time tracking on a task, mark it done, or push it to tomorrow, all without opening a terminal. Notifications are labeled OVERDUE, SOON, NOW, DUE, or ACTIVE depending on timing, and show the task's time window along with its project and tags. Setting it up means installing a few Termux packages, including Taskwarrior itself and the Termux:API app for posting notifications, then running the included install script, which copies the scripts into place and checks that everything works. From there, you create a Tasker profile that runs on a schedule, such as every 15 or 30 minutes, and points at the notification script, the script talks to Android directly, so no separate Tasker notification action is needed. Behavior is controlled through a configuration file covering things like the notification time window, quiet hours where the scan still runs but stays silent, notification icons and priority, and how snoozing or marking a task for tomorrow behaves. There is also optional integration with a time-logging tool called jot, and an optional graphical dashboard through Termux:GUI for people who want a visual view alongside the notifications. A built in doctor mode and dry run option help troubleshoot setups where notifications are not appearing as expected.

prompts (copy fr)

prompt 1
Write a shell script that scans Taskwarrior tasks due within a time window and posts Android notifications via Termux:API.
prompt 2
How do I set up a scheduled Tasker profile to run a Termux shell script every 15 minutes?
prompt 3
Explain how to add interactive action buttons to an Android notification triggered from a shell script.
prompt 4
Design a config file format for controlling notification quiet hours and priority in a shell-based tool.

Frequently asked questions

what is taskwarrior-tnt fr?

Shell scripts that connect Taskwarrior to Android via Termux and Tasker, posting due-task notifications with start, stop, done, and snooze actions.

What language is taskwarrior-tnt written in?

Mainly Shell. The stack also includes Shell, Termux, Tasker.

What license does taskwarrior-tnt use?

License terms are not stated in the README.

How hard is taskwarrior-tnt to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is taskwarrior-tnt for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.