ADSfolio

A local library for research papers

Start with your
existing PDFs.

Add a folder, identify papers in a batch, and preview filenames before renaming. Keep your folder structure, metadata edits, and file history.

Get ADSfolioRead the guide →
A stack of papers under a blue magnifying glass
ADSfolio showing a library list, publication table, and editable metadata
Application screenshot with fictional sample papers.

From PDF folders to a searchable library

  1. Choose Add PDF Folder on the welcome page.
  2. Choose Include Subfolders if your papers use nested folders.
  3. Run Identify. Review matches and papers that need attention.
  4. Preview Rename, then apply only the changes you want.

Saved results reduce repeated lookups. Identification time depends on PDF text, cache coverage, provider limits, and your connection.

Read the App GUI guide →
01

Find the paper

Use ADS, Crossref, or DataCite. Choose the lookup order, or add your own references when a service has no match.

02

Keep your edits

Preserve metadata and file history. Preview renames and reconcile files that changed outside the application.

03

Work locally

Your catalog stays on your computer. Browse and edit without an ADS account. Online lookups contact the selected providers.

Everyday workflows

Write, file, and present your research

BibTeX

Keep a .bib for your paper

Add the papers you cite to an ADS library, then export BibTeX for LaTeX or Overleaf. A watcher can keep the file current while you write.

Watch

Rename new papers automatically

Watch a folder. Each new PDF gets publication details and a filename from your template.

CV

Make your CV from ADS

Build your publication list in LaTeX, HTML, Markdown, or plain text. Choose how to highlight your name and how each entry looks.

See the workflows →

macOS · Windows · Linux

Choose your installation

Download the latest release for your operating system. Release bundles are unsigned. macOS downloads include DMG installers. See the platform requirements before installing.

Desktop releasesInstall steps →

CLI and Python API

Use the query tools without Qt or the desktop download. Python 3.10 or newer is required.

pip install adsfolio
adsfolio search 'author:Einstein' --rows 5 --json

For an isolated CLI, use uv tool install adsfolio. ADS searches require an ADS token.

CLI and API guide · Download the agent skill

macOS with Homebrew

Install the published Homebrew cask:

brew install --cask ysBach/adsfolio/adsfolio

From source

git clone https://github.com/ysBach/adsfolio.git
cd adsfolio
uv sync --all-extras
uv run adsfolio-gui

Desktop builds are currently unsigned. See the guide for OS requirements and installation limits.