![tidal beats banner long](https://github.com/user-attachments/assets/be588338-19e7-4c75-bb4b-aeddc60700b3)

# Tidal Beats

A beautiful ocean-themed rhythm game that brings the flow of music to life. 

## What is Tidal Beats?

Tidal Beats is a 4-key rhythm game inspired by the mesmerizing patterns of ocean waves. Whether you're a rhythm game veteran or just starting out, Tidal Beats offers an accessible yet challenging way to ride the musical waves.

![image](https://github.com/user-attachments/assets/e50143bb-d91b-4edf-a5f2-e48a14eeb892)


## Key Features

- Every note creates dynamic wave animations
- Classic VSRG (Vertical Scrolling Rhythm Game) mechanics with D-F-J-K controls
- Includes pre-existing tracks like Silhouette (KANA-BOON), Senbonzakura (Lindsey Stirling), Bad Apple! and more
- Import your own .osz files and custom beatmaps --> This means you can play ANY osu!mania songs right from your browser
- Built-in calibration system for audio offset
- Adjust scroll speed, visual effects, audio levels, and more
- Underwater aesthetics with flowing animations
- Runs in any modern web browser


##  Songs & Content

The game comes with several pre-loaded songs, all having multiple difficulties:
- **Silhouette (Naruto)** by KANA-BOON 
- **Quiet Water** by Toby Fox
- **Bad Apple** by Masayoshi Minoshima
- **NANO DEATH** by LeaF
- **Senbonzakura** by Lindsey Stirling
- **Yeah Boy** by Shooting Stars
- Plus support for custom .osz file imports

## Getting started

### Quick Start
1. Open the link in your browser
2. Calibrate your audio offset (recommended)
3. Select a song/difficulty and start playing!

### Controls
- **D, F, J, K** - Hit the notes as they reach the judgment line
- **ESC** - Pause/resume game
- **Settings** - Customize your experience

### Importing Custom Songs
1. Go to [https://osu.ppy.sh/beatmapsets?m=3&sort=plays_desc](url)
2. Choose or search for a song that you like (ensure that it supports osu!mania)
3. Download the song (.osz file)
4. In the game, go to Custom Charts --> OSZ file and then upload the song
5. Select a difficulty and start playing!

**Note**: Only 4-key (4K) osu!mania charts are supported.

### Running Locally
1. Clone this repository
2. Start a local web server in the project directory
3. Open `index.html` in your browser

## Technical Details

Built with:
- **Vanilla JavaScript**
- **HTML5 Canvas**
- **Web Audio API**
- **Modern CSS**



## 📄 License

This project is for educational and personal use. Song files and charts belong to their respective creators and artists.

---

*Ride the rhythm of the ocean!* 🌊🎵