v1.0.3 · Open source · Local-first

Study for the IPhO,
on your machine

Download Kevin Zhou's training handouts and official IPhO theory papers from phoXiv. Track progress, view solutions, upload work, and solve with Xournal++ — all offline.

npm release MIT Node 18+
npm install -g github:daniyal-sh/ipho
ipho download all
ipho

Works immediately — no npm publish required.

npm install -g @daniyalsh/ipho
ipho download all
ipho

Package: @daniyalsh/ipho · CLI command: ipho

git clone https://github.com/daniyal-sh/ipho.git
cd ipho
npm install
npm link
ipho download all
ipho

Your private study workspace

Runs at http://127.0.0.1:3847 — PDFs, progress, notes, and Xournal++ in one place.

127.0.0.1:3847 — IPhO2024 / T1
ipho
M1 Mechanics I
IPhO 2024
IPhO 2023
E1 E&M I
📄 Theory 1 — Greenhouse Effect

Problem T1

In progress Notes Xournal

Handout ↔ Solution PDF toggle

Everything in one local library

📚

Kevin Zhou handouts

Full olympiad curriculum — mechanics, E&M, thermo, relativity, waves, modern, review, USAPhO mocks.

🏆

IPhO past papers

Theory T1–T3 for every year from 2001+, with solutions when available on phoXiv.

Progress tracking

Status per problem, notes, completion stats, and filters — saved to your disk only.

Xournal++

Stylus notebooks per problem. Continue editing .xopp files and sync previews.

Built on trusted archives

Your library folder

Default: ./ipho-library — override with IPHO_DIR or ipho -d

ipho-library/
  handouts/          # PDFs (curriculum + ipho/YYYY/)
  data/
    progress.json    # status & notes
    uploads/         # solution photos
    xournal/         # .xopp notebooks