🔧 MOD BOOT SDCARD

Custom bootloader modifications for SD card-based ARM embedded systems (Amlogic S905x/S912 STB)

Automate the process of modifying OpenWrt firmware boot partitions for Amlogic-based set-top boxes. Supports manual installation and automated GitHub Actions workflow.

---

✨ Features

• 🚀 Automated boot partition modification via GitHub Actions
• 🔧 Manual installation support for advanced users
• 📦 Multi-source firmware support: MediaFire, Google Drive, Mega, direct links
• 🎯 STB compatibility: Amlogic S905x, S912 chipsets
• ⚡ Fast processing: 2-5 minutes via GitHub Actions

---

🛠️ Manual Installation

Prerequisites

• OpenWrt firmware SD card
• AMLogic BootCardMaker tool
• Text editor

Steps

1. Mount the boot partition of your OpenWrt SD card
2. Copy repository contents to the boot partition
3. Edit extlinux/extlinux.conf:
   • Replace UUID with the value from uEnv.txt
4. Configure DTB (Device Tree Blob) for your STB model in:
   • extlinux.conf
   • boot.ini
   • uEnv.txt
5. Rename u-boot file:

   mv u-boot-s905x-s912.bin u-boot.ext

6. Create boot card using AMLogic BootCardMaker
7. Done! Insert SD card and boot

---

🤖 Automated Installation (GitHub Actions)

Steps

1. Fork this repository
2. Go to Actions tab in your forked repo
3. Select "Mod SDCard" workflow
4. Click "Run workflow"
5. Configure:
   • Select your STB type (S905x/S912)
   • Enter firmware download link
6. Wait 2-5 minutes for processing
7. Download modified firmware from Releases page
8. Flash to SD card and boot!

Supported Firmware Sources

• 📁 MediaFire
• ☁️ Google Drive
• 💾 Mega.nz
• 🔗 Direct download links

---

📋 File Structure

mod-boot-sdcard/
├── BootCardMaker/       # AMLogic boot card creation tool
├── extlinux/            # ExtLinux boot configuration
│   └── extlinux.conf    # Boot loader config
├── files/               # Additional boot files
├── aml_autoscript       # Amlogic boot script
├── boot.ini             # Boot initialization
├── uEnv.txt             # U-Boot environment variables
└── u-boot-s905x-s912.bin # U-Boot bootloader

---

🎯 Supported Devices

• Amlogic S905x-based STBs
• Amlogic S912-based STBs
• OpenWrt-compatible ARM devices

---

📝 Configuration Files

extlinux.conf

Boot loader configuration with kernel parameters and DTB selection.

boot.ini

Legacy boot script for older bootloaders.

uEnv.txt

U-Boot environment variables (UUID, root partition, etc.).

---

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest features
• Submit pull requests

---

📄 License

This project is open source. See LICENSE for details.

---

⚠️ Disclaimer

Modifying bootloaders can brick your device if done incorrectly. Proceed at your own risk. Always backup your original firmware before making modifications.

---

🌟 Support

If this project helped you, consider giving it a ⭐ star!

---

Made with ❤️ for the OpenWrt & ARM community