wingetCollections
  • Auto
  • Search
  • Awesome Collections
  • Awesome Programs
  • My Favorite Collections
  • My Collections
  • Account / Settings
  • Terms of Service
  • Privacy
  • About

Ā© 2026 winget.ragerworks.com

Loading...
Install Wenget using Winget - wingetCollections
  1. Go back
  2. Packages
  3. Wenget
Wenget logo

Wenget WenAnLin

Use this command to install Wenget:
winget install --id=WenAnLin.Wenget -e

Wenget is a cross-platform portable binary package manager designed to simplify the installation and management of command-line tools and applications distributed through GitHub Releases. It automatically detects your platform, downloads appropriate binaries, and organizes them in an efficient directory structure.

Key Features:

  • Cross-platform support for Windows, macOS, Linux (including ARM64).
  • Organized storage with packages stored in a structured directory.
  • Auto-update functionality to always install the latest versions.
  • Bucket system enabling users to organize and manage packages via manifests.
  • Support for scripts written in PowerShell, Bash, Batch, and Python.

Ideal for developers, DevOps engineers, and CLI tool enthusiasts seeking efficient installation, updates, and organization of command-line tools. Wenget streamlines the process of managing software across multiple platforms without manual file handling or configuration.

README

Wenget - Wen Package Manager

Version License Platform

A cross-platform package manager for GitHub binaries, written in Rust.

Wenget simplifies the installation and management of command-line tools and applications distributed through GitHub Releases. It automatically detects your platform, downloads the appropriate binaries, and manages them in an organized directory structure.

Features

  • šŸš€ One-line Installation: Remote installation scripts for quick setup
  • šŸ”„ Auto-update: Always installs the latest version from GitHub Releases
  • šŸ“¦ Bucket System: Organize packages and scripts using bucket manifests
  • šŸ“œ Script Support: Install and manage PowerShell, Bash, and Python scripts from buckets
  • šŸŒ Cross-platform: Windows, macOS, Linux (multiple architectures)
  • šŸ“ Organized Storage: All packages in ~/.wenget/ with proper structure
  • šŸ” Smart Search: Search packages and scripts across all configured buckets
  • āš” Fast Downloads: Multi-threaded downloads with caching
  • šŸŽÆ Platform Detection: Automatically selects the correct binary for your system
  • šŸ”§ Smart Command Naming: Automatically removes platform suffixes from executable names

Quick Install

Method 1: Winget (Windows, Recommended)

winget install wenget

After installation, run initialization:

wenget init

Method 2: Installation Script

Windows (PowerShell)

irm https://raw.githubusercontent.com/superyngo/Wenget/main/install.ps1 | iex

Linux/macOS (Bash)

curl -fsSL https://raw.githubusercontent.com/superyngo/Wenget/main/install.sh | bash

System-Level Installation

The install scripts automatically detect elevated privileges and switch to system-level paths:

Versions
2.2.3
1.0.0
0.3.2
0.2.2
Website
github.com
License
Last updated
1/30/2026
Download latest version
ModePlatformApp DirectoryBin Directory
UserLinux/macOS~/.wenget/apps~/.local/bin
UserWindows%USERPROFILE%\.wenget\apps%USERPROFILE%\.local\bin
Root/AdminLinux/macOS/opt/wenget/app/usr/local/bin (symlinks)
Root/AdminWindows%ProgramW6432%\wenget\app%ProgramW6432%\wenget\bin

When to use Administrator/Root:

  • When you want packages available to all users on the system
  • When installing to system directories like /usr/local/bin or %ProgramW6432%

Linux/macOS (as root):

sudo curl -fsSL https://raw.githubusercontent.com/superyngo/Wenget/main/install.sh | sudo bash

Windows (as Administrator):

# Run PowerShell as Administrator, then:
irm https://raw.githubusercontent.com/superyngo/Wenget/main/install.ps1 | iex

> āš ļø Important Notice for Existing Users (v0.2.x ā†’ v0.3.0) > > Version 0.3.0 changes the default bin directory for user-level installations: > - Unix: ~/.wenget/bin/ ā†’ ~/.local/bin/ > - Windows: %USERPROFILE%\.wenget\bin\ ā†’ %USERPROFILE%\.local\bin\ > > Migration Required: > 1. Uninstall existing version: wenget del self --yes (or use install.sh uninstall / install.ps1 -Uninstall) > 2. Remove old PATH entry for ~/.wenget/bin from your shell config > 3. Reinstall with the script above > 4. Reinstall your packages > > System-level installations (root/Administrator) are not affected by this change.

Method 3: Manual Installation

Download the latest release from GitHub Releases and place it in your PATH, or build from source:

git clone https://github.com/superyngo/Wenget.git
cd Wenget
cargo build --release

The binary will be at target/release/wenget (or wenget.exe on Windows).

Quick Start

# Initialize Wenget (done automatically with install scripts)
wenget init

# Add the official Wenget bucket (if not added during init)
wenget bucket add wenget https://raw.githubusercontent.com/superyngo/wenget-bucket/main/manifest.json

# Search for packages
wenget search ripgrep

# Install a package
wenget add ripgrep

# List installed packages
wenget list

# Update installed packages
wenget update

# Upgrade Wenget itself
wenget update self

# Delete a package
wenget delete ripgrep

Commands

Package Management

  • wenget add ... - Install packages (from bucket or GitHub URL)
  • wenget info - Show package information
  • wenget delete ... - Uninstall packages
    • wenget del self - Uninstall Wenget itself
  • wenget list - List installed packages (with source and description)
    • wenget list --all - Show all available packages from buckets
  • wenget search - Search available packages
  • wenget update [name] - Update installed packages
    • wenget update self - Upgrade Wenget itself to the latest version

Bucket Management

  • wenget bucket add - Add a bucket
  • wenget bucket del - Remove a bucket
  • wenget bucket list - List all buckets
  • wenget bucket refresh - Rebuild package cache
  • wenget bucket create - Generate a bucket manifest from source files

Bucket Manifest Generator

The bucket create command generates bucket manifests from GitHub repositories and scripts:

# Generate manifest from source files
wenget bucket create -r sources_repos.txt -s sources_scripts.txt -o manifest.json

# Use with GitHub token for higher API rate limit (5000/hour vs 60/hour)
wenget bucket create -r repos.txt -o manifest.json -t YOUR_TOKEN

# Or use GITHUB_TOKEN environment variable
export GITHUB_TOKEN=your_token
wenget bucket create -r repos.txt -o manifest.json

# Update modes (when manifest.json already exists)
wenget bucket create -r repos.txt -o manifest.json -u overwrite     # Replace entire file
wenget bucket create -r repos.txt -o manifest.json -u incremental   # Merge with existing

# Add direct URLs
wenget bucket create -d https://github.com/user/repo,https://gist.github.com/user/id

Options:

  • -r, --repos-src - Source file(s) with GitHub repo URLs (one per line)
  • -s, --scripts-src - Source file(s) with Gist/script URLs (one per line)
  • -d, --direct - Direct URLs (comma-separated)
  • -o, --output - Output file (default: manifest.json)
  • -t, --token - GitHub personal access token
  • -u, --update-mode - How to handle existing file: overwrite or incremental

System

  • wenget init - Initialize Wenget directories and configuration
  • wenget config - Edit user preferences (config.toml) with default editor
  • wenget rename [new] - Rename an installed command
  • wenget repair - Repair corrupted configuration files
  • wenget --version - Show version information
  • wenget --help - Show help message

Global Options

  • --yes, -y - Skip confirmation prompts
  • --verbose, -v - Enable verbose logging

Directory Structure

User-Level Installation (default)

~/.wenget/
ā”œā”€ā”€ apps/                  # Installed applications
ā”‚   ā”œā”€ā”€ wenget/            # Wenget itself
ā”‚   ā””ā”€ā”€ /        # Each installed package
ā”œā”€ā”€ bin/                   # Symlinks/shims (added to PATH)
ā”‚   ā”œā”€ā”€ wenget.cmd         # Wenget shim (Windows)
ā”‚   ā”œā”€ā”€ wenget             # Wenget symlink (Unix)
ā”‚   ā””ā”€ā”€ .cmd     # Package shims
ā”œā”€ā”€ cache/                 # Download and package cache
ā”‚   ā”œā”€ā”€ manifest-cache.json  # Cached package list
ā”‚   ā””ā”€ā”€ downloads/        # Downloaded archives
ā”œā”€ā”€ config.toml           # User preferences (platform, paths, etc.)
ā”œā”€ā”€ buckets.json          # Bucket configuration
ā””ā”€ā”€ installed.json        # Installed packages info (with descriptions)

System-Level Installation (root/Administrator)

Linux/macOS:

/opt/wenget/
ā”œā”€ā”€ app/                   # Installed applications
ā”‚   ā”œā”€ā”€ wenget/
ā”‚   ā””ā”€ā”€ /
ā”œā”€ā”€ cache/
ā”œā”€ā”€ buckets.json
ā””ā”€ā”€ installed.json

/usr/local/bin/            # Symlinks to binaries
ā”œā”€ā”€ wenget -> /opt/wenget/app/wenget/wenget
ā””ā”€ā”€  -> ...

Windows:

%ProgramW6432%\wenget\
ā”œā”€ā”€ app\                   # Installed applications
ā”‚   ā”œā”€ā”€ wenget\
ā”‚   ā””ā”€ā”€ \
ā”œā”€ā”€ bin\                   # Binaries (added to system PATH)
ā”‚   ā”œā”€ā”€ wenget.exe
ā”‚   ā””ā”€ā”€ .exe
ā”œā”€ā”€ cache\
ā”œā”€ā”€ buckets.json
ā””ā”€ā”€ installed.json

Configuration

Wenget supports user preferences via ~/.wenget/config.toml. Edit with:

wenget config

Available Settings

Preferred Platform - Override automatic platform detection:

preferred_platform = "x86_64-unknown-linux-musl"

Common platform identifiers:

  • Linux x86_64 (glibc): x86_64-unknown-linux-gnu
  • Linux x86_64 (musl): x86_64-unknown-linux-musl
  • Linux ARM64: aarch64-unknown-linux-gnu
  • macOS Intel: x86_64-apple-darwin
  • macOS Apple Silicon: aarch64-apple-darwin
  • Windows x86_64: x86_64-pc-windows-msvc
  • Windows ARM64: aarch64-pc-windows-msvc

Custom Bin Directory - Override default bin location:

custom_bin_path = "/usr/local/bin"

Useful for custom PATH setups or when ~/.local/bin cannot be added to PATH.

Bucket System

Buckets are collections of package and script manifests hosted online. The official Wenget bucket provides curated open-source tools.

Official Bucket

wenget bucket add wenget https://raw.githubusercontent.com/superyngo/wenget-bucket/main/manifest.json

Creating Your Own Bucket

You can create custom buckets to distribute your own package and script collections. See the official Wenget bucket repository for a complete example.

Bucket Structure

Create a manifest.json with the following structure:

{
  "packages": [
    {
      "name": "my-tool",
      "repo": "https://github.com/username/repo",
      "description": "Tool description",
      "homepage": "https://example.com",
      "license": "MIT",
      "platforms": {
        "windows-x86_64": {
          "url": "https://github.com/username/repo/releases/download/v1.0.0/tool-windows-x64.zip",
          "size": 1234567
        },
        "linux-x86_64": {
          "url": "https://github.com/username/repo/releases/download/v1.0.0/tool-linux-x64.tar.gz",
          "size": 1234567
        }
      }
    }
  ],
  "scripts": [
    {
      "name": "my-script",
      "description": "Useful script",
      "url": "https://raw.githubusercontent.com/username/repo/main/script.ps1",
      "script_type": "powershell",
      "repo": "https://github.com/username/repo",
      "homepage": "https://example.com",
      "license": "MIT"
    }
  ]
}

Required Fields

For Packages:

  • name: Package name (used in commands)
  • repo: GitHub repository URL
  • description: Brief package description
  • platforms: Platform-specific binary information
    • url: Download URL for the binary
    • size: File size in bytes

For Scripts:

  • name: Script name (used in commands)
  • description: Brief script description
  • url: Direct URL to the script file
  • script_type: Script type (powershell, bash, batch, or python)
  • repo: Repository URL (for reference)

Optional Fields

  • homepage: Project homepage URL
  • license: Package/script license
  • checksum: SHA256 checksum for verification

Hosting Your Bucket

GitHub (Recommended):

# Create a new repository
# Add manifest.json to the repository
# Use raw.githubusercontent.com URL
wenget bucket add my-bucket https://raw.githubusercontent.com/username/my-bucket/main/manifest.json

Other Hosting:

  • Any web server that serves JSON with HTTPS
  • GitHub Gists
  • CDN services

Example: Official Wenget Bucket

The official bucket is maintained at: https://github.com/superyngo/wenget-bucket

It includes curated packages with:

  • Verified working binaries across platforms
  • Updated package metadata
  • Categorized by tool type
  • Regular updates and maintenance

You can use it as a template for creating your own bucket:

# Clone the official bucket as a template
git clone https://github.com/superyngo/wenget-bucket my-bucket
cd my-bucket
# Edit manifest.json with your packages
# Commit and push to your repository

Testing Your Bucket

# Add your bucket locally
wenget bucket add test-bucket https://example.com/manifest.json

# Verify packages are listed
wenget search 

# Test installation
wenget add

Platform Support

Wenget supports the following platforms:

PlatformArchitectureStatus
Windowsx86_64 (64-bit)āœ… Supported
Windowsi686 (32-bit)āœ… Supported
Linuxx86_64āœ… Supported
Linuxi686āœ… Supported
Linuxaarch64 (ARM64)āœ… Supported
Linuxarmv7āœ… Supported
macOSx86_64 (Intel)āœ… Supported
macOSaarch64 (Apple Silicon)āœ… Supported

How It Works

  1. Platform Detection: Wenget automatically detects your OS and architecture
  2. Package Resolution: Searches buckets for the requested package
  3. Binary Selection: Identifies the appropriate binary from GitHub Releases
  4. Download: Downloads and caches the binary
  5. Installation: Extracts and places the binary in ~/.wenget/apps//
  6. Shim Creation: Creates a shim/symlink in ~/.local/bin/ for easy access

GitHub API Rate Limits

Wenget uses the GitHub API to fetch package information and download binaries. Be aware of GitHub's API rate limits:

Rate Limit Overview

AuthenticationRate LimitImpact
Unauthenticated60 requests/hourLimited package searches and updates
Authenticated5,000 requests/hourSufficient for normal usage

Impact on Wenget Operations

Operations that consume API calls:

  • wenget add - 2 calls per URL (when installing from GitHub URL)
  • wenget info - 1 call per URL (when querying GitHub URL)
  • wenget update - 1 call per installed package to check for updates

Operations that don't consume API calls:

  • wenget add - Uses cached bucket data (no API calls)
  • wenget info - Uses cached bucket data for bucket packages
  • wenget list - Local only
  • wenget delete - Local only
  • wenget bucket list/add/remove - Local only
  • wenget search - Uses cached bucket data

Recommendations

  1. Use Buckets: The bucket system caches package information, reducing API calls significantly
  2. Run wenget update periodically rather than before each search
  3. For heavy usage: Consider authenticating with GitHub (future feature)
  4. Rate limit exceeded? Wait an hour or use buckets for cached package data

The official Wenget bucket is updated regularly, so most users won't need to worry about rate limits when using bucket-based package management.

Examples

Install Popular Tools

# Modern alternatives to classic Unix tools
wenget add ripgrep fd bat

# Git TUI
wenget add gitui lazygit

# System monitoring
wenget add bottom

# Shell prompt
wenget add starship

# Directory navigation
wenget add zoxide

Manage Packages

# Search for a tool
wenget search rust

# Update metadata and install
wenget update
wenget add tokei

# List what's installed
wenget list

# Remove a package
wenget delete tokei

Important Disclaimer

āš ļø NO WARRANTIES OR GUARANTEES

Wenget is a package manager that facilitates downloading and installing applications from GitHub Releases. Wenget DOES NOT:

  • āŒ Verify the authenticity or safety of packages
  • āŒ Maintain or update the applications themselves
  • āŒ Provide usage information or support for installed applications
  • āŒ Guarantee the security, stability, or functionality of any package
  • āŒ Take responsibility for any damage caused by installed applications

Users are responsible for:

  • āœ… Verifying the trustworthiness of package sources
  • āœ… Understanding what each package does before installing
  • āœ… Reviewing the source repositories and releases
  • āœ… Accepting all risks associated with installing third-party software

By using Wenget, you acknowledge that you install packages at your own risk.

Wenget acts only as a convenience tool for downloading and organizing binaries. The responsibility for verifying, securing, and using applications rests entirely with the user.

Uninstallation

Using Wenget

wenget del self

This will:

  1. Remove Wenget from PATH
  2. Delete all Wenget directories and installed packages
  3. Remove the Wenget executable itself

Manual Uninstallation

Windows:

# Remove from PATH, then delete:
Remove-Item -Recurse -Force "$env:USERPROFILE\.wenget"

Linux/macOS:

# Remove from PATH, then delete:
rm -rf ~/.wenget

Development

Building from Source

git clone https://github.com/superyngo/Wenget.git
cd Wenget
cargo build --release

Running Tests

cargo test

Project Structure

wenget/
ā”œā”€ā”€ src/
ā”‚   ā”œā”€ā”€ bucket.rs         # Bucket management
ā”‚   ā”œā”€ā”€ cache.rs          # Package cache
ā”‚   ā”œā”€ā”€ cli.rs            # CLI interface
ā”‚   ā”œā”€ā”€ commands/         # Command implementations
ā”‚   ā”œā”€ā”€ core/             # Core functionality
ā”‚   ā”œā”€ā”€ downloader/       # Download logic
ā”‚   ā”œā”€ā”€ installer/        # Installation logic
ā”‚   ā”œā”€ā”€ providers/        # GitHub API integration
ā”‚   ā””ā”€ā”€ utils/            # Utilities (HTTP client, prompts)
ā”œā”€ā”€ install.ps1           # Windows installer
ā””ā”€ā”€ install.sh            # Unix installer

Troubleshooting

PATH Not Updated

After installation, you may need to restart your terminal or run:

Windows:

refreshenv

Linux/macOS:

source ~/.bashrc  # or ~/.zshrc, ~/.profile

Package Not Found

# Update package metadata
wenget update

# Check available buckets
wenget bucket list

# Rebuild cache
wenget bucket refresh

Permission Errors (Linux/macOS)

# Ensure ~/.local/bin is in PATH and has correct permissions
chmod +x ~/.local/bin/*

Contributing

Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

MIT License - Copyright (c) 2025 wen

See LICENSE for details.

Credits

Inspired by:

  • Scoop - Windows package manager
  • Homebrew - macOS package manager
  • Obtainium - Android app manager

Links

  • GitHub: https://github.com/superyngo/Wenget
  • Releases: https://github.com/superyngo/Wenget/releases
  • Issues: https://github.com/superyngo/Wenget/issues
  • Official Bucket: https://github.com/superyngo/wenget-bucket

Changelog

See CHANGELOG.md for detailed release notes and version history.