Desktop help

Importing, reading, citing and writing, answered.

Getting started

Do I need an account?

The library, reader and writer work without signing in. Sign in to your OniScholar account and imported PDFs are identified in the cloud, for more accurate details.

What does it cost?

The desktop app is free. Cloud identification of PDFs uses OniScholar credits, shared with your plan on the website.

Which computers does it run on?

Macs with Apple silicon or Intel (macOS 12 or later), and 64-bit Windows 10 and 11.

Where are my files?

Your library and PDFs live in one folder on your computer. Choose Settings → Storage → Open storage folder.

Is my library backed up?

Yes. OniScholar backs up the library every day and keeps the last 7 daily and 4 weekly backups.

To restore, quit OniScholar, find the backup under Settings → Storage → Backups and put it in place of momento.sqlite3 in the library folder. PDFs stay in the storage folder; back up that folder to keep them.

How do updates work?

OniScholar checks at launch and every 6 hours, downloads in the background and installs when you quit. Choose Restart Now to update right away.

Importing

How do I add a reference?

Choose Add and enter a DOI, ISBN, PMID, arXiv ID or ADS bibcode. You can also import PDFs or a folder, or drag PDFs into the window.

What happens to an imported PDF?

OniScholar finds its DOI, arXiv ID, ISBN or PMID and fills in the record, attaching an open-access copy when one exists. The PDF is copied into the storage folder; your original stays as it is.

Can I import BibTeX, RIS or a Zotero library?

Yes. Add → Import library reads .bib, .ris and Zotero RDF files and skips duplicates.

To move a whole Zotero library, use Add → Migrate from Zotero…; the migration guide has the steps.

How do I save papers from the browser?

The Safari extension installs with the desktop app: open Settings → Extensions in Safari and turn on OniScholar.

In the Chrome extension, choose Connect in the pop-up, then confirm in OniScholar.

Reading and AI

Where are my highlights and notes?

On the page where you made them, and listed beside the PDF. Notes are also gathered in each item's Notes tab.

How do I correct a record?

Select the item and edit it in the Info tab.

How do I ask questions and translate?

Add an AI provider and API key in Settings; any OpenAI-compatible endpoint works. Then ask about the PDF in the reader, or translate a selection, sentence or paragraph.

Citing in Word and WPS

How do I get the OniScholar tab in Word or WPS?

With Word or WPS Writer installed, OniScholar sets it up at launch. If Word was open, quit and reopen it.

The status shows on the Microsoft Word and WPS Writer cards in Settings.

macOS asks to allow access to Word's folder

macOS asks once, the first time Word or WPS is set up. In Settings, click Repair on the Word or WPS card, then click Allow.

How do I insert citations and a bibliography?

Place the cursor, click Cite, pick the reference and click Insert citation. Click References to add the reference list.

How do I change the citation style?

Click Style, choose a style and language, then Apply. GB/T 7714, APA, Chicago, IEEE, MLA and other common styles are built in, and any CSL style works.

The bibliography didn't update

Click Update to update every citation and the bibliography. OniScholar writes the bibliography; to change how one entry reads, use Custom text for the selected entry.

Can I keep writing a document cited with Zotero?

Yes. Choose Tools → Import Zotero and OniScholar takes over its citations and bibliography. Try it on a copy first.

How do I send a document to someone without OniScholar?

Choose Tools → Keep Text to turn citations and the bibliography into plain text. Save it as a separate copy and keep the linked original for further edits.

Buttons in Word do nothing

The citation dialogs come from the desktop app, so keep OniScholar open while you write.

Writing

What is the writer?

The Markdown editor under Manuscripts. You write on the left and see the typeset PDF on the right, with citations rendered as you type.

What can the writer export?

A typeset PDF, with journal and thesis templates. For an editable Word document, write in Word or WPS, where citations stay live too.

Privacy and data

Where is my library stored?

Your library, PDFs and manuscripts stay on your computer. When you're signed in, cloud identification reads only the PDF content needed to identify the reference.

Who can reach OniScholar's local connection?

Word, WPS, the browser extensions and AI agents connect through a local service on 127.0.0.1, reachable only from your computer and only with a token.

You can reset the token in Settings; Word and WPS update on their own, and the browser extension reconnects in one click.

Troubleshooting

The OniScholar tab never appears in Word

Quit Word completely and reopen it. If the Word card in Settings says Needs attention, click Repair.

If Word shows a macro warning, add its startup folder to Trusted Locations.

WPS says the add-in is being replaced

Quit WPS and OniScholar finishes the replacement on its own.

One citation stopped updating

It was edited by hand, or its data was lost when pasted. Delete it and insert it again.

A document from Word for Mac shows no citations in WPS

Word for Mac keeps citation data where WPS can't read it. Finish in Word, or convert it first with Keep Text.