Frogtab Help

Frogtab is a lightweight task manager that
helps you stay focused on today's priorities

Get Started

Thanks for exploring Frogtab! To get in touch, send a message or email me 🐸

Getting Started

Data & Privacy

Quick Reference

Overview of Frogtab

Today is your to-do list for today. Begin the day by writing down everything you'd like to accomplish. As you complete your tasks, simply delete them.

Inbox is where you can capture any thoughts or potential tasks that arise during the day. To learn more, see Adding tasks to your inbox.

You can triage your inbox later in the day. As you triage your inbox, you'll delete or snooze each task. To learn more, see Triaging your inbox.

Frogtab displays a notification badge to remind you to triage your inbox:

At the beginning of each day, Frogtab:

You can then triage your inbox and decide what you'd like to accomplish today.

Adding tasks to your inbox

Frogtab makes it easy to capture any thoughts or potential tasks that arise as you're working through your priorities for the day. You don't need to fill in lots of information when you capture a task - you can add the task to your inbox without getting distracted.

To add a task to your inbox, use either of the following methods:

These methods don't work from other devices. To send tasks from other devices, first register for a personal link.

Triaging your inbox

The purpose of triaging your inbox is to make a decision about how to act on each of the tasks that you've captured.

To triage your inbox, take one of the following actions for each task in your inbox:

As soon as you've triaged your inbox, Frogtab's notification badge disappears.

Setting up recurring tasks

If there are tasks that you usually do on the same day each week, Frogtab can add the tasks to your inbox at the beginning of the appropriate day.

To set up recurring tasks:

  1. Open Weekly Routine in a new tab.

  2. Select a day, then write down your recurring tasks for that day. For example:

    If you like planning in the evening, write down your recurring tasks under the previous day, with # in front of each task. For example:

    You'll then be able to see the recurring tasks one day in advance. When Frogtab adds the tasks to your inbox, they'll be snoozed (because of the #), so they won't cause Frogtab to display a notification badge.

After you've finished writing down your recurring tasks, close the tab.

Tracking your completed tasks

If you enable the Achievements feature, Frogtab can record your completed tasks.

You have not enabled Achievements.

You have enabled Achievements.

Review My Completed Tasks

Disable Achievements

Frogtab will disable Achievements when you click here.

Your completed tasks will be deleted.

To complete a task, put your cursor anywhere in the task, then press  + K (macOS) or Ctrl + K (Windows/Linux). Frogtab moves the task to your completed tasks.

When you complete a task, Frogtab sets the completion date to today's date. To control the completion date, use a completion command instead of  + K or Ctrl + K.

If you accidentally complete a task, you can mark it as incomplete and remove it from your completed tasks. Click Edit at the top of the Achievements page, select Today or Inbox as the new location for the task, then click the task to move it.

To import completed tasks from outside Frogtab, see Importing your data.

If you choose to register this device, you'll get a personal link that you can use to send tasks to Frogtab from any device.

Checking this device…

You have not registered this device with . To register this device, please share your experience of using Frogtab - thank you!

Learn about data privacy

Registering this device…

You have registered this device with .

Open My Personal Link

Learn about data privacy

Forget this device

Frogtab will forget this device when you click here.

Your personal link will be permanently deactivated. To send tasks to Frogtab from any device, you'll need to re-register this device and get a new personal link.

Forgetting this device…

If this device is registered, you'll see a cloud icon at the top of Frogtab. The cloud icon means that Frogtab is ready to receive tasks from your personal link.

More details about your personal link:

Overview of data privacy

Frogtab stores the following data that you create:

Your data is stored in your browser and isn't sent to a server. If you like, you can export a backup of your data. To learn more, see Exporting your data.

If you choose to register this device, you'll get a personal link that you can use to send tasks to Frogtab from any device. To learn more, see Registering for a personal link and Privacy implications of registering.

Frogtab doesn't use cookies, collect PII, serve ads, or track you in any way.

Privacy implications of registering

If you choose to register this device, Frogtab generates identification and encryption credentials for this device. The credentials are stored in your browser and are included if you export a backup of your data.

The credentials are also stored on a server, with the exception of a private key that Frogtab uses to decrypt tasks received from your personal link. You can delete the credentials from the server at any time. To delete the credentials, go to Registering for a personal link, then click Forget this device.

More details about how your personal link works:

For technical details, see How your personal link works in GitHub.

Exporting your data

Your data is stored in your browser. To export a backup of your data, click at the bottom of Frogtab, then click Export My Data.

Some browsers support automatic backups. If your browser supports automatic backups, click Enable Auto-Backup at the bottom of Frogtab, then specify where to save the backup file. Frogtab will update the backup file whenever your data changes.

If your browser doesn't support automatic backups, you won't see Enable Auto-Backup. If you want automatic backups, you'll need to run Frogtab Local on your computer.

To enable automatic backups, select a backup method:

As part of the Achievements feature, you can export your completed tasks in todo.txt format. To export your completed tasks, click Edit at the top of the Achievements page, then click Export a todo.txt file.

Importing your data

To restore your data in your browser, import a backup file.

Frogtab will restore your data from when you next reload Frogtab.

As part of the Achievements feature, you can import completed tasks in todo.txt format:

Keyboard shortcuts

Action Shortcut

Start a new line at the top

+ Enter Ctrl + Enter

Show Today

+ U Ctrl + U

Show Inbox

+ I Ctrl + I

Show Inbox and select all unsnoozed tasks

+ Shift + I Ctrl + Shift + I

Move selected tasks from Inbox to Today

If the tasks are snoozed, Frogtab unsnoozes them.

+ Shift + Enter Ctrl + Shift + Enter

Complete selected tasks

Part of the Achievements feature. Frogtab moves the tasks to your completed tasks.

+ K Ctrl + K

Snooze selected tasks

If the tasks are in Today, Frogtab moves them to Inbox.

+ / Ctrl + /

Toggle editing position between center and bottom

Also accessible via Snap to Bottom or Snap to Center from the menu. This feature is handy for making room for other windows, such as video calls.

+ B Ctrl + B

For Send to Frogtab and your personal link:

Action Shortcut

Send

+ Enter Ctrl + Enter

Completion commands

Completion commands are part of the Achievements feature. You can use completion commands to control the completion date when completing tasks.

To use a command, write the command in front of a task, then press Enter.

Command Example

x -n, where n is a number

Completes a task and sets the completion date to n days in the past.

To set the completion date of a task to yesterday's date, write x -1 in front of the task, then press Enter.

x day, where day is one of mon to sun

Completes a task and sets the completion date to day from the past week.

To set the completion date of a task to the most recent Friday, write x fri in front of the task, then press Enter.

Customizing the tab icon

Whenever Frogtab displays a notification badge, Frogtab tries to put a badge on the tab icon too. Some browsers (e.g., Safari) don't support this feature. If you want this feature, you'll need to use a workaround.

To enable the workaround, use this version of Frogtab. Frogtab will periodically reload itself to update the tab icon. When Frogtab reloads itself, your undo history will be lost. Frogtab will only reload itself when the tab isn't active.

If your browser supports Frogtab's default way of updating the tab icon, but you prefer no badge on the tab icon, you can use this version of Frogtab.

Changing the theme

Select a theme:

Sending tasks via a terminal

As an alternative to using Send to Frogtab, you can send tasks to Frogtab via a terminal. To enable this feature:

  1. Choose a label for Frogtab. For example, work or personal.

  2. Modify the URL of Frogtab to include the label. For example, http://127.0.0.1:5000/#work.

To send a task to Frogtab, use python send.py. For example:

python send.py work "Record a new product demo"

The task will appear in your inbox after a few seconds.

You can't use python send.py to send tasks from other devices. To send tasks from other devices, first register for a personal link, then make a command-line tool for your personal link.