AudioPen - Obsidian Sync

Obsidian plugin and service that connects your editor to AudioPen.

This is based on the amazing work trashhalo did with obsidian-webhooks, but updated and extended to work with AudioPen.

Setting up the plugin

1. Install the obsidian plugin from the community plugins
2. Go to https://audiopen-obsidian.web.app to signup for the service
3. Generate a login token
4. Used the token to log in the Audiopen-Obsidian Sync plugin settings in Obsidian
5. Add the webhook url to AudioPen

For detailed instructions, read on:

5. How to add the webhook to AudioPen

After you did 1-4 above, you'll have a webhook url and a token.

The webhook URL looks like this: https://europe-west1-audiopen-obsidian.cloudfunctions.net/webhook/ab97f2f036a143f5d3555e5fc3f4e833

1. Navigate to AudioPen
2. Make sure you're logged in
3. Click the settings icon at the top right of the screen:
4. Scroll down to the section Beta Program and enable the toggle
5. Right above in the Integrations section, click Set up integrations
6. add your webhook url

• as an automatic webhook
• (optionally) as a manual trigger, if you want to be able to update notes

Custom Templates

You can create custom templates for your notes by creating a audiopen-template.md file (name it anything you want), preferably in your template folder with your other templates.

1. Choose a starting point for your template:

• Template with AudioPen tags as Obsidian Links
• Template with AudioPen tags as Obsidian tags

2. Save it to your vault's template folder

3. Edit it to your liking

You can use the following variables in your template:

• {title} - title of the AudioPen note
• {body} - rewritten version of the note
• {orig_transcript} - original transcript of the note
• {id} - AudioPenID - if you remove this from the template, it won't be able to append or update notes and will always create a new one.
• {date_created} - date created in AudioPen
• {date_formatted} - date created formatted to link to your daily notes, uses settings in periodic notes plugin, or daily notes plugin if periodic notes isn't installed.
• {tagsAsLinks} - AudioPen tags formatted as list of [[Links]] for Obsidian properties
• {tagsAsTags} - AudioPen tags formatted as a list of tags for Obsidian properties

Note: Both {tagsAsLinks} and {tagsAsTags} are rendered as a simple list like:

  - "[[Link one]]"
  - "[[Link two]]"

They currently don't handle empty states for you, that's why I suggest always having one tag or one link in the template before you insert {tagsAsLinks} or {tagsAsTags}. As you can see in the example templates, I added a tag #audio-pen and a link to the current daily note using {date_formatted}. Otherwise if you don't add any tags in AudioPen, and the template only contains {tagsAsLinks} or {tagsAsTags}, the template YAML properties won't be valid.

4. Add the template to the plugin settings

• toggle Use custom template on and select your template in the dropdown below.

5. Test it

• make a new note on AudioPen to make sure the template works for you.

Suport this plugin

If you sign up to AudioPen with a link from this readme, I'll get a little kickback at no cost to you. You can also:

or become a Github Sponsor

And while you're at it, you might be interested in some of the other things I think about and create. You can find my work slow.works and read about my thoughts on Substack