Marian

How Marian works

Marian saves passages, not pages. The sentence that made you stop is the thing worth keeping — and later, the thing worth finding again.

Highlighting

The core action. Everything else is built on what you keep here.

  1. Select the text

    Any text on any page. A phrase is enough — you do not need to select a whole paragraph to remember one.

  2. Pick a colour

    A small toolbar appears next to your selection. Colours are yours to mean whatever you like; you can name them in settings so “yellow” becomes “disagree with this”.

  3. Add a note, if you have one

    Click the highlight and type. Notes are the most valuable thing in your library — when you later ask a question, passages you wrote something about are treated as stronger evidence than ones you did not.

  4. Come back to it

    Open the side panel to see everything from this page, or the library to see everything from everywhere.

Pages and collections

Grouping, for when one library becomes several projects.

  1. Save a whole page

    Click the star in the side panel. Useful for something you want to return to but have not read yet.

  2. Make a collection

    Collections are folders for pages. Give one a colour and it becomes scannable in a long list.

  3. File a page into it

    From the page’s row in the side panel or the library. A page lives in one collection; its highlights come along with it.

  4. Tag individual highlights

    Tags work across collections, so a single passage can belong to a project and a theme at once.

Adding a PDF

Papers, reports and books — read in your browser, asked about like anything else.

  1. Open Add a PDF

    From the web app’s menu, or the + PDF button in the extension’s side panel. It opens here because Chrome cannot read a file you have not explicitly chosen.

  2. Drop the file in

    The text is pulled out in this browser tab. The file itself never leaves your machine — Marian keeps the words, not the document.

  3. Wait for the pages

    You will see it count through. A long book takes a moment; the count is there so you know it is working rather than stuck.

  4. Ask about it

    Go to Ask. Answers drawn from a PDF tell you the page they came from, so you can go and check.

Summarising a page

Two different questions, asked at two different moments.

  1. Open the side panel on a page

    The page you are on appears at the top as a card, with its picture and a line or two about it.

  2. Before you read it: “Worth reading?”

    A short account of what the page actually argues — the claims, not the topics — and who it is useful to. This is for deciding whether to spend the next twenty minutes on it.

  3. After you have read it: “What I marked”

    A reminder of what you kept and what your notes said about it, including where your notes disagreed with the passage. It is greyed out until you have highlighted something, because until then there is nothing to recall.

  4. It stays, folded

    The summary is saved on the page and shows as a single line in your library afterwards. Click to unfold it. Redo it any time — the new one replaces the old.

Asking your library

Questions answered only from what you kept — never from the open web.

  1. Ask about one passage

    Click a highlight and choose Ask. The conversation stays attached to that passage, so months later the thinking you did is still there beside it.

  2. Ask about everything

    The Ask tab searches your whole library. Every claim in the answer points at the passage it came from.

  3. Or ask for a synthesis

    Turn on Synthesise for a connected account across several passages — including where they disagree and what is missing.

  4. Check the citations

    They are the point. If an answer cannot cite your library, it says so rather than filling the gap with something it made up.

Marking a moment in a video

On YouTube, the thing worth keeping is a moment — and it lands beside everything you have read.

  1. Watch, and press Mark this moment

    The button sits beside Like and Share. It captures wherever the playhead is, so you do not have to pause or scrub back.

  2. Write down why

    Open the side panel and add your note, the same as any highlight. The note is the part that matters — the timestamp only tells you where to go back to.

  3. Find it beside your reading

    A video moment sits in the same library as a passage from an article, and turns up in the same searches and the same answers.

  4. Click it to go back

    It opens the video at that exact second — in the tab you already have open, if there is one.

Tabs you left open

A quiet list of what has been sitting there — no AI, no credits, nothing sent anywhere.

  1. Open the Tabs panel

    It shows tabs that have been open more than a day. Anything newer is a tab you are still using, so it stays out of the way.

  2. See what you already thought about it

    If you highlighted something on that page before, it says so — “you highlighted 3 things here in March”. That is usually the fact that decides what to do with it.

  3. Save it, snooze it, or close it

    Saving puts the page in your library so you can close the tab without losing it. Snoozing hides it for a week and leaves the tab open.

  4. Nothing will nag you

    There are no notifications and no badges counting at you. The list is there when you go looking and silent when you do not.

Collapsing tabs into a queue

Twenty tabs open is a stress. Put them somewhere you can find them again.

  1. Open the Tabs panel and press Collapse

    Every tab in the window is saved to your library and then closed. They are only closed once every one has been saved.

  2. See what you already know about them

    If you have highlights on pages in the queue, it says so. That is usually the one you should open first.

  3. Open one when you are ready

    Clicking it reopens the page and takes it off the queue.

  4. It empties itself as you read

    Highlight anything on a queued page and it leaves the queue — you read it. That is what stops the list becoming a monument to good intentions.

Suggested collections

Marks that look related, offered as a starting point — never filed for you.

  1. Open Suggestions in the web app

    It looks only at marks that are not in a collection yet. Anything you already filed is a decision you made, and it is left alone.

  2. Read the sample passages

    Three quotes from the group. You can tell in seconds whether they belong together — that judgement is yours, not the software’s.

  3. Name it and create it

    Type a name, or spend a credit to have one suggested. Nothing is created until you press the button.

  4. Or say it is not a group

    Dismissed suggestions never come back.

Reading time

Off until you turn it on. Read this section before you do.

  1. Know what it records

    Every page you visit — the address, the title, and how long you were actually there. Not what the page said. It is a browsing history, and it syncs with your account.

  2. Turn it on in the extension’s settings

    Under “Record how long I spend on pages”. Sites Marian is blocked on — anything that looks like banking or health — are never timed at all.

  3. Look at the week

    The web app’s Reading time page leads with the number that matters: how much you read, and how much of it you kept something from.

  4. Erase it whenever you like

    One button, and your highlights are untouched. Everything older than 90 days is deleted automatically anyway.

Reading terms and conditions

For the moment before you agree to something.

  1. Marian notices the link

    On a signup or checkout page with a terms link, it offers to read it. It never opens anything on its own.

  2. Press the button

    The document opens in a background tab under your own session — which is the only way it works behind a login — and closes again.

  3. Read the quotes, not the characterisation

    Every point quotes the clause it came from, so you can check it. That is the whole design: a confident wrong summary of a contract is worse than no summary.

  4. Notice what it says it cannot tell you

    If the agreement points at another document, or a section is vague, it says so. It is a reading aid, not legal advice.

Credits

What AI features cost, and what stays free forever.

  1. Keeping things is free

    Highlighting, notes, collections, search, and adding a PDF never cost anything. Rationing the thing the library is for would make no sense.

  2. Answers cost credits

    A question about a passage costs 1. A question to your whole library costs 2. A synthesis costs 3. The price is shown on the button before you press it.

  3. Nothing runs without you asking

    There is no background summarising and no automatic AI. Every credit is spent by a click you made.

  4. A failed answer is refunded

    If a generation breaks, the credit comes back. You can see every charge on your account page.

Syncing and getting your data out

Your library should outlive any one browser — and this software.

  1. Sign in on each browser

    The same account, and your highlights follow you. Sync is optional; Marian works entirely offline without it.

  2. Export whenever you like

    Markdown, JSON or CSV, from the account page or the extension.

  3. Export works without the extension

    That is why this web app exists. Uninstalling should never be the thing that loses your reading.

  4. Deleting means deleting

    Delete your account and everything goes — highlights, conversations, document text, and the search index built from them.

Common questions

My sign-in code hasn’t arrived.
Give it a minute — mail is usually quick but not instant — then check your spam folder, since a first message from a new sender often lands there. If it still hasn’t come, use “Didn’t arrive? Send it again” on the code screen. That button waits sixty seconds between tries on purpose, so a second tap doesn’t just send a second copy of the same email. If nothing arrives after two attempts, the address may have a typo in it — go back and check it character by character before trying again.
Why don’t I get a password?
Because a password you choose is a password that can be guessed, reused, or leaked from somewhere else entirely. A code emailed at the moment you ask for it expires in ten minutes, works once, and cannot be reused — so there is nothing stored on our side worth stealing, and nothing for you to remember or rotate.
I got a sign-in code I never asked for.
Somebody typed your address into the sign-in box — most often a genuine typo of their own. Nothing has happened to you. No account was created, nothing was changed, and the code is useless to anyone who cannot read your inbox. It expires by itself in ten minutes. You can ignore the message. If it keeps happening, tell us and we will look at where the requests are coming from.
It said the code couldn’t be sent. What now?
That message means our email provider was unreachable — not that anything is wrong with your address. Nothing was sent and no code was created, so simply try again in a moment. We show you this rather than pretending it worked, because the alternative is leaving you staring at a code screen waiting for a message that was never going to come.
Can I change the email address on my account?
Not yet. Your address is your account identity, so moving it means moving everything attached to it — and doing that wrong is how a library ends up on the wrong account. Until it exists properly, the honest answer is to get in touch and we will do it by hand.
My highlight disappeared from the page. Is it lost?
No. The text of a highlight is saved the moment you make it, so it survives even if the page changes or goes offline. What can break is Marian’s ability to find the exact spot again — if an article is rewritten, the sentence may no longer be there to point at. The highlight still shows in your library with everything you wrote about it, marked as needing re-attaching.
Is reading time the same as the Tabs list?
No, and the difference matters. The Tabs list is current state — what is open right now, deleted the moment you close it, never leaving your device. Reading time is a history of where you have been, it syncs, and it is off until you switch it on.
Does the Tabs list track my browsing?
No. It records the tabs that are open right now — one row per tab, deleted the moment you close it. There is no history of where you have been, none of it ever leaves your device, and pages Marian is blocked on (anything looking like banking or health, browser settings, local files) are never written down at all.
Does Marian read every page I visit?
No. Marian only stores pages you highlighted on or explicitly saved. A page you merely visited leaves no trace. See the privacy policy for exactly what is kept and where.
It says my PDF looks scanned. What does that mean?
A scanned PDF is a photograph of pages rather than text — there are no words in the file for Marian to read, only an image of words. Reading those needs OCR, which Marian does not do yet. Marian says so rather than accepting the file and quietly indexing nothing, which would look like it worked until you asked a question and got nothing back.
Why does the answer only use my library and not the internet?
Because your library is the part nobody else has. A model can already answer general questions; what it cannot do is tell you what you read and what you thought about it. Restricting answers to your own passages is also what makes every claim checkable.
Where does the AI actually run?
That depends on how your Marian server is set up. It can run entirely on your own machine, in which case nothing you highlight ever leaves it — and in that mode, AI features cost no credits, because there is nothing to meter.
Can I highlight inside a PDF?
Not yet. You can upload one and ask questions about it, with answers that cite page numbers. Highlighting inside a PDF needs a whole separate way of remembering where a highlight sits, which is a much larger piece of work than reading the text out.
What happens if I delete a highlight I had a conversation about?
The conversation goes with it, and comes back if you undo. A discussion about a passage that no longer exists has nothing to be about — but losing your thinking while keeping the undo would be worse than no undo at all.
Why can’t I quote the transcript of a video?
Because YouTube no longer reliably hands one over. Their caption endpoint answers with an empty response rather than an error, and their own transcript panel often fails the same way — so an extension that promised transcript quotes would silently produce nothing on most videos and tell you they had no captions. Rather than ship that, a video mark is a moment plus your own note. If it were quoting words nobody verified, it would be putting statements in a speaker’s mouth with a timestamp attached, which is worse than not quoting at all.
Why does Marian not just summarise everything automatically?
Because it would be spending your credits on pages you never return to, and — more importantly — a summary read instead of the page is a bad trade. The value of your library is your own judgement about what mattered, and a tool that quietly does that judging for you is undermining the thing it is supposed to be building. There is a setting to summarise a page when you explicitly save it, off by default. It never fires on a page you merely visited.
Can I summarise from the web app?
Not yet, and not for want of a button. Summarising needs the text of the page, which the extension keeps on your device and never uploads — so the web app genuinely does not have it. Summaries you make in the extension show up here.
I ran out of credits mid-thought.
Nothing else stops working — highlighting, search, collections and export are all unaffected. Only new AI answers pause. Your balance and full spending history are on your account page.