komac

Crates.io	komac
lib.rs	komac
version	2.6.0
source	src
created_at	2024-02-23 19:33:44.878944
updated_at	2024-08-31 12:25:19.037171
description	A manifest creator for winget-pkgs
homepage
repository	https://github.com/russellbanks/Komac
max_upload_size
id	1150937
size	1,764,910

Russell Banks (russellbanks)

documentation

https://github.com/russellbanks/Komac/blob/main/README.md

README

Komac - Another WinGet Manifest Creator

GitHub release (release name instead of tag name) GitHub Repo stars Issues License

Komac is an advanced CLI designed to create manifests for the WinGet Community Repository.

Komac is both blazingly fast 🔥 and incredibly low on memory, using just ~3.5MB of memory on my machine.

Komac-demo

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

Komac is currently only able to use a classic token. 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.

Classic

A classic token with the public_repo scope.

firefox_IYiqtsd0Nl

Commands

Command	Description	Usage
New	Create a package from scratch	`new`
Update	Update a pre-existing package in winget-pkgs	`update`
Remove	Remove a version from winget-pkgs	`remove`
Sync Fork	Syncs your fork of winget-pkgs to microsoft/winget-pkgs	`sync-fork`, `sync`
Branch Cleanup	Deletes branches that have had a merged or closed pull request to winget-pkgs	`cleanup`
List Versions	Lists all the versions for a given package	`list-versions`, `list`
Analyse	Analyses a file and outputs information about it. Useful for debugging	`analyse`
Token update	Update stored GitHub OAuth token	`token update`
Token remove	Delete stored GitHub OAuth token	`token remove`
Complete	Outputs an autocompletion script for the given shell	`complete`, `autocomplete`

Update an existing package with a new version

komac update Package.Identifier --version 1.2.3 --urls https://www.firstUrl.com https://www.secondUrl.com --submit

Parameter	Usage	Notes
Package Identifier	`komac update Package.Identifier`
Version	`--version`
URLs	`--urls`	URLs are delimited by a space
Automatically submit	`--submit`
Token (if one is not already stored)	`--token`	Komac will check for a `GITHUB_TOKEN` environment variable

Komac vs other tools 🏆

While other manifest creation tools have made a solid foundation for the manifests in winget-pkgs, they development pace is notably slow and lacks the advanced detection capabilities that come with Komac.

	Komac	WingetCreate	YamlCreate
Parameters	✅	✅	❌
Download progress bar & ETA	✅	❌	❌
Fully cross-platform	✅	❌	Limited
Works without Git	✅	✅	❌
Full Inno Setup value retrieval	✅	❌	❌
Full MSI value retrieval	✅	Partial	Partial
Linux & macOS MSI support	✅	❌	❌
Full MSIX value retrieval	✅	Partial	Partial - https://github.com/Trenly/winget-pkgs/issues/180
Get information from GitHub	✅	✅	❌
Formatted GitHub release notes retrieval	✅	❌	❌
Release date identification	✅	❌	❌
No telemetry	✅	⭕ ¹	✅
Fully standalone (w/o winget-pkgs clone)	✅	✅	❌
Inno setup detection	✅ ²	✅	✅ ³
Nullsoft detection	✅ ²	✅	✅ ³
Burn installer detection	✅ ²	✅	Opt-in feature (not enabled by default due to slow processing)
Programming Language	Rust	C#	PowerShell

Usage with GitHub Actions: WinGet Releaser 🌟

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? ❤️

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

Star History ⭐

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.

Telemetry is enabled by default in WingetCreate. Use wingetcreate settings to manually disable telemetry. ↩
There is much more accurate detection for Inno, Nullsoft, and Burn installers since Komac v2. ↩ ↩² ↩³
The logic for this was contributed by me :) Check issues that I've opened to request this feature for YamlCreate. ↩ ↩²

Commit count: 1045