Shortform on Nicole van der Hoeven

Learning new things in Obsidian: in defense of remembering

Fri, 19 Jan 2024 12:01:34 +0100

Here’s how I’m learning things in Obsidian in 2024, and the tools I use in my information processing pipeline to read, listen, and watch content and turn that into ideas and output. I also talk about why it’s important to remember what you’ve consumed, and the value of writing stuff down to help you do so.

Taking Better Notes From Books: Shortform-Readwise-Obsidian

Fri, 28 Oct 2022 16:00:34 +0200

I’ve been using Shortform for over a year. I’ve written some code for it and I’ve also written a blog post about it. It’s an essential part of my workflow for taking better notes from books, particularly in conjunction with Readwise and my current note-taking tool of choice, Obsidian. Here’s what you need to know!

What is Shortform?

Shortform is a service that creates book summaries out of popular books, but it’s also so much more than that! They’re like Netflix but for books, if you can imagine that. The summaries that Shortform gives you are not just your typical high school level summaries of a book report that we used to do when we were younger.

Sound familiar?

What makes Shortform different?

Here are things that differentiate Shortform from other book summary services.

Researched commentary

Shortform has really thoughtful and nuanced commentary that place it firmly head and shoulders above other services.

Here’s a screenshot of some Shortform commentary from the book Why We Sleep, taken on the Shortform mobile app.

The highlighted section is a Shortform note– additional commentary that the Shortform team added. In this case, they are fact-checking the author, citing sources that prove a statement the author made to be false.

When I was reading this book, I didn’t really think about questioning those claims. But Shortform thoroughly goes over every claim that Walker, the author, made in thsi book.

Reading with Shortform is like having somebody else read a book with you– a more critical and more well-informed someone who has the time to fact-check statements. It’s a bit like having your own personal book club.

Shortform vs. Blinkist

Another service in this vein that I’ve used is Blinkist. Let’s look at the same book in Shortform and Blinkist to figure out why I like Shortform so much better.

This is what the Blinkist summary for the book Indistractable looks like.

Blinkist is based on the idea that every book can be distilled into these blinks: very short summaries of every idea. For this book it has eight. Each of these blinks is a few paragraphs long. Here’s what the first looks like.

A blink is a straight summary. There’s no commentary. There’s no research or anything like that. It seems like the whole focus of this is to be able to distill exactly what the author has said and let other people do the work of trying to figure out for themselves whether something is true or not. There’s really not much more than just these blinks.

In contrast, if we look at the one on Shortform, this is the same book and it also has like a one page summary like Blinkist did.

But then it also has a full book guide, which goes through every single chapter or part and adds more detail into it.

As you can see, Shortform takes a different approach: instead of just summarizing the book, they’re truly trying to explain it in their own unique way, providing examples and making it more readable using bullet points.

Action-oriented exercises

Shortform also has these exercises based on the things that the author has said in the book. These exercises are peppered throughout and between these chapters, and they really force you to put things into practice right away as soon as you learn them, which is another element of learning.

Critical thinking: comparisons to other ideas

Shortform tries to examine ideas in the context of other books they’ve made summaries for. Here’s an example of a Shortform note where Shortform suggests the summary of the book How to Stop Worrying and Start Living.

Fans of the Zettelkasten method will be happy to see this, because Shortform often prompts me to consider the differences or similarities between ideas from different authors. It helps me see connections I might not have considered. Incidentally, I’ve also found many good books this way!

How to use Shortform with Obsidian

The other thing that really sells it for me is the integration. Because I don’t want that learning to stop in the Shortform app. You know me, and I want everything in Obsidian. And Shortform has an integration that Blinkist does not.

I actually tried to solve this problem myself a year ago, because no integration existed. I wrote a Python script that would take the Shortform highlights, because it has an API, and then call the Readwise API and kind of string them together. Now, that still works as far as I know, but that’s not what I recommend anymore. I talked to the Readwise founders and suggested to them that Shortform was a great company to partner with. Not too long after that, they came out with an awesome integration!

First, sign up to both Shortform and Readwise. They both have free trials, so you don’t have to commit to anything just yet.
Then, click on this link to connect your Readwise account to Shortform.
(optional) If you use Obsidian like I do, follow these instructions to install the Readwise Official plugin for Obsidian.

That’s pretty much it!

From now on, here’s how things will work:

You make highlights on books on Shortform.
Those highlights are sent to Readwise automatically.
Through the Readwise official plugin, those highlights get synced into your Obsidian vault.

The result: Shortform highlights in Obsidian

Here’s what my Shortform highlights look like in Obsidian. Note that after setting this up, all I had to do was make highlights on Shortform– it’s quite low-touch after that.

I tweaked the export settings in Readwise to set the format I want the note to have in Obsidian. You don’t have to do this, but if you want to, you can change those settings here.

My Shortform workflow for taking notes on books

This is pretty much how a lot of my book-buying and -reading goes:

I start by browsing books on Shortform and read the one-page summaries.
If I find one I like, I buy the book on Kindle.
I make highlights on the Kindle version. (Those are synced to Obsidian too!)
If I really like the book, I flip back to the Shortform detailed chapter summaries as I finish each chapter, because they provide more context. I make highlights and notes from Shortform here sometimes.
Sometimes I do the Shortform exercises too.
After I finish the book, I go back to the Shortform summary and make more highlights/notes.
After I’ve read my fill of both the Shortform summary and the book itself, I go back to Obsidian and write my own notes that combine what I’ve learned.

If that sounds like a lot, it is! But keep in mind that I don’t do this for every book. At every step of the way, Shortform helps me filter out books that I don’t want to read, or don’t want to finish.

Shortform definitely saves me money: it costs less than a book a month and it stops me from reading more than one book a month. From that perspective, it’s already worth it.

But more than that, the thoughtfulness of the summaries and the research that goes into those commentaries save me more than just money: they save me time. And that’s really what I keep coming back for.

Some of the links on this page are affiliate links. Click here to check out my ethics statement and see how I decide what to promote in this way.

How to import Shortform highlights to Obsidian via Readwise

Mon, 16 Aug 2021 21:40:16 +0200

I’ve always been dubious of those book summary apps. You know the ones– they tend to have obnoxious ads that promise to help you “read 5 books a day” or learn the world’s secrets in 15 minutes. Having tried a few of them, I’ve been disappointed with the quality of their summaries (or lack thereof). They attempt to distill the message of a 300+ page book into a handful of bullet points, which I’ve found neither accurate nor useful. Recently, though, I found myself happily subscribing to one, and here’s why.

What’s Shortform and why is it awesome?

Shortform really took me aback because it isn’t just a book summary. I should mention here that I’m not affiliated with Shortform and gain nothing by recommending them. I’m just a happy subscriber.

When I read their guide for the book Why We Sleep, I was pleasantly surprised to find that Shortform not only summarized it succinctly, but they also added intelligent counterarguments to the author’s points. In some cases, when the author made a false claim, there were Shortform notes that linked to studies that showed why the claim was false. In other cases, Shortform mentioned related concepts proposed in other books that strengthened the author’s viewpoint. I found myself looking up their guides of books I’d already read, just because I was curious to see if I had missed anything. And I had!

In short, Shortform is the only book summary reader I’ve found that goes beyond summarizing and actually adds value to the reading experience, even if you’ve read the book.

They also have a one-page summary of the book AND a summary per chapter, so information is presented at different levels of detail. In my time with it, my most frequent workflow with it has involved reading the one-page summary of a book, buying it if it was interestering enough, reading the book, and then going back to Shortform to go read the chapter summaries. And both the one-page and detailed chapter summaries, including Shortform notes, can be highlighted!

Naturally I wanted to take it further than that. I already sync my Kindle highlights to Obsidian automatically and incrementally process them in Obsidian, so I wrote a script to have my Shortform highlights going to Readwise as well.

My Shortform highlights for the book Mindset, in my Obsidian vault.

The screenshot above shows the final result: highlights I made in the Shortform web or mobile app that have been synced to a page in my Obsidian vault. Here’s how I did that.

Note: Since this article was published, Shortform and Readwise have created an integration, so the script I mention here is no longer necessary. Click here to see what I’d recommend doing today.

What you need

A Shortform account. (affiliate link)
A Readwise account. (This is an affiliate link. If you sign up with this link, you’ll get a two-month free trial instead of one, and I get a small percentage if you sign up for a plan.)
A tool that Readwise can export to, such as Obsidian, Roam Research, Notion, or Evernote. You can also use their CSV and Markdown exports.
A local installation of Python 3, which you can download here.

Obsidian is my Personal Knowledge Management tool of choice, and I use the Readwise Official community plugin to get Readwise to send highlights to Obsidian. However, using Obsidian is not necessary as my script connects only Shortform to Readwise.

The setup

Clone my Shortform-to-Readwise repository on GitHub or download it to your computer.

Enter your tokens

The file variables.py requires two tokens: one from your Shortform account and another from your Readwise account:

# Your authorization token for Shortform
authToken = ''

# Your Readwise API token
# Retrieve this token from https://readwise.io/access_token
readwiseToken = ''

Getting your Shortform token

This is a little hacky, because Shortform doesn’t expose an API token in their web app. So you’ll need to log in to your Shortform account and open up DevTools in your browser. In Chrome, go to Options > More Tools > Developer Tools (or, on Mac, hit CMD+OPTION+I). Click on the Network panel.

You should now see Shortform on one side, and DevTools on another in the same browser window.

Then, go to your Highlights page. Doing so will populate the Network panel with a bunch of requests that look like this:

DevTools open in Chrome, showing requests from Shortform.

Click on the request with the name ?sort=date, highlighted above. That’ll open another side panel that will show Headers. Scroll down to the section marked “Request Headers”, and look for where it says Authorization: Basic followed by a bunch of characters.

Authorization headers for Shortform, in DevTools.

I’ve removed my personal authorization token from the screenshot above, but it’s a long series of characters that comes after Authorization: Basic . Go ahead and right click on it and click Copy Value. Paste it into variables.py as the value for authToken, and then _remove Basic (including the space after it) so that you’re saving only everything that comes afterwards.

Getting your Readwise token

Thankfully, this one’s a little easier. Go to this page on Readwise after logging in. Click “Get Token”, click “Copy to clipboard”, and then paste it into variables.py.

Save variables.py.

Note: Don’t share either of these tokens with anyone else, as they will then be able to access your Shortform or Readwise accounts.

Run the script

Open up your terminal, and cd into the /shortform-to-readwise repository. Then, run:

python3 getHighlights.py

It should finish in a few seconds (depending on how many Shortform highlights you have), and then you can verify that it worked by going to your Readwise library.

Shortform exports showing up in your Readwise library.

You should see books that have the Shortform- prefix. If you do, then you’re done! If you’ve got your Readwise account set up to push your highlights elsewhere (such as Obsidian), then you’re all set!

In case you’re wondering why I added the Shortform- prefix, it’s because I often read the Shortform guide, and then read the book itself. Rather than end up in a sticky situation where the Shortform guide highlights might override the actual book highlights, I titled it differently so that I get two pages for the two sets of highlights.

What about running the script regularly?

The whole point of this, at least for me, was to set it up so that I’ve got highlights going to Obsidian automatically, without needing my intervention. What I did was to use crontab on macOS to run the script every 30 minutes, but you can set up your own schedule.

Give cron full system access

Cron needs to have the right permissions to run scripts on your behalf, so you may have to go to System Preferences > Security & Privacy > Privacy > Full Disk Access on your laptop and add /usr/bin/cron to the “allowed” list.

Find the path for your python3 installation

In your terminal, run:

which python3

This will give you a path. For me, it was /Library/Frameworks/Python.framework/Versions/3.9/bin/python3. Copy this.

Open crontab

Then, from your terminal, run the command env EDITOR=nano crontab -e to open up a list of cronjobs. If you don’t have any other jobs, this will be blank.

Set a schedule

Add a line to crontab for the schedule you want to create. This line has to be in the format

* * * * * command

where the five asterisks correspond to:

minute
hour
day of the month
month
day of the week

In my case, I wanted it to run every 30 minutes, so here’s what my schedule looks like:

*/30 * * * * /Library/Frameworks/Python.framework/Versions/3.9/bin/python3 /Users/nic/python/shortform-to-readwise/gethighlights.py

Make sure you change /Users/nic/python/ to the path where you put the repository and your python3 path instead of /Library/Frameworks/Python.framework/Versions/3.9/bin/python3. Now exit out of it and save it (CTRL+X, and yes). The Python script should automatically run every 30 minutes.

That’s it!

I consume a lot of content daily, but without systems in place to capture insights from that content and process it, it all just gets forgotten eventually. That’s why I love services like Shortform and Readwise– they let me get what I’ve read/watched/heard out of my head and into Obsidian, where I can review them more critically and truly learn the important parts.

Both are paid services (which I paid for out of my own money), but I really think they’re worth it.

Note: This post contains affiliate links. Check out My Ethics Statement to see my standards for promotions.