{"id":29295025,"url":"https://github.com/zudsniper/ventoy_linux_recovery_helper","last_synced_at":"2025-07-06T14:02:04.289Z","repository":{"id":302949634,"uuid":"1014029737","full_name":"zudsniper/ventoy_linux_recovery_helper","owner":"zudsniper","description":"🛠️ Automated Linux recovery toolkit using Ventoy. Multi-boot USB creator with resumable downloads, smart system repair, and comprehensive recovery tools for Ubuntu and Debian systems.","archived":false,"fork":false,"pushed_at":"2025-07-04T23:01:15.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-05T00:19:53.973Z","etag":null,"topics":["automation","bash","debian","linux","multi-boot","recovery","system-repair","ubuntu","usb","ventoy"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zudsniper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-04T23:00:40.000Z","updated_at":"2025-07-04T23:01:22.000Z","dependencies_parsed_at":"2025-07-05T00:20:01.380Z","dependency_job_id":"1d4b4d19-3c3e-4404-a6d2-f93172f80fab","html_url":"https://github.com/zudsniper/ventoy_linux_recovery_helper","commit_stats":null,"previous_names":["zudsniper/ventoy_linux_recovery_helper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zudsniper/ventoy_linux_recovery_helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fventoy_linux_recovery_helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fventoy_linux_recovery_helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fventoy_linux_recovery_helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fventoy_linux_recovery_helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zudsniper","download_url":"https://codeload.github.com/zudsniper/ventoy_linux_recovery_helper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zudsniper%2Fventoy_linux_recovery_helper/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263913668,"owners_count":23529073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","bash","debian","linux","multi-boot","recovery","system-repair","ubuntu","usb","ventoy"],"created_at":"2025-07-06T14:00:39.562Z","updated_at":"2025-07-06T14:02:04.274Z","avatar_url":"https://github.com/zudsniper.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛠️ Ventoy Linux Recovery Helper\n\nA comprehensive, automated toolkit for creating multi-boot USB recovery drives using Ventoy. Perfect for system administrators, Linux enthusiasts, and anyone who needs reliable system recovery tools.\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![Platform](https://img.shields.io/badge/platform-Linux-green.svg)\n![Ventoy](https://img.shields.io/badge/Ventoy-1.0.99-orange.svg)\n\n## 🚀 Features\n\n- **🔄 Resumable Downloads** - Never re-download ISOs\n- **🎯 Smart Recovery** - Automated system repair with one command\n- **📱 File Sharing** - LocalSend integration for wireless transfers\n- **🖥️ Multi-OS Support** - Ubuntu LTS/Current + Debian Stable/Testing\n- **⚡ One-Click Setup** - Fully automated Ventoy installation\n- **🔧 Comprehensive Tools** - Filesystem repair, GRUB fix, package management\n\n## 📦 What's Included\n\n### Operating Systems\n- **Ubuntu 24.04.2 LTS** (Noble Numbat) - 5 year support until 2029\n- **Ubuntu 24.10** (Oracular Oriole) - Current release  \n- **Ubuntu 25.04** (Plucky Puffin) - Latest release\n- **Debian 12.11** (Bookworm) - Current stable\n- **Debian 13** (Trixie) - Testing/next release\n\n### Recovery Tools\n- `auto-recovery.sh` - Automated system repair (filesystem, GRUB, packages)\n- `install-localsend.sh` - Cross-platform file sharing\n- `master-recovery.sh` - Interactive recovery menu\n- Smart partition detection and mounting\n\n## 🔧 Quick Start\n\n### 1. Clone and Setup\n```bash\ngit clone https://github.com/zudsniper/ventoy_linux_recovery_helper.git\ncd ventoy_linux_recovery_helper\n\n# Download ISOs (resumable)\n./download-isos.sh\n\n# Install to USB drive (will detect your drive)\nsudo ./setup-ventoy.sh\n```\n\n### 2. Using for Recovery\n1. Boot from your Ventoy USB\n2. Select any Linux ISO from the menu\n3. In the live environment:\n```bash\nsudo mount /dev/sda1 /mnt\ncd /mnt/recovery_scripts\nsudo ./master-recovery.sh\n```\n\n## 💾 System Requirements\n\n- **USB Drive**: 32GB+ (64GB recommended)\n- **Target Systems**: x86_64 (AMD64) architecture\n- **Network**: Required for downloads and some recovery operations\n- **Host OS**: Linux with bash, wget, curl\n\n## 📊 Storage Usage\n\n| Component | Size | Purpose |\n|-----------|------|---------|\n| Ubuntu 24.04.2 LTS | ~6.0GB | Primary recovery OS |\n| Ubuntu 24.10 | ~5.3GB | Current release |\n| Ubuntu 25.04 | ~5.9GB | Latest features |\n| Debian 12.11 | ~3.3GB | Stable alternative |\n| Debian 13 (testing) | ~810MB | Next-gen tools |\n| Recovery scripts | ~1MB | Automation tools |\n| **Total** | **~21.3GB** | Fits on 32GB+ USB |\n\n## 🛠️ Advanced Usage\n\n### Resume Interrupted Downloads\n```bash\n./download-isos.sh        # Automatically resumes from where it stopped\n# OR\n./resume-downloads.sh     # Quick alias\n```\n\n### Manual System Recovery\n```bash\n# Mount broken system\nsudo mkdir -p /mnt/recovery\nsudo mount /dev/[root-partition] /mnt/recovery\nsudo mount --bind /dev /mnt/recovery/dev\nsudo mount --bind /proc /mnt/recovery/proc\nsudo mount --bind /sys /mnt/recovery/sys\n\n# Enter system\nsudo chroot /mnt/recovery\n\n# Fix issues\nupdate-grub\nupdate-initramfs -u\napt --fix-broken install\n```\n\n### Emergency One-Liner\n```bash\nsudo mount /dev/sda1 /mnt \u0026\u0026 cd /mnt/recovery_scripts \u0026\u0026 sudo ./auto-recovery.sh\n```\n\n## 🆘 Common Recovery Scenarios\n\n| Problem | Solution |\n|---------|----------|\n| Won't boot / GRUB error | Auto-recovery fixes GRUB automatically |\n| Package conflicts | `dpkg --configure -a` + `apt --fix-broken install` |\n| Kernel panic | Rebuild initramfs and update GRUB |\n| File system corruption | Automated `fsck` repair |\n| Need files from broken system | Mount + LocalSend for wireless transfer |\n\n## 🔄 Updating Your Toolkit\n\n```bash\ncd ventoy_linux_recovery_helper\ngit pull                    # Get latest scripts\n./download-isos.sh         # Download new ISOs\nsudo ./setup-ventoy.sh     # Reinstall to USB\n```\n\n## 📁 Project Structure\n\n```\nventoy_linux_recovery_helper/\n├── download-isos.sh          # Resumable ISO downloader\n├── setup-ventoy.sh           # Complete Ventoy installation\n├── auto-recovery.sh          # Automated system repair\n├── install-localsend.sh      # File sharing setup\n├── resume-downloads.sh       # Quick resume alias\n├── README.md                 # This file\n├── LICENSE                   # MIT License\n└── .gitignore               # Git ignore rules\n```\n\n## 🤝 Contributing\n\nContributions welcome! Please read our contributing guidelines:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Areas for Contribution\n- Additional Linux distributions\n- More recovery automation\n- Hardware-specific fixes\n- Documentation improvements\n- Testing on different systems\n\n## 📋 Roadmap\n\n- [ ] Add more Linux distributions (Fedora, openSUSE, etc.)\n- [ ] Windows PE recovery tools integration\n- [ ] Automated hardware diagnostics\n- [ ] Cloud backup integration\n- [ ] Web-based recovery interface\n- [ ] Support for ARM64 systems\n\n## ⚠️ Disclaimer\n\nThis toolkit will **completely erase** your target USB drive. Always backup important data before running the setup script. Use at your own risk - while extensively tested, system recovery operations can potentially cause data loss if used incorrectly.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- [Ventoy Team](https://www.ventoy.net/) for the amazing multi-boot solution\n- [Ubuntu](https://ubuntu.com/) and [Debian](https://www.debian.org/) communities\n- [LocalSend](https://localsend.org/) for cross-platform file sharing\n- All contributors and testers\n\n## 📞 Support\n\n- 🐛 [Report Bugs](https://github.com/zudsniper/ventoy_linux_recovery_helper/issues)\n- 💡 [Request Features](https://github.com/zudsniper/ventoy_linux_recovery_helper/issues)\n- 📖 [Documentation](https://github.com/zudsniper/ventoy_linux_recovery_helper/wiki)\n- 💬 [Discussions](https://github.com/zudsniper/ventoy_linux_recovery_helper/discussions)\n\n---\n\n**Made with ❤️ for the Linux community**\n\n*Star ⭐ this repo if it helped you recover a system!*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzudsniper%2Fventoy_linux_recovery_helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzudsniper%2Fventoy_linux_recovery_helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzudsniper%2Fventoy_linux_recovery_helper/lists"}