Skip to content

About

A curated tutoring-video library — 489 lessons across 8 courses, organised by unit, searchable, with progress tracking. No dependencies, no backend.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tutor Help

A curated video library for tutoring — 489 hand-picked lessons across 8 courses, organised into the units a class actually follows, searchable end to end, and it remembers what you have watched.

→ Open the library


The courses

Course Units Videos Runtime
AP Calculus BC 11 81 51 h
Algebra 10 60 16 h
Trigonometry 9 54 19 h
Precalculus 10 60 24 h
AP Statistics 9 54 11 h
General Chemistry 10 60 17 h
Organic Chemistry 10 60 25 h
Physics 10 60 24 h

AP Calculus BC is the flagship: its units, ordering and exam weightings follow the College Board Course and Exam Description, and the course page opens with a chart of where the marks actually are — Units 6 and 10 together are about a third of the paper.

What it does

  • Browse by course → unit → lesson. Three levels, no dead ends, and every view has its own URL you can send to someone.
  • Search everything — titles, channels, unit names and course names across all 489 videos, live as you type. Press / from anywhere.
  • Watch in place. Lessons play in an embedded player with the rest of the unit queued beside them, plus previous/next within the unit.
  • Progress that persists. Mark lessons watched and the unit bars, course percentages and library totals all update. Star anything to build a revision list. All of it is local to your browser — no account, no server, nothing collected.
  • Light, dark, or follow the system.

Nothing is hosted here. Every lesson plays in YouTube's own embedded player, so the creators who made these keep their views — this library only finds, checks, and organises them.

Where the data comes from

The course data is not hand-typed, and it is not invented. tools/harvest.mjs rebuilds it:

  1. One YouTube search per unit, using that unit's query. The search page carries its results in ytInitialData — id, title, channel, duration, view count — in a single request.
  2. Filter out Shorts, anything under three minutes, and non-English or background-noise uploads.
  3. Score by view count, a trusted-channel bonus and length, then take the top six per unit with a cap of two per channel, so no single creator monopolises a unit.
  4. Verify every survivor against YouTube's official oEmbed endpoint. That is the authority on the two things you cannot assume: the video still exists, and it permits embedding. The titles and channel names in the shipped data are oEmbed's own, so they are never mistyped or stale.

At the last run, all 489 videos passed verification — no dead ids, no embedding-disabled ids.

node tools/harvest.mjs            # rebuild every course
node tools/harvest.mjs physics    # rebuild one

Adding a course is a block in tools/curriculum.cjs, a run of the harvester, and one line in assets/js/data/index.js. No view code changes.

Design and engineering notes

  • No dependencies, no build step. One HTML shell, one stylesheet, one ES module, plus a data module per course. Nothing to install or keep patched.
  • Data-driven views. The sidebar, search index, exam-weight chart and every page are derived from the course modules at runtime. There is no second copy of the content to drift out of sync.
  • Hash routing, so every course, unit, lesson and search is a real shareable URL and the back button behaves — on static hosting, with no server rewrites.
  • The exam-weight chart follows a proper method. It is one series, so it uses a single hue with direct value labels; identity comes from the category axis, never from colour.
  • The eight course colours were validated, not eyeballed. They pass a six-check palette validator — lightness band, chroma floor, colour-vision-deficiency separation, normal-vision separation and contrast — against the light and dark surfaces separately, as two deliberately chosen sets rather than one flipped set. My first hand-picked palette failed three checks; this one is the result of fixing them. Colour is never the only cue regardless: every course card also carries its title and a monogram.
  • Theming is a three-state control (system / light / dark) built on light-dark() over a single token set, so every colour is declared exactly once.
  • Accessibility: semantic landmarks, a skip link, visible focus rings, live regions for status changes, aria-current on the active unit, full keyboard operation, and every animation gated behind prefers-reduced-motion.
  • Privacy: embeds use youtube-nocookie.com, and progress lives in localStorage — there is no analytics, no account, and no back end.

Running it locally

No toolchain. Serve the folder (ES modules will not load over file://):

python3 -m http.server 8000   # → http://localhost:8000

Structure

index.html                  app shell
assets/css/styles.css       design tokens, components, chart, print
assets/js/app.js            router, views, search, progress
assets/js/data/index.js     course registry (import order = display order)
assets/js/data/*.js         one module per course
tools/curriculum.cjs        unit taxonomy + search query per unit
tools/harvest.mjs           rebuilds the data files

A note on the videos

Every lesson belongs to the channel that made it and plays from YouTube under YouTube's own terms. This project stores nothing but ids, titles and durations, and links out to each video's page. If you are a creator and would rather not be listed, open an issue and it comes out.

Licence

MIT (see LICENSE). The videos themselves remain the property of their creators.

About

A curated tutoring-video library — 489 lessons across 8 courses, organised by unit, searchable, with progress tracking. No dependencies, no backend.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages