Komac Russell Banks

Komac: Smart Manifest Automation for WinGet

A fast, intelligent CLI to create and submit WinGet manifests.

Think: automation, deep installer analysis, and zero YAML wrangling.

⚡ Quick start

# 1. Install komac
winget install komac
  
# 2. Set your GitHub token
komac token add
  
# 3. Update a package
komac update Package.Identifier --version 1.2.3 --urls https://example.com/installer.exe

🎯 Features

• 🔄 Advanced installer analysis
  • Inno Setup
  • Nullsoft Scriptable Install System
  • MSI
  • Burn
• 🌍 Cross-platform support (Windows, Linux, macOS)

Installation

Komac is cross-platform and binaries are built for Windows, Linux, and macOS.

All platforms

If you have cargo installed, you can compile Rust for any platform:

cargo install --locked komac

Komac also supports cargo-binstall:

cargo binstall komac

Nightly

Nightly releases that are built on every commit are
available here. These are useful for debugging or if you
want the latest features and fixes.

Windows

Both portable EXEs and installers are available from the releases.

WinGet

winget install komac

Scoop

scoop install komac

Linux

Portable binaries are available from the releases. Debian (.deb)and Red Hat (.rpm) installers are also available.

macOS

Portable binaries for macOS are available from the releases.

Homebrew

brew install russellbanks/tap/komac

GitHub Token Setup

komac needs a classic GitHub token to submit PRs to winget-pkgs.

This should be a classic token with the public_repo scope.

Adding to komac:

komac token add

Why not fine-grained tokens?

Whilst Komac can fully create manifests and commit with a fine-grained token, it fails to create a pull request to winget-pkgs. This may change as fine-grained tokens improve. See https://github.com/russellbanks/Komac/issues/310.

Commands

Full Command List

komac new

Creates a new package from scratch.

komac new

komac update

Add a version to a pre-existing package:

komac update Package.Identifier --version 1.2.3 --urls https://www.example.com/installer.exe https://www.example.com/installer.msi --submit

komac sync

Updates your fork of winget-pkgs to be up-to-date with microsoft/winget-pkgs.

komac sync

Feature Comparison 🔍

While other manifest creation tools have made a solid foundation for the manifests in winget-pkgs, their development pace is slower and lacks the deeper installer analysis that komac is capable of.

GitHub Actions 🌟

WinGet Releaser is a GitHub Action that invokes Komac, passing in your release's URLs. This completely automates publishing to WinGet.

Example 📝

name: Publish to WinGet
on:
  release:
    types: [ released ]
jobs:
  publish:
    runs-on: windows-latest
    steps:
      - uses: vedantmgoyal9/winget-releaser@main
        with:
          identifier: Package.Identifier
          token: ${{ secrets.WINGET_TOKEN }}
          # installers-regex: '\.exe$' # Only .exe files

Alternative actions 🔄

• Run Komac manually: michidk/run-komac
• Automate releases for external repositories: michidk/winget-updater

How can I support Komac? ❤️

• ⭐ Star this project! :)
• 🤝 Sponsor this project through GitHub Sponsors
• 🧑‍💻 Use Komac and create an issue for feature requests or bugs.

Star History ⭐

<img src="https://api.star-history.com/svg?repos=russellbanks/Komac&amp;type=Date" />

License

Komac is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.