Save from anywhere
You don't have to open TileMark to save a link. There are three ways to send a page to it from wherever you are.
| Way | Best for | Needs |
|---|---|---|
| Browser button | Your computer | Being signed in to TileMark in that browser |
| Phone app | Android, from any app's Share menu | TileMark on an HTTPS address |
| API key | Scripts, iPhone Shortcuts, automations | An API key from Settings |
All three are found in ⚙ Settings → Save from anywhere. Links saved this way show up in an open TileMark tab as soon as you switch back to it.
Home Assistant app: these need TileMark's own address, not the sidebar. See TileMark's own address.
Browser button
- Open ⚙ Settings → Save from anywhere.
- Drag the 🔖 Save to TileMark button onto your browser's favorites/bookmarks bar. (Clicking it in Settings does nothing; it only works from the bar.)
- On any web page, click the button in your bar. A small window opens with the page's address and title filled in.
- Pick a group, add a note if you like, and press Save.
It works in Edge, Chrome, Firefox, Brave and Safari. If the small window asks you to sign in, sign in once in that browser.
Phone
When TileMark runs on HTTPS (see Reaching TileMark from outside), you can install it as an app:
- Open TileMark in your phone's browser and sign in.
- Choose Install app or Add to Home screen from the browser menu.
TileMark then opens full-screen from its own icon, like an app.
On Android, it also appears in the Share menu of other apps. In YouTube, Chrome, Reddit or any app, tap Share → TileMark, pick a group and save.
On iPhone and iPad, iOS installs TileMark on the home screen but doesn't offer web apps in its Share menu. Use the API key with a Shortcut instead (below).
API key
An API key lets a script, a Shortcut or an automation add links to your account. It can only add links and read your group names: it cannot read, change or delete your links.
- In ⚙ Settings → Save from anywhere, press Create API key.
- Copy it now: it is shown only once. If you lose it, press Replace API key for a new one (the old one stops working).
- Remove API key switches it off.
Every account has its own key, and links sent with it go to that account.
Adding a link
Send a POST to /api/links with the key in the Authorization header:
curl -X POST https://tilemark.example.com/api/links \
-H "Authorization: Bearer tm_your_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/article", "group": "Reading", "note": "read later"}'
| Field | Required | Meaning |
|---|---|---|
url |
yes | The address to save. |
group |
no | Group name. Created if it doesn't exist yet. |
group_id |
no | Group number, instead of the name. |
title |
no | Your own title. Without it, the page's title is used. |
note |
no | A note for the card. |
Listing your groups
curl https://tilemark.example.com/api/groups -H "Authorization: Bearer tm_your_key"
returns your groups with their names and numbers.
iPhone Shortcut
- In the Shortcuts app, create a shortcut and turn on Show in Share Sheet, receiving URLs.
- Add the action Get Contents of URL:
- URL:
https://<your-tilemark>/api/links- Method: POST - Headers:Authorization=Bearer tm_your_key- Request body: JSON, withurl= Shortcut Input and, if you like,group=Phone. - Name it "Save to TileMark".
Now Share → Save to TileMark works from Safari and most apps.
From Home Assistant
A rest_command can save links from an automation or a script:
rest_command:
tilemark_save:
url: "http://<your-tilemark>:8080/api/links"
method: POST
headers:
Authorization: "Bearer tm_your_key"
content_type: "application/json"
payload: '{"url": "{{ url }}", "group": "{{ group | default(''Inbox'') }}"}'