πŸ”Š Home Speaker Build β€” Project User Manual

Everything about the project, the team, and how to run it β€” in plain language.
In this manual

1 Β· What this project is

This project designs and supplies everything you need to build your own set of home audio speakers. It's not one file β€” it's a small workspace at /home/mike/speaker-build holding a team of four specialist helpers, the one shared "brain" the whole design lives in, and a set of PDFs and tools for cutting wood.

The current plan is a stereo pair of 2-way bookshelf speakers β€” one woofer + one tweeter in each 11.5"Γ—9.5"Γ—12" ported cabinet, ~$300 for both, built from a single sheet of MDF.

Think of it as: a design team + a shopping list + a woodshop plan, all in one folder. You make the decisions; the team fills in the expert detail and keeps the numbers consistent.

2 Β· The four specialists on your team

Four role-defined helpers write their findings into the shared spec. Each owns one slice of the design:

🎚️ Sound Engineer

How it sounds

Chooses drivers, sets the tonal goal and crossover points. Answers: "what makes good sound?"

πŸͺ΅ Cabinet Designer

The box

Box volume, port tuning, panel cut list, driver placement. Answers: "what wood, cut how?"

⚑ Electronics Engineer

Wiring & crossover

Exact capacitor/inductor/resistor values, wiring, safe amp load. Answers: "what parts connect what?"

πŸ”¬ Research & Materials

Parts + money

Checks every part is for sale today, builds the priced Bill of Materials, guards your budget.

Their full job briefs live in the team/ folder. You don't need to read them to use this β€” just know each decision is double-checked by the role that owns it.

3 Β· The files in your project folder

FileWhat it is forOpen when…
hub.htmlThe control room β€” one card per specialist with one-click "brief" buttonsYou want to talk to the team or run work
design-studio.htmlPlain form editor for every spec valueYou want to change numbers quickly
design-studio-visual.htmlVisual editor β€” drawing updates as you type, plus idea photosYou're exploring sizes or a new design
shopping_list.htmlEverything to buy with links & pricesOrdering parts
build_guide.htmlPanel cut list, sheet layout, 9-step assemblyCutting & gluing wood
build_checklist.htmlUnbox β†’ bench checklist pairing parts to stepsParts arrive / at the workbench
reports/baffle_template.pdfFull-size 1:1 drilling templates (front + back)Marking hole positions on the wood
reports/build_report.htmlCombined report from all team sectionsYou want the whole spec in one read
state/spec.mdThe shared brain β€” every decision and all sectionsNothing direct β€” it's what the team writes to
tools/The engine β€” report generator + template generatorRegenerating outputs after a change
Rule of thumb: most days you only touch design-studio (to design) and the PDF (to cut). Everything else is a product of those two.

4 Β· How a build gets made, step by step

The project follows a fixed order so later steps never contradict earlier ones:

  1. Design & lock. Pick the speaker type and sizes (Sound Engineer + Cabinet Designer reach decisions).
  2. Price & verify. The Research & Materials manager confirms every part exists today, at a real price. No fantasy parts.
  3. Write the report. A generator reads the shared spec and produces the build report.
  4. Print templates. Rebuild the 1:1 PDF at your exact dimensions.
  5. Order + build. Use the shopping list, then the build guide & checklist.

Each specialist writes only its own section of the shared spec β€” that's how the report stays consistent without anyone overwriting each other.

5 Β· Designing & changing your speaker

Use the visual Design Studio (design-studio-visual.html) when you're thinking about how it looks, or the form Studio (design-studio.html) when you only need to change a number.

Note: a plain browser can't write files by itself, so "save" from a standalone browser keeps your edits locally (localStorage) and lets you export. To actually save into the spec, run the save from inside the Hermes chat (or paste the exported text back to me).

6 Β· Printing the drilling templates correctly

  1. Print baffle_template.pdf β€” it's 8 pages: 4 for the front baffle, 4 for the back.
  2. In the print dialog, set Actual size / 100% / Do not scale β€” turn OFF "Fit to page".
  3. Check the green 3-inch ruler on each page: it must measure exactly 3" with a real ruler. If it doesn't, re-print. This is the single most common way a template goes wrong.
  4. Tape the 4 pages of each face together using the corner cross-marks.
  5. Lay the paper on your panel, mark the hole centers, cut/drill.

7 Β· Building the cabinet (the short version)

  1. Cut the 6 panels per cabinet from the cut list (one MDF sheet does both).
  2. Rout driver recesses on the front baffles; drill port + terminal holes on the backs.
  3. Dry-fit, then glue + screw every butt joint. Glue all edges β€” no gaps.
  4. Add the brace; seal interior seams.
  5. Wire the crossover (amp β†’ crossover β†’ drivers; match +/βˆ’ on every driver).
  6. Mount port + drivers; add damping loosely (keep port clear).
  7. Finish, add feet, and test with a sine sweep β€” listen for buzz or port chuff.

The full 9-step version with the sheet-layout diagram is in build_guide.html.

8 Β· Words you'll meet

TermPlain meaning
2-wayTwo drivers per speaker: a woofer (bass/mid) and a tweeter (treble).
Bass-reflex / portedA box with a tuned tube (port) that reinforces the bass so a small box can go low.
SealedA closed box, no port. Tighter bass, less depth, needs more power.
CrossoverA small circuit that sends bass to the woofer and treble to the tweeter.
Cutout ØThe diameter of the hole you cut for a driver. Bigger than the flange screws to. Your template marks exactly this.
Tuning (Hz)The bass frequency the port resonates at; ~45 Hz is a good bookshelf target.
F3The low end where bass starts rolling off; lower F3 = deeper bass.
BOMBill of Materials β€” the full shopping list with prices.
Impedance (Ξ©)The electrical "load" a speaker puts on the amp; 8 Ξ© is a safe, common value.
Sensitivity (dB)How loud the speaker is on a watt; higher = louder/easier to drive.
localStorageYour browser's built-in note pad β€” Design Studio saves edits there.

9 Β· When something goes wrong

Still stuck? Just ask me in normal words β€” say "update the box to 15" tall" or "make a center channel instead" and I'll run the team and regenerate everything.