FeynmanLM Docs

Appearance

Reading Services ​

FeynmanLM can import your saved articles from Readwise Reader, Matter, Instapaper, and Raindrop.io, so everything you save to read later automatically becomes available as sources.

All services use network APIs, not local database files. You can enable multiple services simultaneously; FeynmanLM deduplicates by URL.

Readwise Reader ​

Readwise Reader is a read-later app with a well-documented API. FeynmanLM fetches your saved, triaged, and archived documents and adds them to your Studio queue.

Setup ​

  1. Go to Settings → Reading Services.
  2. Turn on Readwise Reader.
  3. Paste your API token. Get it from readwise.io/access_token.
  4. A green checkmark confirms the token is valid.

What gets imported ​

  • Articles saved to New, Later, and Archive locations.
  • RSS feed items are excluded (only manually saved items are imported).
  • Metadata imported: title, author, cover image, tags, and original URL.
  • Source type is auto-detected from the URL (article, paper, video, etc.).

How it works ​

  • On each Studio launch, FeynmanLM calls the Readwise Reader API to fetch your library.
  • Cursor-based pagination handles large libraries automatically.
  • Rate limits (20 requests/minute) are respected — the app waits and retries if throttled.
  • Deduplication works across all sources: an article in Readwise and in your Safari reading list only appears once.

Matter ​

Matter is a read-later app for iOS and web. FeynmanLM fetches your saved library items via Matter's API.

Setup ​

  1. Go to Settings → Reading Services.
  2. Turn on Matter.
  3. Paste your API token. To get it:
    • Open the Matter app on your phone.
    • Go to Profile → Sign into Web.
    • Copy the access token shown (or find it in the Obsidian Matter plugin's data.json if you use that).
  4. A green checkmark confirms the token is valid.

What gets imported ​

  • All saved library items with URLs.
  • Metadata imported: title, author, publisher, tags, and original URL.

How it works ​

  • On each Studio launch, FeynmanLM calls the Matter API to fetch your library.
  • Pagination is handled automatically.
  • Deduplication works across all sources.

Note on Matter's API

Matter's API is community-documented (reverse-engineered from the Obsidian plugin and iOS app), not officially published. It works reliably but may change without notice. If sync stops working, check for a FeynmanLM update.

Instapaper ​

Instapaper is one of the original read-later apps. FeynmanLM fetches your unread and starred bookmarks via Instapaper's Full API using OAuth 1.0a.

Setup ​

Instapaper's API requires developer credentials. You'll need a consumer key and consumer secret — apply at instapaper.com/main/request_oauth_consumer_token.

  1. Go to Settings → Reading Services.
  2. Turn on Instapaper.
  3. Enter your Consumer Key and Consumer Secret.
  4. Enter your Instapaper email and password.
  5. Tap Sign In. FeynmanLM exchanges your credentials for OAuth tokens via xAuth — your password is not stored.
  6. A green "Signed in" status confirms the connection.

What gets imported ​

  • Bookmarks from your Unread and Starred folders.
  • Metadata imported: title, URL, reading progress, and save date.
  • Up to 500 bookmarks per folder (Instapaper API limit).

How it works ​

  • On each Studio launch, FeynmanLM fetches bookmarks from Instapaper using OAuth 1.0a signed requests.
  • Your Instapaper password is only used once for the initial xAuth token exchange — only OAuth tokens are stored.
  • Bookmarks from both Unread and Starred folders are imported; duplicates across folders are deduplicated.

Raindrop.io ​

Raindrop.io is a bookmark manager with powerful organization features (collections, tags, nested folders). FeynmanLM fetches all your saved bookmarks and adds them to your queue.

Setup ​

  1. Go to app.raindrop.io/settings/integrations.
  2. Create an app (or open an existing one) and copy the Test Token.
  3. In FeynmanLM, go to Settings → Reading Services.
  4. Turn on Raindrop.io.
  5. Paste your test token.
  6. A green checkmark confirms the token is valid.

What gets imported ​

  • All bookmarks across all collections.
  • Metadata imported: title, URL, excerpt, tags, domain, cover image, and creation date.
  • Source type is auto-detected from the URL.

How it works ​

  • On each Studio launch, FeynmanLM fetches all raindrops via paginated API calls (50 per page).
  • Rate limits (120 requests/minute) are respected.
  • Test tokens never expire, so you don't need to re-authenticate.
  • Raindrop.io tags are preserved and available for filtering in Studio.

Test Token vs OAuth

The test token is the simplest way to connect. It only accesses your own account and never expires. If you prefer OAuth (e.g. for a shared setup), FeynmanLM also accepts OAuth bearer tokens.

Using multiple services ​

You can enable any combination of reading services. FeynmanLM deduplicates by URL, so an article saved in both Readwise and Raindrop.io only appears once in your queue. The first-discovered copy is kept.

Switching between services ​

If you're migrating from one service to another:

  1. Enable the new service in Settings and provide the token/credentials.
  2. Your existing articles (from the old service) remain in your queue — nothing is lost.
  3. Once you're satisfied the new service is working, disable the old one.

Sources that were already imported are unaffected by which service discovered them.

Troubleshooting ​

"Invalid token" ​

  • Readwise: Make sure you copied the full token from readwise.io/access_token. Tokens don't expire, but you can regenerate one if needed.
  • Matter: The token may expire if you sign out of the Matter app. Re-authenticate via Profile → Sign into Web and paste the new token.
  • Raindrop.io: Test tokens don't expire. If validation fails, try regenerating the token in your Raindrop.io integrations settings.

Instapaper sign-in failed ​

  • Double-check your consumer key and consumer secret — these come from Instapaper's developer portal, not your account settings.
  • Make sure your email and password are correct.
  • If you have two-factor authentication enabled, Instapaper's xAuth may not support it. Check Instapaper's documentation.

Articles not appearing ​

  • Check that the service toggle is on in Settings → Reading Services.
  • Articles with no URL (e.g. text-only notes) are skipped.
  • Readwise RSS feed items are excluded — only manually saved documents are imported.
  • Instapaper imports only Unread and Starred folders by default.
  • Try closing and reopening the app to trigger a fresh sync.

Slow sync ​

Large libraries (1000+ items) may take 10–30 seconds on the first sync due to pagination. This is normal and only happens once per app launch.