🎵 Skaler Tools

ระบบคำนวณทฤษฎีทางคอร์ดและสเกลแบบมืออาชีพ พัฒนาโดย JayDusit

✨ Features

🎹 Professional Jazz Theory System

• 4-Color Note Categorization: แบ่งโน้ตตามหน้าที่ทางดนตรี
  • 🟢 TARGET (Chord Tones) - เสาหลัก ลงแรงได้
  • 🔵 TENSION (9, 11, 13) - สีสวย ค้างได้
  • 🟡 DNA (Characteristic) - ตัวตนของโหมด
  • 🔴 AVOID - ต้องผ่าน/แก้

🎼 Comprehensive Mode Support

• Ionian, Dorian, Phrygian, Lydian, Mixolydian, Aeolian, Locrian
• Blues Scale, Melodic Minor, Altered Scale
• แสดงโน้ตที่เข้ากันได้กับคอร์ดแต่ละประเภท

🎸 Reharmonization Techniques (7 Patterns)

1. Major 2-5-1 - สูตรพื้นฐานเพลงป๊อป/แจ๊ส
2. Backdoor Progression - ฟีลเท่แบบแจ๊สยุคเก่า
3. Minor 2-5-1 - หัวใจเพลงเศร้า
4. Line Cliché - บันไดเสียงที่ค่อยๆ ดิ่งลง
5. Picardy Third - จบเพลงเศร้าด้วยคอร์ดสว่าง
6. Modal Borrow - ยืมคอร์ดข้ามโหมด
7. bVI-bVII-I - Epic Ending (Mario Cadence)

🎯 Supported Chord Types

• Major, Maj7, Minor, m7, 7
• คำนวณอัตโนมัติสำหรับทุกคีย์ (12 โน้ต)

🚀 Quick Start

Prerequisites

• Python 3.11+
• pip

Installation

# Clone the repository
git clone https://github.com/yourusername/skaler-tools.git
cd skaler-tools

# Install dependencies
pip install -r requirements.txt

# Run the application
python api.py

เปิดบราวเซอร์ที่ http://localhost:5000

📁 Project Structure

skaler-tools/
├── api.py              # Flask API server
├── theory.py           # Music theory logic (12-semitone system)
├── requirements.txt    # Python dependencies
├── Procfile           # Deployment configuration
├── runtime.txt        # Python version specification
├── static/
│   ├── index.html     # Main UI
│   ├── style.css      # Styling
│   └── app.js         # Frontend logic
└── README.md

🌐 Deployment

Deploy to Render

1. สร้าง account ที่ render.com
2. เชื่อมต่อ GitHub repository
3. สร้าง Web Service ใหม่
4. ตั้งค่า:
   • Build Command: pip install -r requirements.txt
   • Start Command: python api.py
   • Environment: Python 3

Deploy to Railway

1. สร้าง account ที่ railway.app
2. คลิก "New Project" → "Deploy from GitHub repo"
3. เลือก repository
4. Railway จะ detect และ deploy อัตโนมัติ

Deploy to Heroku

# Install Heroku CLI
# Login to Heroku
heroku login

# Create new app
heroku create your-app-name

# Deploy
git push heroku main

# Open app
heroku open

🔧 API Endpoints

Get Chromatic Scale

GET /api/notes

Get Chord Types

GET /api/chord-types

Get Chord Notes

GET /api/chord/<root>/<chord_type>

Get Compatible Modes

GET /api/modes/<chord_type>

Get Scale Notes

GET /api/scale/<root>/<mode>

Get Labeled Notes (Jazz Theory)

GET /api/label-notes/<root>/<mode>

Get Reharmonization

GET /api/reharm/<root>

🎨 Technology Stack

• Backend: Python, Flask
• Frontend: HTML5, CSS3, Vanilla JavaScript
• Theory: 12-Semitone System (100% Accurate)
• Design: Glassmorphism, Dark Mode, Responsive

📝 License

MIT License - ใช้งานได้อย่างอิสระ

👨‍💻 Developer

JayDusit

• ระบบคำนวณด้วย 12 ครึ่งเสียง (12 Semitones)
• ทฤษฎีดนตรีแม่นยำ 100%

🙏 Acknowledgments

• Music Theory based on professional jazz harmony principles
• UI/UX inspired by modern music production tools
• Built with ❤️ for musicians

---

Version: 1.0.0
Last Updated: January 2026