Releases: Crystal-Studio-Labs/MenuForge
Release list
🚀 MenuForge v1.2.0 — The "Universal Architecture" Milestone
💎 Release Overview:
This major update transitions MenuForge from an Arch-centric prototype into a professional, hardware-aware management suite for the entire Linux ecosystem. We have re-engineered the core logic from the ground up to prioritize robustness, distribution portability, and surgical performance.
✨ Key Highlights:
- 🛠️ Modular Core Library (menuforge-lib.sh):
Consolidated all system intelligence into a centralized library. This shared module ensures that every component—from the installer to the main TUI—operates on the same high-fidelity hardware and OS detection logic with automatic environment initialization.
- 🐧 Universal Distribution Support:
MenuForge now natively supports and identifies the "Big 4" Linux families:
- Arch Linux / EndeavourOS: Automated Pacman and AUR (Yay/Paru) integration.
- Debian / Ubuntu / Linux Mint: Native APT routing and official repository bootstrapping for the TUI framework.
- Fedora: Intelligent DNF mapping and RPM-specific dependency resolution.
- OpenSUSE: Native Zypper support and YaST-compatible integration.
- 🔍 Surgical Hardware Intelligence:
Implemented deep PCI bus interrogation to identify NVIDIA VGA/3D controllers. MenuForge now dynamically adapts its interface, only offering high-performance offloading hooks (like prime-run) if the hardware is physically present.
- 🎨 Hybrid Theme Engine:
A new multi-tiered theming system that ensures MenuForge feels native to your desktop:
- User Overrides: Custom HEX support via gum.env.conf.
- DE Integration: Native extraction of KDE Plasma Accent Colors via system APIs.
- Distro Branding: High-fidelity fallbacks to official OS colors (Mint Green, Arch Blue, etc.).
- 🏥 Technical CLI Orchestrator:
The menuforge command now behaves like a top-tier Linux utility with a robust argument orchestrator:
- --doctor: Conducts a 4-phase system integrity audit (Environment, Dependencies, Hardware, and Shortcut validity).
- --version: Quick access to system metadata and authorship.
- --help: A comprehensive technical usage and example reference.
- 🛠️ Internal Hardening & UX:
- Restored Guidance: Re-integrated full instructional context for every step of the shortcut creation process.
- Expanded Metadata: Added dozens of new application sub-categories (Simulation, Sports, IDE, etc.) for perfect menu indexing.
- Zero-Log Success: Silenced technical diagnostics during deployment for a clean "✓ SUCCESSFUL" experience.
- Stable TUI: Refactored the main menu into a robust while true loop architecture, replacing recursive calls for better stability.
Developed with ❤️ & ☕️ by SahooShuvranshu & Crystal Studio Labs.
Full Changelog: v1.1.0...v1.2.0-Stable (v1.1.0...v1.2.0)
🚀 MenuForge v1.1.0-Stable: The NVIDIA & Animation Update
🆕 What's New?
- NVIDIA Prime-Run Integration: Added official support for prime-run. Laptop users can now force specific games and applications onto their dedicated NVIDIA GPU with a single toggle in
the performance menu. - Premium Forging Animations: Experience the power of the forge! We've added custom terminal animations using Hammer and Pulse spinners, providing high-end visual feedback during the
link generation process. - Smart Infrastructure Deployment: The built-in Dependency Manager now automatically tracks, verifies, and installs nvidia-prime alongside GameMode, MangoHud, Gamescope, and Wine.
- Interactive UX Refinements:
- Resolved a critical bug where certain phases were automatically skipped.
- Added Explicit Action Prompts (Yes/No) for file and icon selection to prevent accidental input errors.
- Enhanced instruction boxes with real-world examples for every phase of the forge.
🔧 Performance & Safety:
- Ensured 100% isolation: MenuForge only manages its own forged shortcuts, keeping your core system files safe and untouched.
- Full ESC and Back support in all creation menus for robust operation.
📦 Installation:
- git clone https://github.com/Crystal-Studio-Labs/MenuForge.git
- cd MenuForge
- chmod +x install.sh
- ./install.sh
🤝 Credits:
Developed with ❤️ and ☕ by SahooShuvranshu (https://github.com/SahooShuvranshu) & Crystal Studio Labs (https://github.com/Crystal-Studio-Labs).
Full Changelog: v1.0.0...v1.1.0-Stable (v1.0.0...v1.1.0-Stable)
🚀 MenuForge v1.0.0-Stable: The Universal Linux Bridge
🌟 The Initial Stable Release:
We are proud to announce the official launch of MenuForge, the definitive utility for bridging the gap between raw binaries and a polished Linux desktop environment. Built from the
ground up to be completely distro-agnostic, MenuForge provides a safe, guided, and highly optimized TUI workflow for integrating any standalone application, custom script, or high-end
game directly into your system menu (Rofi, Walker, Wofi, etc.).
✨ Key Features:
- Universal Integration: Seamlessly convert any binary, .sh script, or Windows .exe into a standard .desktop system menu entry.
- Professional Management Console: A complete, instruction-led TUI interface to safely Add and Remove shortcuts in an isolated environment (using custom metadata tagging).
- Performance Orchestration: One-click injection of GameMode, MangoHud, and NVIDIA Prime-Run into your application launch commands to maximize hardware efficiency.
- Resolution Control: Integrated Gamescope support allows you to force specific resolutions (Native, 720p, 800x600) for individual apps without altering global monitor settings.
- Theme-Aware TUI: A beautiful, spacious interface built on Gum that automatically synchronizes with your active system theme colors.
- Intelligent Compatibility: Automatic detection and background wrapping for Windows executables using Wine/Proton.
- Modular Dependency Manager: A dedicated diagnostic system that verifies and installs critical performance layers in a clean, separate terminal process.
🔧 Under the Hood:
- Robust instructional flow with clear "Skip" options for advanced users and detailed examples for beginners.
- Non-destructive operations: MenuForge only manages shortcuts it has forged, keeping your core system files safe.
- Professional terminal animations and official branding assets included.
📦 Installation:
- git clone https://github.com/Crystal-Studio-Labs/MenuForge.git
- cd MenuForge
- chmod +x install.sh
- ./install.sh
🤝 Credits:
Developed with ❤️ and ☕ by SahooShuvranshu & Crystal Studio Labs.
Full Changelog: v1.0.0...Initial (https://github.com/Crystal-Studio-Labs/MenuForge/commits/main)