# Drum Rhythm Game

A browser-based drum rhythm game. Notes scroll down the screen and you hit the matching drum pad in time — like Rock Band, but it runs entirely in your browser with no server, no dependencies, no install. Just open `index.html`.

Works with **keyboard**, **Wii Rock Band drums**, **Xbox/PS Rock Band drums**, **Guitar Hero drums**, or any USB gamepad. Includes a **Remap Pads** button to configure any controller.

## How to Play

1. Open `index.html` in Chrome or Edge
2. Pick a genre and song
3. Adjust speed/volume sliders if desired
4. Click **Start**
5. Hit the pads when notes reach the line:
   - **F** = Red (Tom)
   - **G** = Yellow (Snare)
   - **H** = Blue (Hi-hat)
   - **J** = Green (Tom)
   - **Space** = Kick (Bass drum)
   - **Escape** = Pause
6. **Right-click** any genre tab or song to hide it

## Features

- **17 Genres** across two modes: synth orchestra songs + drum beat patterns
- **97 synth pieces** with full synthesized orchestra background
- **120 drum patterns** across 8 genres
- **Drums or Orchestra mode** — choose whether pad hits play drum sounds or the actual melody note
- **Speed control** — slow down to 50% for practice or speed up to 150%
- **Volume control** — adjustable master volume
- **Pause/Resume** — press Escape or the pause button mid-song
- **Gamepad Remap** — configure any USB drum kit with the Remap Pads button
- **Hide genres/songs** — right-click to hide, "Show All" to restore, saved across sessions
- **Multiplayer** — take turns, scores compared at the end
- **Pad Toggles** — turn pads on/off to adjust difficulty
- **Preview** — hear any song before playing
- **Leaderboard** — scores saved locally
- **Settings persistence** — speed, volume, gamepad mapping, hidden items all saved to localStorage
- **Math-protected reset** — Reset All Data requires solving a math problem to prevent accidents

## Song List

### Prime (6 songs)
- Twinkle Twinkle Little Star (Traditional, 1760s)
- Mary Had a Little Lamb (S.J. Hale, 1830)
- Happy Birthday (P.S. Hill, 1893)
- Chopsticks (Euphemia Allen, 1877)
- Lavender's Blue (English Traditional, 1670s)
- Shortnin' Bread (Traditional, 1900s)

### Singalong (20 songs)
- Drunken Sailor (Sea Shanty)
- Wellerman (NZ Sea Shanty, 1860s)
- Molly Malone (Irish, 1880s)
- Whiskey in the Jar (Irish Traditional)
- The Parting Glass (Irish/Scots Traditional)
- Leave Her Johnny (Sea Shanty)
- Blow the Man Down (Sea Shanty)
- Randy Dandy Oh (Sea Shanty)
- South Australia (Sea Shanty)
- Roll the Old Chariot Along (Sea Shanty)
- Haul Away Joe (Sea Shanty)
- Spanish Ladies (Royal Navy, 1790s)
- The Skye Boat Song (Scottish, 1884 — Outlander)
- Bella Ciao (Italian Partisan Folk — Money Heist)
- Amazing Grace (1779)
- Auld Lang Syne (1788)
- When the Saints Go Marching In (Spiritual)
- Oh My Darling, Clementine (1884)
- Scarborough Fair (English Medieval)
- My Bonnie Lies Over the Ocean (Scottish, 1881)

### Christmas (10 songs)
- Jingle Bells (1857)
- Silent Night (1818)
- Deck the Halls (1862)
- We Wish You a Merry Christmas (1500s)
- O Christmas Tree (1824)
- The First Noel (1823)
- Joy to the World (1719)
- Away in a Manger (1885)
- 12 Days of Christmas (1780)
- Hark the Herald Angels Sing (1840)

### Folk (8 songs)
- Oh! Susanna (Stephen Foster, 1848)
- Greensleeves (English, 1580)
- Camptown Races (Stephen Foster, 1850)
- Red River Valley (American, 1870s)
- Home on the Range (American, 1870s)
- Yankee Doodle (American, 1770s)
- Turkey in the Straw (American, 1820s)
- Danny Boy (Irish, 1910s)

### Spirituals (8 songs)
- Swing Low, Sweet Chariot (1862)
- Go Down Moses (Traditional)
- Wade in the Water (Traditional)
- Kumbaya (Traditional)
- Michael Row the Boat Ashore (1860s)
- He's Got the Whole World (Traditional)
- Nobody Knows the Trouble I've Seen (Traditional)
- Battle Hymn of the Republic (1861)

### World (8 songs)
- Hava Nagila (Jewish/Israeli, 1918)
- La Cucaracha (Mexican Traditional)
- Frere Jacques (French, 1780s)
- Cielito Lindo (Mexican, 1882)
- Waltzing Matilda (Australian, 1895)
- 'O Sole Mio (Italian, 1898)
- Take Me Out to the Ball Game (American, 1908)
- She'll Be Coming Round the Mountain (American, 1890s)

### Classical (26 pieces)
- Beethoven's 5th (Opening)
- Hall of the Mountain King (Grieg)
- O Fortuna (Orff)
- Ride of the Valkyries (Wagner) — Apocalypse Now
- Mars, Bringer of War (Holst)
- Toccata & Fugue in D Minor (Bach)
- William Tell Overture — Gallop (Rossini) — The Lone Ranger
- Bolero (Ravel)
- Also Sprach Zarathustra (R. Strauss) — 2001: A Space Odyssey
- Barber of Seville Overture (Rossini) — Bugs Bunny
- The Blue Danube (J. Strauss II) — 2001: A Space Odyssey
- Sabre Dance (Khachaturian)
- Night on Bald Mountain (Mussorgsky) — Fantasia
- Sorcerer's Apprentice (Dukas) — Fantasia
- Swan Lake Theme (Tchaikovsky)
- Morning Mood (Grieg)
- Flight of the Bumblebee (Rimsky-Korsakov)
- Dance of the Sugar Plum Fairy (Tchaikovsky)
- 1812 Overture Finale (Tchaikovsky)
- Habanera from Carmen (Bizet)
- Spring from Four Seasons (Vivaldi)
- Fur Elise (Beethoven)
- Canon in D (Pachelbel)
- Hungarian Dance No. 5 (Brahms)
- Ode to Joy (Beethoven)
- William Tell Overture — Storm (Rossini)

### Video Games (5 pieces)
- Korobeiniki / Tetris Theme (Russian Folk, 1861)
- Turkish March (Mozart)
- Hungarian Rhapsody No. 2 (Liszt)
- Can-Can (Offenbach)
- Kalinka (Russian Folk, 1860)

### Chiptune Originals (6 pieces, composed by Claude.ai)
- Pixel Quest (Platformer)
- Starfield (Space Shooter)
- Dragon's Keep (RPG Overworld)
- Turbo Dash (Racing)
- Dungeon Crawl (Dark Adventure)
- Victory Fanfare (Boss Defeated)

### Drum Patterns (120 patterns)
- **Rock** (15): Basic Rock, Classic Rock, Punk Rock, Arena Rock, and more
- **Metal** (15): Double Bass, Thrash, Doom Metal, Blast Beat, and more
- **Jazz** (15): Jazz Ride, Bebop, Bossa Nova, Fusion, and more
- **Hip Hop** (15): Boom Bap, Trap, Lo-Fi, Drill, and more
- **Funk** (15): Classic Funk, Ghost Notes, P-Funk, Afrobeat, and more
- **Latin** (15): Samba, Salsa, Reggaeton, Cumbia, and more
- **Electronic** (15): Four on the Floor, Breakbeat, DnB, Dubstep, and more
- **Country** (15): Two-Step, Bluegrass, Rockabilly, Gospel, and more

## USB Drum Kit Compatibility

The Gamepad API works with any USB controller. Use the **Remap Pads** button to configure your kit.

| Kit | Connection |
|-----|-----------|
| Wii Rock Band drums | USB dongle (default mapping) |
| Xbox 360 Rock Band drums | USB wired |
| PS3/PS4 Rock Band drums | USB |
| Guitar Hero drums | USB |
| Roland/Alesis/Donner | USB-MIDI adapter |
| Any USB gamepad | Remap to configure |

## Data Storage

All data is saved to **localStorage** in your browser — nothing is lost when you close the page.

| Key | What's Stored | How to Clear |
|-----|--------------|-------------|
| `drgame5` | Leaderboard scores | Clear button on Leaderboard |
| `drgameSettings` | Speed + volume | Reset button in Settings |
| `drgameGpMap` | Gamepad button mapping | Reset All Data |
| `drgameHidden` | Hidden genre tabs | Right-click → Show All |
| `drgameHiddenSongs` | Hidden songs per genre | Show N hidden button |

**Reset All Data** clears everything but requires solving a math problem first.

## Synthesizer

All sounds are generated in real-time using the Web Audio API — no audio files needed:

| Sound | Method |
|-------|--------|
| Kick | Sine oscillator, 180Hz to 40Hz sweep |
| Snare | Highpass noise burst + 180Hz tone |
| Hi-hat | Highpass noise burst, very short |
| Toms | Sine oscillator pitch sweep |
| Strings | Sawtooth + lowpass filter |
| Brass | Square + lowpass filter |
| Woodwind | Triangle oscillator |
| Bass | Sine oscillator, low frequency |
| Timpani | Sine frequency sweep |
| Choir | Multiple detuned sine oscillators |
| Chiptune | Square wave with pulse bass |

## Tech

- Pure vanilla JavaScript — no libraries, no build step, no server
- Single `index.html` file (~4500 lines)
- Web Audio API for all sound synthesis
- Canvas 2D for the note highway
- Gamepad API for drum kit input
- localStorage for all persistent data
- Works on Windows, Linux, and Mac

## License

[MIT](LICENSE)
