beeAlfred

Mind the 🐝 with Alfred!

A workflow to manage and update your Beeminder goals with Alfred.

<a href="https://github.com/giovannicoppola/beeAlfred/releases/latest/">

<img alt="Downloads" src="https://img.shields.io/github/downloads/giovannicoppola/beeAlfred/total?color=purple&label=Downloads"><br/> </a>

<!-- MarkdownTOC autolink="true" bracket="round" depth="3" autoanchor="true" -->

• Setting up
• Usage
• Known Issues
• Acknowledgments
• Changelog
• Feedback

<!-- /MarkdownTOC --> <h1 id="setting-up">Setting up beeAlfred ⚙️</h1>

1. Download beeAlfred from Github and double-click to install

2. Get your Beeminder Auth Token

   • in Beeminder, Account Settings > Apps & API > Copy the Auth Token (for the Beeminder API)

3. Set the BEETOKEN variable

   • In Alfred, open the 'Configure Workflow' window in beeAlfred preferences
     • set the BEETOKEN variable to the Beeminder Auth Token retrieved in Step 2
     • set the BEEUSER value to your Beeminder username

4. Optional: Setup a hotkey to launch beeAlfred

5. Optional: Change the keyword to launch beeAlfred

   • keyword currently set to !q

6. Optional: Change the comment string (currently: -- from Alfred 🐝)

   • In Alfred, open the 'Configure Workflow and Variables' window in beeAlfred preferences
   • Edit the BEECOMMENT variable

<h1 id="usage">Basic Usage 📖</h1>

Checking the status of your goals

• launch beeAlfred by typing !q or using an optional hotkey
• beeAlfred will return goals and their status/deadline

Entering a new datapoint

• search a goal by typing !q followed by a goal name or matching string
• select your goal by pressing return.
  • option-return (⌥⏎) will open the goal in Beeminder
• enter your value plus an optional comment after space

<h1 id="known-issues">Limitations & Known issues ⚠️</h1>

• beeAlfred is using the local timezone to compute derail time. It might not correspond to the real derail time if a different timezone is set on beeminder.com
• nothing else for now, but I have only tested a few use cases, let me know if you see anything!

<h1 id="acknowledgments">Acknowledgments 😀</h1>

• Dean Jackson and Vitor Galvāo for their incredible help on the Alfred mailing list and for creating many scripts used as templates for this workflow.

<h1 id="changelog">Changelog 🧰</h1>

• 07-06-2023: version 2.2 (fixed typo in variable name)
• 12-05-2022: version 2.1 (Alfred 5)
• 03-15-2022: version 2.0 (Python3, no dependencies)
• 05-23-2021: version 1.0.2 (adding pledge)
• 05-18-2021: version 1.0.1 (minor fixes)
• 05-17-2021: version 1.0

<h1 id="feedback">Feedback 🧐</h1>

Feedback welcome! If you notice a bug, or have ideas for new features, please feel free to get in touch either here, or on the Beeminder/Alfred forums.