{"id":50745614,"url":"https://github.com/roshhellwett/projectgrub","last_synced_at":"2026-06-10T20:30:48.245Z","repository":{"id":323105877,"uuid":"1092145655","full_name":"roshhellwett/projectgrub","owner":"roshhellwett","description":"ᴛʜɪꜱ ɪꜱ ʟɪɴᴜx ɢʀᴜʙ ᴛʜᴇᴍᴇ ","archived":false,"fork":false,"pushed_at":"2026-04-20T04:56:45.000Z","size":9581,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-20T06:35:45.537Z","etag":null,"topics":["projectgrub","zenithopensourceprojects"],"latest_commit_sha":null,"homepage":"https://zenithopensourceprojects.vercel.app","language":"Python","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/roshhellwett.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-08T04:34:54.000Z","updated_at":"2026-04-20T05:07:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/roshhellwett/projectgrub","commit_stats":null,"previous_names":["roshhellwett/grub","roshhellwett/projectgrub"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/roshhellwett/projectgrub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectgrub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectgrub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectgrub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectgrub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roshhellwett","download_url":"https://codeload.github.com/roshhellwett/projectgrub/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectgrub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34170162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["projectgrub","zenithopensourceprojects"],"created_at":"2026-06-10T20:30:46.919Z","updated_at":"2026-06-10T20:30:48.238Z","avatar_url":"https://github.com/roshhellwett.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![img](https://img.shields.io/badge/Platform-Linux-2ea44f?style=for-the-badge\u0026logo=linux\u0026logoColor=white) \n![img](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)\n![img](https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=white)\n![img](https://img.shields.io/badge/Status-Stable-success?style=for-the-badge)\n\n# PROJECT GRUB\n\nInteractive CLI tool that helps you browse, install, and manage GRUB boot themes on Linux. Instead of manually copying files and editing configurations, just run the menu and pick your theme.\n\n---\n\n## 🚀 Quick Start\n\n### Step 1: Install Python\nIf you don't have Python, download it here: https://www.python.org/downloads/\n\n### Step 2: Install ProjectGRUB\n```bash\npip install projectgrub\n```\n\n### Step 3: Run the Interactive Menu\n```bash\npython -m projectgrub start\n```\n\n### Step 4: Update (Optional)\n```bash\nprojectgrub update\n```\n\nThat's it! The tool will guide you through everything.\n\n---\n\n## 📋 Installation Options\n\n### Option 1: Install via pip (Recommended)\n```bash\npip install projectgrub\nprojectgrub\n```\n\n### Option 2: Run from local clone\n```bash\ngit clone https://github.com/zenithopensourceprojects/projectgrub.git\ncd projectgrub\npip install -e .\nprojectgrub\n```\n\n### Option 3: Run without installing\n```bash\ngit clone https://github.com/zenithopensourceprojects/projectgrub.git\ncd projectgrub\npip install -e .\npython -m projectgrub start\n```\n\n---\n\n## 💻 CLI Commands\n\n```bash\nprojectgrub start         # Launch interactive menu\nprojectgrub list          # List all available themes\nprojectgrub info \u003cname\u003e   # Show theme details\nprojectgrub update        # Update to latest version\n```\n\n---\n\n## 🎯 Menu Options\n\n| Option | Description |\n|--------|-------------|\n| **1. Browse Themes** | View all available GRUB themes with previews |\n| **2. Quick Install** | Install a theme with recommended settings |\n| **3. Advanced Install** | Choose resolution (1080p/2K/4K) and custom options |\n| **4. Preview Theme** | View detailed theme information |\n| **5. Uninstall Theme** | Remove current GRUB theme |\n| **6. System Diagnostics** | Check GRUB health and compatibility |\n| **7. Theme Validation** | Validate a theme before install |\n| **8. Contribute Guide** | Learn how to add new themes |\n| **9. Refresh Themes** | Reload themes from disk |\n| **10. Help** | Documentation and tips |\n| **U. Check Updates** | Check for new versions |\n| **0. Exit** | Exit the application |\n\n---\n\n## 🛡️ Safety Features\n\n### Pre-flight Checks\nBefore any operation, ProjectGRUB validates:\n- ✅ Running on Linux\n- ✅ Root privileges available\n- ✅ GRUB installed\n- ✅ GRUB directory accessible\n- ✅ Write permissions available\n- ✅ Sufficient disk space\n\n### Rollback on Failure\nIf installation fails:\n1. GRUB config is restored from backup\n2. Partially copied files are removed\n3. User receives clear error message with suggestions\n\n---\n\n## 🎨 Available Themes\n\nThe tool automatically discovers themes from the `themes/` folder. Current themes include:\n\n| Theme | Author | Description |\n|-------|--------|-------------|\n| Vimix | Vimix | Clean, modern flat-design |\n| Xenlism | Xenlism | Minimal and elegant |\n| Tela | Tela | Minimalist aesthetics |\n| Dark Matter | VandalByte | Dark and sleek |\n| DedSec | VandalByte | Cyberpunk hacker style |\n\n---\n\n### \"GRUB not found\"\nMake sure GRUB is installed and /boot is mounted.\n\n### \"Theme not working after install\"\n1. Reboot your system\n2. Check /etc/default/grub for GRUB_THEME line\n3. Run `sudo grub-mkconfig` manually\n\n---\n\n## 🙏 Credits\n\n- GRUB Theme: [Vimix](https://github.com/vinceliuice/vimix-grub-themes)\n- Dark Matter \u0026 DedSec: [VandalByte](https://gitlab.com/VandalByte)\n- Xenlism: [Xenlism](https://github.com/xenlism)\n- Tela: [Tela](https://github.com/vinceliuice/Tela-grub-theme)\n\n---\n\n© 2026 [Zenith Open Source Projects](https://zenithopensourceprojects.vercel.app/). All Rights Reserved. Zenith is an Open Source Project Idea by @roshhellwett\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froshhellwett%2Fprojectgrub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froshhellwett%2Fprojectgrub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froshhellwett%2Fprojectgrub/lists"}