|
| 1 | +<h1 align="center"> |
| 2 | + MySQL Password Reset Tool |
| 3 | + <br> |
| 4 | +</h1> |
| 5 | + |
| 6 | +<h4 align="center">Reset your forgotten MySQL root password safely in seconds</h4> |
| 7 | + |
| 8 | +<p align="center"> |
| 9 | + <a href="https://github.com/devddine/mysql-password-reset/issues"> |
| 10 | + <img alt="GitHub Issues" src="https://img.shields.io/github/issues/devddine/mysql-password-reset?style=plastic"> |
| 11 | + </a> |
| 12 | + <a href="https://github.com/devddine/mysql-password-reset/pulls"> |
| 13 | + <img alt="GitHub Pull Requests" src="https://img.shields.io/github/issues-pr/devddine/mysql-password-reset?style=plastic"> |
| 14 | + </a> |
| 15 | + <a href="https://github.com/devddine/mysql-password-reset/graphs/contributors"> |
| 16 | + <img alt="GitHub contributors" src="https://img.shields.io/github/contributors/devddine/mysql-password-reset?style=plastic"> |
| 17 | + </a> |
| 18 | + <a href="https://github.com/sponsors/devddine"> |
| 19 | + <img alt="GitHub Sponsors" src="https://img.shields.io/github/sponsors/devddine?style=plastic"> |
| 20 | + </a> |
| 21 | +</p> |
| 22 | + |
| 23 | +<p align="center"> |
| 24 | + <a href="#-quick-start">Quick Start</a> • |
| 25 | + <a href="#-prerequisites">Prerequisites</a> • |
| 26 | + <a href="#-troubleshooting">Troubleshooting</a> • |
| 27 | + <a href="#-safety">Safety</a> • |
| 28 | + <a href="#-contributing">Contributing</a> • |
| 29 | + <a href="#-license">License</a> |
| 30 | +</p> |
| 31 | + |
| 32 | +--- |
| 33 | + |
| 34 | +## 🚀 Quick Start |
| 35 | + |
| 36 | +**Windows:** |
| 37 | +```bash |
| 38 | +Right-click 'run.bat' → Run as administrator |
| 39 | +``` |
| 40 | + |
| 41 | +**Mac/Linux:** |
| 42 | +```bash |
| 43 | +chmod +x run.sh |
| 44 | +sudo ./run.sh |
| 45 | +``` |
| 46 | + |
| 47 | +## ✅ Prerequisites |
| 48 | + |
| 49 | +- Python installed |
| 50 | +- MySQL installed |
| 51 | +- Admin/sudo access |
| 52 | +- Data backup (optional but recommended) |
| 53 | + |
| 54 | +## 📁 Project Structure |
| 55 | + |
| 56 | +``` |
| 57 | +├── run.bat (Windows launcher) |
| 58 | +├── run.sh (Mac/Linux launcher) |
| 59 | +├── src/main.py (Reset tool) |
| 60 | +├── README.md (You are here) |
| 61 | +└── LICENSE (MIT License) |
| 62 | +``` |
| 63 | + |
| 64 | +## ❓ Troubleshooting |
| 65 | + |
| 66 | +| Issue | Solution | |
| 67 | +|-------|----------| |
| 68 | +| Python not found | Download from https://www.python.org/downloads/ | |
| 69 | +| Permission denied | Use `sudo ./run.sh` | |
| 70 | +| MySQL not found | Ensure MySQL is installed | |
| 71 | + |
| 72 | +## 🔒 Safety |
| 73 | + |
| 74 | +- Your password is **never saved** to disk |
| 75 | +- Your password is **never logged** or sent anywhere |
| 76 | +- All temporary files are **automatically deleted** |
| 77 | +- You need admin rights to make this work (that's normal!) |
| 78 | + |
| 79 | +## 🐛 Issues? |
| 80 | + |
| 81 | +Found a bug? Report it: https://github.com/devddine/mysql-password-reset/issues |
| 82 | + |
| 83 | +## ❤️ Support This Project |
| 84 | + |
| 85 | +- ⭐ Star the repo |
| 86 | +- 💬 Share feedback |
| 87 | +- 🤝 Sponsor: https://github.com/sponsors/devddine |
| 88 | + |
| 89 | +## 📄 License |
| 90 | + |
| 91 | +MIT License - see [LICENSE](LICENSE) file for details |
| 92 | + |
| 93 | +--- |
| 94 | + |
| 95 | +<div align="center"><sub>Built with ❤️ by <a href="https://github.com/devddine">devddine</a></sub></div> |
0 commit comments