One-Click Install & Auto-Update for GitHub Binaries: My Experience with the 16k‑Star Komi Store

Simple Introduction

Komi Store is an open‑source application store that indexes binary assets (APK, EXE, DMG, AppImage, DEB, RPM) published in the Release sections of repositories on GitHub, Codeberg, Forgejo and other Git services. It sorts entries by version, star count and update time, presenting them like a conventional app store.

The project has earned 16.3k stars on GitHub and runs a single codebase that supports Android, Windows, macOS and Linux.

Key Features

Discoverable Listings

Each listed item shows version, star, fork and issue counts, as well as the time since the last update, allowing users to assess relevance at a glance. The home page is divided into Trending, Hot Release, and Most Popular, with additional thematic categories such as Privacy, Media, Productivity, Networking and Dev Tools.

The backend weights results based on the user's platform, prioritising APKs for Android users and EXE/DMG for desktop users.

Search and Filtering

The search bar supports filtering by platform, programming language and sort order. Besides the default star‑based ranking, users can sort by Recently Updated (repository activity) or Recently Released (latest stable version). These sorts are performed by the backend index and do not consume GitHub’s search quota.

When a GitHub repository URL is copied to the clipboard, Komi Store prompts to open the link directly, eliminating manual pasting.

Viewed repositories are recorded in a "Recently Viewed" list, and users can hide already‑seen items via a setting.

Installation and Update

On a project's detail page, all available releases are listed. The latest release is shown by default, but users can expand to view historical versions. Each release lists its assets with platform tags and file sizes.

Installation options on Android include:

System default installer (stable, with confirmation dialog)

Shizuku/Sui silent install (requires Shizuku service running)

Dhizuku silent install for OEM‑restricted devices (no root required)

Root install via libsu (supports Magisk, KernelSU, APatch)

Background auto‑update intervals can be set to 3, 6, 12 or 24 hours. When an update is detected, a notification is shown; combined with Shizuku or Dhizuku, the download can be installed silently. Users may disable background checks to save battery.

Pre‑Installation Inspection

Version 1.8.1 introduced an APK Inspect feature that parses the APK locally (no server upload) and displays package name, version, signature fingerprint, minimum and target SDK, supported architectures, debuggable flag, and a colour‑coded permission list (dangerous in red, signature in blue, normal in gray). Users can also inspect already‑installed apps by long‑pressing an entry and selecting "Inspect".

Multi‑Source Support

Originally limited to GitHub, Komi Store now supports Codeberg, Forgejo and self‑hosted instances. Custom forges can be added under Tweaks → Network → Custom forges, enabling search of private repositories.

Desktop clients for Windows, macOS and Linux provide native packages; macOS can also be installed via Homebrew. The desktop UI offers a two‑column layout, remembers window size and position, and supports Compact, Wide and Extra‑Wide content widths. Native dark title bars on Windows 11 and macOS follow the system theme.

Login Capabilities

Browsing, searching, installing and favouriting are available without login. After logging in with a GitHub account, users can star repositories, import their starred list, comment on Issues, view Pull Requests and Security pages.

Login methods include Web OAuth, Device Code (eight‑digit code) and Personal Access Token (useful on poor networks). Credentials are stored locally encrypted with AES‑256‑GCM; Android devices use the hardware Keystore.

Mirror Downloads

Because GitHub download speeds can be unreliable in some regions, Komi Store includes a built‑in mirror list that is hot‑updated by the backend. When a download is slow, a prompt offers to switch to a mirror. Each download is verified with a SHA‑256 checksum that must match the asset digest from GitHub. Users can also configure their own gh‑proxy instances.

Quick Start

Android : Download the latest APK from the GitHub Releases page or install via IzzyOnDroid on F‑Droid.

Windows : Download the .msi installer or the portable .zip and run Komi-Store.exe.

macOS : Install with Homebrew using brew install --cask komi-store.

Linux : Choose the appropriate package format ( .deb, .rpm, AppImage or .tar.gz) for your distribution.

Final Thoughts

The author has replaced manual GitHub Release downloads with Komi Store, noting that while the tool does not revolutionise software distribution, it streamlines a previously cumbersome workflow.

Limitations include reliance on binary assets being present in Releases; source‑only repositories are ignored. The backend index is open‑source (Apache 2.0) and self‑hostable, which may be required for privacy‑sensitive users.

With over 130 k downloads, the store has demonstrated market demand and is worth trying for users who frequently sideload GitHub‑hosted apps.

https://github.com/kurikomi-labs/komi-store