Connect Happy Squid with Obsidian

Happy Squid Tasks enables you to block all unrelated websites and pages while working on a task. With the Happy Squid plugin for Obsidian, you can start a Task from any checkbox in your notes in one click. When you finish it in the Happy Squid extension or app, the checkbox in your note is ticked automatically. You can also bring your Task Goal and a summary of your day into any note.

Set up Obsidian Integration

You only do this once. Setting up the plugin takes about two minutes.

1. Make sure you have an active Happy Squid account. You need to be signed in on your computer in the Happy Squid browser extension or the desktop app. You'll find your email address in Happy Squid under Advanced Settings, then Account.

Happy Squid's Account settings, with the email address of the account highlighted.

2. In Obsidian, open Settings, choose Community plugins and click Exit Restricted mode. If you already use community plugins, you can skip this step.

Obsidian's settings open on Community plugins, with the Exit Restricted mode button highlighted.

3. Click Browse next to Community plugins.

Obsidian's Community plugins settings, with the Browse button highlighted.

4. Search for Happy Squid and click the plugin.

Obsidian's plugin directory searched for Happy Squid, with the Happy Squid plugin highlighted.

5. Click Install.

The Happy Squid plugin in Obsidian's plugin directory, with the Install button highlighted.

6. Click Enable. Obsidian opens a note called Happy Squid that shows what the plugin can do.

The Happy Squid plugin after installing, with the Enable button highlighted.

7. Click Options.

The Happy Squid plugin after enabling, with the Options button highlighted.

8. Enter the email address of your Happy Squid account and click Send code.

The Happy Squid plugin settings in Obsidian, with the email field and the Send code button highlighted.

9. Enter the 6-digit code we email you and click Verify.

The Happy Squid plugin settings in Obsidian, with the code field and the Verify button highlighted.

10. You're all set. Your email address now appears under Account.

The Happy Squid plugin settings in Obsidian, with the signed-in account and its Log out button highlighted.

Start and Finish Tasks from Obsidian

1. Write {task} at the end of any task in your notes. It turns into a start task button.

An Obsidian note called University with four tasks, the first of them ending in {task}, highlighted.

2. Click start task. It says starting… until Happy Squid has picked up your Task.

The University note, with the start task button next to Study aerodynamics for the exam highlighted.

3. Your Task appears in Happy Squid, usually within a few seconds, and the button in your note changes to stop task.

Happy Squid with the running Task Study aerodynamics for the exam highlighted above the blocks for instagram.com and youtube.com.

4. When you're done, tick the checkbox. The Task in Happy Squid ends within a few seconds. Clicking stop task ends the Task too, but leaves the checkbox open.

The University note with Study aerodynamics for the exam running, its checkbox highlighted.

5. You can also finish your Task in Happy Squid. Click the ✓ next to your Task.

Happy Squid with the running Task Email the tutor about the lab report, its check mark button highlighted.

6. Click Complete.

Happy Squid asking Do you want to complete your Task? Completing this Task will mark it completed in Obsidian, with the message and the Complete button highlighted.

7. Happy Squid ticks the checkbox in your note within a few seconds.

The University note, with Email the tutor about the lab report ticked and struck through.

Add Your Task Goal and Daily Summary

1. Write {taskgoal:today} on a line of its own. It shows how far along you are with your Task Goal, which you set in Happy Squid under Advanced Settings. Click the card to see the tasks you worked on that day.

An Obsidian daily note showing the Daily Task Goal card, highlighted, above the Daily Summary card.

2. Write {daysummary:today} to see how long you worked on tasks, how much Free Time you used and how often Happy Squid blocked you that day.

The Daily Summary card, highlighted, showing the day's time on tasks, Free Time and blocks.

Disconnect Happy Squid

1. In Obsidian, open Settings, choose Happy Squid under Community plugins and click Log out.

The Happy Squid plugin settings in Obsidian, with the Log out button highlighted.

2. To remove the plugin too, choose Community plugins, click ⋯ next to Happy Squid and choose Uninstall.

Obsidian's Community plugins settings, with the Happy Squid plugin's uninstall button highlighted.