# routinemiku/apkstart

> ApkStart is a Windows program that installs Android apps from .apk files and runs each one in its own window, so they can be used like Windows software. It extracts each app's icon from the APK, creates desktop and Start menu shortcuts, and starts the Android runtime when an app opens. The code is written mainly in JavaScript and runs on Electron.

Source: https://github.com/routinemiku/apkstart
Indexed: commit 7854070 on 2026-11-18 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: App
- Language: JavaScript
- Stars: 9,153 at index time
- License: MIT
- Code health: 4.2/10, Needs_work
- Last commit: 2026-11-17
- Contributors: 3

## Install

From the README: https://github.com/routinemiku/apkstart

Clone the apkstart repository.
    git clone https://github.com/routinemiku/apkstart.git

Move into the apkstart folder.
    cd apkstart

Install the dependencies from the source folder.
    npm install

Start ApkStart, which completes the one-time runtime setup.
    npm start

Register .apk files so that double-clicking them installs the app.
    npm run assoc:on

Build the portable package, which can be distributed without an installer.
    npm run pack

## How it works

The main process in src/main.js sets up the app, registers the inter-process messages that the windows send, and opens a window when a user launches an Android app. The UI entry point is src/ui/app.js. The core work happens in src/core, where the Runtime class owns the emulator, the provisioner and the ADB client, and the UI and scripts reach the emulator through it. src/core/emulator.js runs the Android emulator on Windows, and src/core/apk.js reads APK files before they are installed. The check-*.js scripts in tools exercise launch, quit and update behavior, and each one loads the core services it tests from src/core.

- src/main.js: entry point
- src/ui/app.js: entry point
- tools/embed-probe/index.js: entry point
- .github/release-notes-v0.3.3.md: central file
- .github/release-notes-v0.3.4.md: central file
Modules: src, test, tools, scripts, docs. 137 files, 21,379 lines, 1,165 symbols.

## Code health

- Score: 4.2/10 (Needs_work)
- Trend: 4.3 on 2026-11-16, 4.2 on 2026-11-18
- Rank: #246 of 4,000+ indexed repos
- Hotspots: src/main.js, src/ui/app.js, src/core/engine.js, src/core/emulator.js, src/core/provision.js
- Lowest file: src/core/engine.js
- Dead code: 4 findings

## Maintenance

- Last commit 2026-11-17, first commit 2026-10-29, 129 commits
- 3 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/routinemiku/apkstart/security

## More

- Page: https://repowise.dev/repo/routinemiku/apkstart
- Ask this codebase: https://repowise.dev/repo/routinemiku/apkstart/chat
- Docs: https://repowise.dev/repo/routinemiku/apkstart/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/routinemiku/apkstart
