Skip to content

[DOCUMENTATION] Add installation and prerequisite guides for supported package managers #5516

Closed

Description

@Gizmo-Ger

Problem

UniGetUI lists supported package managers and may report missing dependencies, but there is no easily discoverable, centralized setup guide for each package manager, including required components, installation commands, verification steps, and common troubleshooting cases.

This creates a poor onboarding experience: users have to research and install dependencies individually even after UniGetUI identifies what is missing.

Concrete example: Cargo on Windows

While setting up Cargo support in UniGetUI on Windows:

  1. Installing Rust/Cargo did not provide the additional cargo-update executable required for UniGetUI's update integration.
  2. Attempting cargo install cargo-binstall --locked failed because the MSVC target needs Microsoft's link.exe, which was not installed.
  3. After installing a prebuilt cargo-binstall, running cargo binstall cargo-update -y installed the two required binaries successfully (cargo-install-update.exe and cargo-install-update-config.exe).
  4. Network/VPN-related DNS timeouts were a separate obstacle; retrying without VPN succeeded.

A short guide could have explained these prerequisites and offered a precompiled-binary path without requiring the Visual C++ Build Tools merely to set up package management.

Suggested improvement

  • Provide a central Package manager setup / prerequisites page, linked prominently from the website and documentation.
  • For each supported package manager, document installation on Windows, required runtimes/CLI extensions, any optional or mandatory dependencies, PATH requirements, and commands to verify the installation.
  • Indicate which components UniGetUI can install/configure automatically and which the user must install separately.
  • In UniGetUI's missing dependency warnings, link directly to the relevant guide, ideally including a safe copyable install command.
  • Include short troubleshooting notes for common scenarios such as missing MSVC build tools, PATH detection after installation, and VPN/proxy/DNS failures.

Expected outcome

When UniGetUI reports a missing package manager component such as cargo-update, users should be able to click through to an official, package-manager-specific setup guide rather than search GitHub issues or third-party instructions.

Activity

  1. GabrielDuf commented on Nov 2, 2026

    @GabrielDuf
    Contributor

    Hi Sven (@Gizmo-Ger),
    The Cargo part is already fixed: since v2026.3.3 (#5569), UniGetUI searches, installs and updates crates on its own, so cargo-update and cargo-binstall are no longer needed.

    For the broader request, #5669 adds a setup guide (docs/PACKAGE_MANAGERS.md) that covers each supported package manager:

    • what to install, with a ready-to-run command where there is one
    • how UniGetUI finds the manager on each OS, and what it installs on its own
    • a command to check that it works

    in the next release, When a manager is missing or can't start, its settings page will now links straight to its section of the guide. If the manager isn't installed, the page also offers its install command with an Open in a terminal button.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementAn improvement to WingetUI

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions