Piano App

---

This project is the Piano App web application. It is a beautiful, interactive 88-key piano you can play in your browser!

· View Demo · Report Bug / Request Feature ·

---

📖 About

This project is a modern web-based 88-key piano simulator. It uses Tone.js and high-quality piano samples to provide a realistic piano playing experience directly in your browser. The interface is clean, responsive, and user-friendly.

💡 Purpose

To provide an accessible, interactive piano for learning, practice, and fun—no installation required, all running client-side in the browser.

🚀 Tech Stack

Tone.js	Web audio synthesis and playback
HTML5	Markup and structure
CSS3	Modern, responsive styling
JavaScript	Client-side logic

🧐 What's Inside?

• 🎹 88-Key Piano: Play all keys from A0 to C8
• 🖱️ Mouse & Keyboard Support: Play with your mouse or computer keyboard
• 🎧 Realistic Sound: High-quality sampled piano notes
• 🎚️ Volume, Reverb, Octave Controls: Adjust your sound
• 🕹️ Sustain Pedal: Use the spacebar for sustain
• 📱 Responsive UI: Works on desktop and mobile
• 📝 No Backend: All processing is done in the browser

⚡️ Getting Started

📦 Prerequisites

• Modern web browser (Chrome, Firefox, Edge, Safari)
• No installation required for demo

🚀 Local Usage

Just open index.html in your browser. No build step needed.

⚠️ Important: How to Run This Project

Note: You cannot simply double-click index.html to run this app because browser security restrictions will prevent the audio samples from loading locally. You must serve the project with a local or remote web server.

🖥️ Recommended Ways to Run

1. VS Code (Recommended)

• Install the Live Server extension.
• Right-click index.html and select "Open with Live Server".
• The app will open in your browser and all features will work correctly.

2. JetBrains IDEs (WebStorm, PhpStorm, etc.)

• Right-click index.html and choose "Open in Browser" (JetBrains IDEs automatically serve files over HTTP).
• Alternatively, use the built-in web server feature.

3. Command Line (Windows, macOS, Linux)

• Python 3 (cross-platform):

  python -m http.server 8000
  # Then open http://localhost:8000 in your browser

• Node.js (http-server):

  npx http-server .
  # Then open the shown URL (usually http://localhost:8080)

• PHP (if installed):

  php -S localhost:8000
  # Then open http://localhost:8000

Do not use the file:// protocol (double-clicking the file) — audio samples will not load!

📚 Features

• Realistic, client-side piano sound
• Modern and clean UI
• No data leaves your device
• Supports mouse and keyboard input
• Responsive design for all devices

🔑 License

MIT License © 2025 Yasin Ateş

See LICENSE for more information.

---

✨ This README was generated by markdown-manager.