Skip to content
BredboxHelp

Save with a link

Apps differ wildly, but almost all of them can open a web address. That is the only thing Bredbox needs in order to accept a link from them.

Section titled “The save link”
https://bredbox.app/library/add?url=THE_URL&title=THE_TITLE

Opening it takes you to Bredbox’s Save a Link page with the fields already filled in. Check them, click Save, and the link lands in your library.

Parameters

Section titled “Parameters”
Parameter Required What it does
url Yes The page you want to save.
title No A title of your own. Leave it out and Bredbox works the title out from the page itself, which is usually what you want.

Both values have to be percent-encoded, because a URL inside a URL needs its :, /, ?, and & characters escaped. Apps that offer a custom share URL do this for you. If you are building the link in a script, use your language’s URL-encoding function — encodeURIComponent in JavaScript, urllib.parse.quote in Python.

A finished link looks like this:

https://bredbox.app/library/add?url=https%3A%2F%2Fexample.com%2Farticle&title=A%20very%20good%20article

What happens when you open it

Section titled “What happens when you open it”
  • Signed in — the Save a Link page opens with your values in place. Click Save and Bredbox takes you to your library.
  • Signed out — Bredbox asks you to sign in first, then returns you to the same prefilled page. Nothing is lost.
  • Already saved — Bredbox recognizes the URL, updates the save you already have, and does not create a duplicate. Opening the same save link twice is always safe, and it brings a save back from Archive or Trash.

url and title are the only two parameters — the link cannot carry tags or set a save as a Favorite. Add those on the Save a Link page before you save, from your library afterwards, or as you save with the browser extension.

Make a bookmarklet

Section titled “Make a bookmarklet”

A bookmarklet is a bookmark that runs a small piece of code instead of opening a page. It gives you one-click saving in browsers where the Bredbox extension isn’t available — Safari, or a work browser that blocks extensions — and it needs no permissions at all.

  1. Create a new bookmark in your browser and name it Save to Bredbox.

  2. Paste this as the bookmark’s address:

    javascript:(function(){window.open("https://bredbox.app/library/add?url="+encodeURIComponent(location.href)+"&title="+encodeURIComponent(document.title),"bredbox-save","width=460,height=620")})()

  3. Put the bookmark on your bookmarks bar so it’s always one click away.

Now click it on any page you want to keep. A small window opens with the page’s address and title already filled in — click Save, then close the window and carry on reading.

If you use Chrome, Firefox, Edge, or Brave, install the browser extension instead. It saves in a single click without a confirmation step and tells you whether a page is already in your library.

Section titled “Other places the save link is useful”
  • RSS readers — add it as a custom share destination and save articles straight from the reading view. See Save from your RSS reader.
  • Launchers and clipboard tools — Alfred, Raycast, and similar apps can open a URL built from your clipboard, which turns “save the link I just copied” into a keyboard shortcut.
  • Note-taking and read-later apps — anything with a custom “share to URL” or “open URL” action can send its current item to Bredbox.
  • Scripts and shell aliases — build the link, open it with open on macOS or xdg-open on Linux. For automation that shouldn’t need a browser at all, use the REST API instead.
Section titled “Related guides”