GitHunt
SH

shadil-rayyan/cubic_iso_guide

This is a cubic guide which i learned from various source and in the hard way

Cubic ISO Guide

GitHub last commit
GitHub repo size
License

Python


Overview

Cubic ISO Guide is a comprehensive, step-by-step guide for building and customizing Ubuntu-based ISO images using Cubic.
This project covers everything from installing Cubic, working in chroot, managing the custom-root filesystem, adding GNOME extensions, wallpapers, Plymouth boot images, desktop icons, GRUB tweaks, ISO compression, and legal considerations.

This documentation is designed to help both beginners and advanced users create fully customized Ubuntu ISOs while keeping workflows clean and professional.


Features

  • Step-by-step instructions for Cubic and Custom Root workflows
  • Detailed explanations of Linux filesystem paths used in ISO customization
  • Guides for GNOME extensions, desktop icons, wallpapers, and Plymouth boot/login images
  • ISO compression and GRUB configuration tips
  • Legal and licensing considerations for branding
  • Ready for live-build alternatives if needed
  • Fully documented with screenshots and diagrams

Table of Contents

See the MkDocs navigation for full content, including:

  • Chroot Basics
  • Linux Filesystem Overview
  • Legal Considerations
  • Cubic Installation and ISO Customization
  • Custom Root Workflow
  • Desktop Icons, Extensions, Plymouth, Wallpapers

Installation

1. Clone the repository

git clone https://github.com/yourusername/cubic_iso_guide.git
cd cubic_iso_guide

2. Install dependencies

pip install -r requirements.txt

Make sure you are using Python 3 and your virtual environment is activated.

3. Serve locally

mkdocs serve

Then open http://127.0.0.1:8000 in your browser to preview the documentation.


Building the Site

To generate the static site:

mkdocs build

The HTML output will be in the site/ directory, ready to deploy.


Contributing

Contributions are welcome! Please fork the repository, create a branch for your changes, and submit a pull request.


License

This project is licensed under the MIT License. See LICENSE for details.


Author

Shadil RayyanLinkedIn | Linkedln | [Github]