Frogtab Help

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

Overview of Frogtab

Today is your to-do list for today. Begin the day by writing down everything you'd like to accomplish. Delete your tasks as you complete 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:

• Moves any remaining tasks from Today to your inbox
• Unsnoozes any snoozed tasks in your inbox
• Adds tasks from your weekly routine to your inbox

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.

As an alternative to editing your inbox, you can use Send to Frogtab or the frogtab command to add tasks to your inbox. Sending a task to Frogtab is great if you want to capture the task without revealing your inbox (e.g., during a meeting).

To send tasks to Frogtab 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:

• Complete the task immediately, then delete it.

• Move the task to Today if you plan to work on it later the same day.

• Snooze the task by writing # in front of the task:

  Frogtab will unsnooze the task at the beginning of the next day.

• Move the task to a more appropriate location outside Frogtab (e.g., a calendar event or a topic in a meeting agenda).

• Delete the task if it's not particularly important.

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.

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 delete 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.

Registering for a personal link

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.

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:

• Anyone who knows your personal link can send tasks to your inbox.

• Tasks may take up to 10 minutes to appear in your inbox. To force Frogtab to check for new tasks, reload Frogtab.

• If you clear your browsing data, your personal link will stop working. To reactivate your personal link, import your Frogtab data (assuming that you've previously exported a backup). Or you can re-register this device and get a new personal link.

Overview of data privacy

Frogtab stores the following data that you create:

• The contents of Today and Inbox
• Recurring tasks from your weekly routine
• Your completed tasks (part of the Achievements feature)

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.

Your data is stored in your browser and isn't sent to a server. Your data is automatically backed up by Frogtab Local. 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:

• When you use your personal link to send a task to Frogtab, the task is first encrypted on the sending device. The encrypted task is then sent to the server.

• Only this device is permitted to download the encrypted task from the server. After downloading the encrypted task, Frogtab decrypts the task using a private key that never leaves this device.

• The server deletes the encrypted task as soon as it has been downloaded.

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.

Your data is stored in your browser and is automatically backed up by Frogtab Local. To get the location of the backup file, run frogtab find-backup.

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.

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.

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

• If you haven't completed any tasks in Frogtab, click Import at the top of the Achievements page, then select a todo.txt file.

• If you have completed some tasks in Frogtab, you'll need to manually merge your Frogtab completed tasks with your completed tasks from outside Frogtab.

  Click Edit at the top of the Achievements page, then click Export a todo.txt file. The todo.txt file contains your Frogtab completed tasks. Edit the todo.txt file to include your completed tasks from outside Frogtab, then click Import the todo.txt file and select the updated todo.txt file.

Keyboard shortcuts

macOS Windows/Linux

For Send to Frogtab and your personal link:

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.

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