How to Set a Daily Reminder Notification Using Termux:API

Are you tired of forgetting your daily tasks, study goals, or hydration breaks? What if you could turn your Android phone into a powerful, automated personal assistant using only a command-line interface? Welcome to termuxgenius.com, where we help you master your terminal. Today, we are looking at how to set a daily reminder notification using Termux:API.

Automating your mobile device doesn't require expensive apps or bloated software. By combining the Termux terminal emulator with the Termux:API package and a scheduling tool, you can create a reliable, lightweight notification system that runs right on your phone. In this comprehensive guide, we will walk you through everything from installation to writing a termux daily reminder script, explaining every line of code, and setting it up to run automatically every single day.

Quick Summary: What You Need to Know

If you want a quick overview of how this system works, here is the short answer. To trigger native Android notifications from a shell script, you must install Termux, download the Termux:API app from an official source like F-Droid or Google Play, and install the corresponding package inside your terminal. Then, you write a bash script utilizing the termux-notification command and schedule it using a cron job or a looping background process.

• Primary Requirement: Termux and Termux:API app + package.
• Core Command: termux-notification
• Automation Method: Cron jobs or background loops.
• Primary Keyword Target: How to Set a Daily Reminder Notification Using Termux:API
• Long-tail Keyword Target: termux-notification schedule daily

Understanding the Core Tools

Before writing any code, let's define what we are working with. Understanding your tools makes troubleshooting much easier later on.

What is Termux?

Termux is an Android terminal emulator and Linux environment app that works directly with no rooting required. It provides a minimal base system automatically, and additional packages are available using the APT package manager.

What is Termux:API?

Termux:API is an add-on app that exposes device hardware and system features to the command line. It lets you send SMS messages, control audio volume, get your location, and—most importantly for our guide—trigger native Android notifications straight from a bash script.

Prerequisites and Installation

Let's get your environment ready. Follow these steps carefully to ensure your system can execute the scripts properly.

1. Install the main Termux app from F-Droid (recommended for up-to-date packages) or Google Play.
2. Install the Termux:API app from the same source where you downloaded the main Termux app. (Note: Both apps must be installed from the same source to communicate correctly).
3. Open Termux and update your package lists by running the following command:

   pkg update && pkg upgrade -y

4. Install the Termux API package inside your terminal:

   pkg install termux-api -y

To test if your setup works, type this simple command into your terminal and press enter:

termux-notification --title "Test" --content "Termux API is working!"

If your phone pops up a notification with that title and content, you are ready to build the daily reminder script.

Comparison of Automation Methods

When looking at how to schedule tasks in Termux, users usually choose between two popular methods. Here is how they compare:

Method	Pros	Cons
Termux-Job-Scheduler (termux-job-scheduler)	Native Android job scheduler integration; battery efficient.	Can be restrictive depending on Android battery optimization settings and OS version.
Background Loop / Cron	Simple to implement; highly customizable timing.	Requires Termux to have background wakelocks enabled to prevent the CPU from sleeping.

The Full Working Script: termux daily reminder script

Here is your copy-paste ready script. This script sends a reminder notification directly to your notification shade. Create a file named reminder.sh using a text editor like nano or by echoing the contents directly.

#!/data/data/com.termux/files/usr/bin/bash

# ==========================================
# Script Name: termux daily reminder script
# Description: Sends a custom daily notification
# ==========================================

# Define notification variables
TITLE="Daily Reminder"
CONTENT="Time to check your goals and keep your streak alive!"
ID="101"

# Execute the termux-notification command
termux-notification \
    --id "$ID" \
    --title "$TITLE" \
    --content "$CONTENT" \
    --priority high \
    --sound

Line-by-Line Explanation of the Script

Every line in our script serves a specific purpose. Let's break down how it works:

• #!/data/data/com.termux/files/usr/bin/bash: This is the shebang line. It tells the Android system which interpreter to use to execute the file—in this case, the Bash shell located within the Termux directory structure.
• TITLE="Daily Reminder": This line creates a bash variable holding the title text that will appear in bold at the top of your Android notification card.
• CONTENT="...": This variable stores the body message of your reminder. You can change this text to anything you want, such as a reminder to study, code, or hydrate.
• ID="101": This assigns a unique numeric ID to the notification. Setting an ID allows future script runs to update the existing notification instead of stacking multiple duplicate alerts on your screen.
• termux-notification \: This is the primary command called from the Termux:API package. The backslash at the end allows the command to span multiple lines for better readability.
• --id "$ID": Passes our notification ID variable into the command.
• --title "$TITLE": Passes the title variable into the notification header.
• --content "$CONTENT": Passes the content variable into the notification body.
• --priority high: Tells the Android system to display the notification with high importance, which usually makes it pop up on your screen even if your phone is busy.
• --sound: Tells the device to play your default notification sound when the alert arrives.

How to Make the Script Executable

Before you can run your script, you need to grant it execution permissions. Open your terminal in the directory where you saved your script (for example, your home directory) and run:

chmod +x reminder.sh

You can test the script manually anytime by running:

./reminder.sh

How to Auto-Run It: termux-notification schedule daily

Writing the script is only half the battle. To truly make it a termux-notification schedule daily workflow, you need the system to execute it automatically without manual intervention.

Because Android aggressively kills background processes to save battery life, the most reliable way to keep scripts running in Termux is to acquire a wake lock and use a simple background sleep loop or crontab.

Step 1: Acquire a Wakelock

Run this command in Termux to prevent Android from putting your CPU to sleep:

termux-wake-lock

Note: You will see a persistent notification from Termux indicating that a wake lock is active. This is normal and necessary for reliable background execution.

Step 2: Setting Up a Daily Loop Script

Create a scheduler script named scheduler.sh:

#!/data/data/com.termux/files/usr/bin/bash

while true; do
    # Run the reminder script
    ./reminder.sh
    
    # Sleep for 24 hours (86400 seconds)
    sleep 86400
done

Make the scheduler executable:

chmod +x scheduler.sh

To run this in the background even if you close the Termux window, use nohup:

nohup ./scheduler.sh > /dev/null 2>&1 &

Safety and Legal Considerations

When running automated scripts on mobile devices, keeping system resources managed and respecting privacy is important. Here are a few safety notes to keep in mind:

• Battery Drain: Keeping a perpetual background loop running with wake locks active will consume more battery power than a standard idle state. Monitor your device temperature and battery usage.
• Permissions: Only grant Termux and Termux:API the permissions they need to function. Do not execute scripts downloaded from untrusted internet sources without reviewing every line of code first.
• Local Execution: Termux scripts run locally on your device storage. They do not transmit your reminder content to external servers unless you explicitly configure a script to interact with a web API.

Common Mistakes to Avoid

Even experienced users run into occasional roadblocks. Avoid these frequent pitfalls:

• Mismatched App Sources: Installing Termux from F-Droid while installing Termux:API from the Google Play Store (or vice versa) will cause communication errors. Both apps must come from the same repository.
• Missing Executable Permissions: Forgetting to run chmod +x on your bash scripts will result in "Permission denied" errors when you try to execute them.
• Ignoring Battery Optimization: If Android's battery saver kills Termux background processes, your scheduled notifications will not trigger. Make sure to exclude Termux from battery optimization settings in your Android system settings.
• Incorrect Paths: Always check your working directory or use absolute paths when calling scripts from background tasks.

Expert Tips for Advanced Users

Want to take your Termux reminders to the next level? Try these expert tips:

• Dynamic Content: Modify your reminder.sh script to fetch a random motivational quote or the current weather using curl before passing it into the termux-notification command.
• Action Buttons: Use the --button1 flag in termux-notification to add interactive buttons directly to your notification card, letting you run secondary scripts with a single tap.
• Log Output: Always redirect error outputs to a log file during testing (e.g., ./scheduler.sh > log.txt 2>&1 &) so you can debug issues if a notification fails to fire.

Frequently Asked Questions (FAQs)

1. Do I need a rooted phone to use Termux:API notifications?

No, root access is not required. Termux and Termux:API operate within standard Android application sandboxes and use system intents to trigger notifications.

2. Why are my notifications stopping after a few hours?

This is usually caused by Android's aggressive battery management. Ensure you have run termux-wake-lock and disabled battery optimization for Termux in your Android system settings.

3. Can I schedule notifications for an exact time of day using this method?

Yes. While a simple sleep loop runs at fixed intervals from the start time, you can also install cron packages (like cronie) inside Termux to schedule tasks for exact hours and minutes.

4. How do I stop the background scheduler script?

You can find the process ID of your running script by typing ps aux | grep scheduler.sh and then terminating it using the kill [PID] command.

Conclusion

Setting up automated daily reminders using your Android terminal is a fantastic way to boost productivity while learning the fundamentals of shell scripting. By following this guide, you have installed Termux:API, built a custom termux daily reminder script, learned how to execute it reliably, and avoided common pitfalls like battery optimization limits.

Ready to explore more advanced terminal automation projects? Browse through our other tutorials and guides here at termuxgenius.com to unlock the full potential of your mobile device.