Skip to content

Releases: Crystal-Studio-Labs/MenuForge

🚀 MenuForge v1.2.0 — The "Universal Architecture" Milestone

Choose a tag to compare

@SahooShuvranshu SahooShuvranshu released this 29 May 12:00

💎 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:

  1. 🛠️ 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.

  1. 🐧 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.
  1. 🔍 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.

  1. 🎨 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.).
  1. 🏥 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.
  1. 🛠️ 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

Choose a tag to compare

@SahooShuvranshu SahooShuvranshu released this 26 May 13:58

🆕 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:

  1. git clone https://github.com/Crystal-Studio-Labs/MenuForge.git
  2. cd MenuForge
  3. chmod +x install.sh
  4. ./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

Choose a tag to compare

@SahooShuvranshu SahooShuvranshu released this 26 May 13:39

🌟 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:

  1. git clone https://github.com/Crystal-Studio-Labs/MenuForge.git
  2. cd MenuForge
  3. chmod +x install.sh
  4. ./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)