Releases: alisakkaf/ApkShellext
Release list
ApkShellext v1.2.2
ApkShellext v1.2.2 - Universal App Bundle Support (.apks & .apkm), Zero-RAM Engine & ADB Split Installer
Welcome to ApkShellext v1.2.2! This release introduces native icon rendering and full shell integration for .apks (Split App Bundles) and .apkm (APKMirror Bundles), a Zero-RAM Temp File Engine for huge 300MB+ app packages, smart base.apk scoring, and universal One-Click ADB Split Application Installation.
🚀 Key Features & Technical Highlights in v1.2.2
-
⚡ Native Support for
.apks&.apkmApp Bundles:- Full shell handler integration across Icon, Thumbnail, InfoTip, ContextMenu, and ADB installation handlers for
.apks(Android Split APKs) and.apkm(APKMirror Bundles).
- Full shell handler integration across Icon, Thumbnail, InfoTip, ContextMenu, and ADB installation handlers for
-
🚀 Zero-RAM Temp File Streaming Engine:
- Replaced memory-buffered streams with disk-backed temporary streams (
FileOptions.DeleteOnClose). - Large packages (300MB+ like Microsoft Office
.apks) are parsed instantly in fractions of a second without allocating RAM or causingOutOfMemoryExceptioncrashes.
- Replaced memory-buffered streams with disk-backed temporary streams (
-
🎯 Smart Base APK Scoring Algorithm:
- Implemented automated scoring that prioritizes main application binaries (
base.apk,base-master.apk,standalone.apk,main.apk) over configuration splits (split_config.*.apk), guaranteeing 100% accurate icon and metadata extraction.
- Implemented automated scoring that prioritizes main application binaries (
-
📱 Universal One-Click & Double-Click ADB Split Installer:
- Right-click any
.apk,.xapk,.apks, or.apkmpackage to install it directly from the main context menu. - Supports Double-Click Direct Install Mode: double-click any Android package in Windows Explorer to trigger instant installation.
- Automatically filters matching CPU architectures (
arm64-v8a,armeabi-v7a,x86_64) and provides a 3-stage fallback installer.
- Right-click any
-
🛠️ Persistent ZIP Stream Ownership (
IsStreamOwner = false):- Prevents Windows COM stream handles (
SelectedItemStream) from being prematurely disposed during ZIP header inspection.
- Prevents Windows COM stream handles (
-
⚡ Dual Installer & Diagnostic Script Suite:
- Includes both PowerShell-colored scripts and native CMD scripts (
_Lite.bat):install.bat&install_Lite.batuninstall.bat&uninstall_Lite.batdebug.bat&debug_Lite.batrestart_explorer.bat&restart_explorer_Lite.bat
- Includes both PowerShell-colored scripts and native CMD scripts (
📦 Package Contents
ApkShellext.dll- Core COM server shell extension library (v1.2.2).ApkShellextService.exe- Background service with auto-updater engine (Hidden GUI process).install.bat&install_Lite.bat- Administrative installer scripts.uninstall.bat&uninstall_Lite.bat- Clean uninstaller scripts.debug.bat&debug_Lite.bat- Advanced system diagnostic & log generators.restart_explorer.bat&restart_explorer_Lite.bat- Explorer process restarters.ar-SA\,de-DE\,es-ES\,fr-FR\, etc. - Resource folders for 15 localized languages.
ApkShellext v1.2.1
ApkShellext v1.2.1 - High Performance Engine, One-Click ADB Application Installer & Auto-Updater Fixes
Welcome to ApkShellext v1.2.1! This update includes UAC elevation fixes for automated background updates, smart retry scheduling for network connectivity, LRU metadata caching (PackageCache), lazy-loading for Android resources (resources.arsc), and the One-Click ADB Application Installer.
🚀 Key Features & Enhancements in v1.2.1
-
🔒 Reliable UAC Elevated Silent Auto-Updater Engine (
ApkShellextService):- Smooth background installation with native Windows
Verb = "runas"UAC elevation prompt execution forinstall.batanduninstall.bat. - Guaranteed Explorer restart protection via
finallyexecution blocks. - Locked file migration handling (
.old_timestampfallbacks).
- Smooth background installation with native Windows
-
📡 Smart Retry Policy for Update Checks:
- Checks for updates 10 seconds after Windows startup.
- If network is unavailable, retries after 5 minutes, then up to 3 times every 15 minutes, preventing network spamming or battery drain.
-
📱 One-Click ADB Application Installer (
AdbInstallForm):- Right-click any
.apkor.xapkfile and select Install on Device (ADB) / تثبيت على الجهاز (ADB). - Live USB debugging authorization alerts, target device ABI matching (
arm64-v8a), 3-stage fallback execution, and progress tracking.
- Right-click any
-
⚡ High-Performance LRU Metadata & Icon Caching (
PackageCache):- Thread-safe LRU in-memory cache providing ~0ms response time for icon rendering, tooltips, and context menus.
-
🔋
resources.arscLazy Loading & Zero-Copy Stream Decoding:- On-demand resource loading saves 10MB - 50MB+ RAM per file in
explorer.exe. Zero-copy stream decoding prevents 2GB MemoryStream buffer allocations.
- On-demand resource loading saves 10MB - 50MB+ RAM per file in
📦 Package Contents
ApkShellext.dll- Core COM server shell extension library (v1.2.1).ApkShellextService.exe- Background service with auto-updater engine.libwebp_x64.dll&libwebp_x86.dll- Native WebP image decoders.Google.Protobuf.dll- Protobuf parsing library.install.bat- Administrative installer script.uninstall.bat- Clean uninstaller script with legacy key cleanup.debug.bat- Advanced system diagnostic & log generator.restart_explorer.bat- Explorer process restarter.ar-SA\,de-DE\,es-ES\,fr-FR\, etc. - Resource folders for 15 localized languages.
🔧 Installation & Setup
- Download
ApkShellext-v1.2.1.zip. - Extract the archive to
%SystemDrive%\ApkShellext_ByAliSakkaf(e.g.,C:\ApkShellext_ByAliSakkaf). - Right-click
install.batand select Run as Administrator. - Restart Explorer or run
restart_explorer.batto enjoy lightning-fast icon previews!
ApkShellext v1.2.0
ApkShellext v1.2.0 - High Performance Engine, One-Click ADB Application Installer & Diagnostic Toolkit
Welcome to ApkShellext v1.2.0! This major update brings a high-performance LRU caching engine (PackageCache), lazy-loading for Android resources (resources.arsc), a brand-new One-Click ADB Application Installer, full cross-platform .NET Framework fallback checks, and detailed diagnostic tools.
🚀 Key Features & Enhancements in v1.2.0
-
⚡ High-Performance LRU Metadata & Icon Caching (
PackageCache):- Built-in thread-safe LRU cache storing up to 100 package metadata items in RAM based on
(FilePath + LastWriteTime + FileSize). - Hovering over APKs, opening right-click context menus, and displaying tooltips now return in ~0ms without re-unzipping files or hitting the disk.
- Built-in thread-safe LRU cache storing up to 100 package metadata items in RAM based on
-
🔋
resources.arscLazy Loading (10MB - 50MB+ RAM Savings per File):resources.arscis no longer loaded into RAM upon reader initialization.- On-demand resource loading ensures that applications with direct strings or unmapped icons consume minimal RAM in
explorer.exe.
-
🖼️ Zero-Copy Stream Decoding in
ApkThumbnailHandler:- Eliminated full-file
MemoryStreambuffer allocations (which previously loaded entire 1GB - 2GB.xapk/.apkfiles into RAM). - Thumbnails now stream directly using seeking streams.
- Eliminated full-file
-
📱 One-Click ADB Application Installer (
AdbInstallForm):- Right-click any
.apkor.xapkfile and select Install on Device (ADB) / تثبيت على الجهاز (ADB). - Smart Device Status Detection: Live detection for connected devices, USB debugging authorization (RSA prompts), and offline states.
- Automatic Split-APK Architecture Filtering: Automatically queries target device ABIs (
arm64-v8a,armeabi-v7a,x86_64) and filters out mismatched architecture splits to preventINSTALL_FAILED_NO_MATCHING_ABIS. - 3-Stage Fallback Engine: Guarantees 100% install success on modern 64-bit phones (Galaxy S24, Pixel 7/8/9, Android 14/15) and emulators.
- Interactive Abort: Click Cancel anytime to safely terminate the ADB process (
taskkill /F /IM adb.exe).
- Right-click any
-
🛠️ Diagnostic Toolkit & Clean Legacy Cleanup (
debug.bat):- New
debug.batscript providing full system diagnostics, 32-bit & 64-bitregasmtesting, CLSID verification, cache clearing, and log file generation (ApkShellext_Debug_Log.txt). - Full cleanup of legacy registry keys for
ApkShellext2andApkShellext.
- New
-
🎨 Multi-Version Colored Batch Scripts:
install.bat,uninstall.bat, anddebug.batwork on all Windows versions (7/8/10/11) with native PowerShell color output.- Graceful .NET Framework 4.8 fallback checks with clear download instructions if .NET 4.x is missing.
📦 Package Contents
ApkShellext.dll- Core COM server shell extension library (v1.2.0).ApkShellextService.exe- Background service with auto-updater engine.libwebp_x64.dll&libwebp_x86.dll- Native WebP image decoders.Google.Protobuf.dll- Protobuf parsing library.install.bat- Colored administrative installer script.uninstall.bat- Clean uninstaller script with legacy key cleanup.debug.bat- Advanced system diagnostic & log generator.restart_explorer.bat- Explorer process restarter.ar-SA\,de-DE\,es-ES\,fr-FR\, etc. - Resource folders for 15 localized languages.
🔧 Installation & Setup
- Download
ApkShellext-v1.2.0.zip. - Extract the archive to
%SystemDrive%\ApkShellext_ByAliSakkaf(e.g.,C:\ApkShellext_ByAliSakkaf). - Right-click
install.batand select Run as Administrator. - Restart Explorer or run
restart_explorer.batto enjoy lightning-fast icon previews and ADB installation!
ApkShellext v1.1.0
ApkShellext v1.1.0 - Native XAPK Support, Memory Leak Fixes & Smart Auto-Updater
Welcome to the ApkShellext v1.1.0 major release! This version introduces native .xapk package support, eliminates Windows Explorer file locking issues, features a background auto-update engine in ApkShellextService, and streamlines the installer workflow.
🚀 Key Features & Enhancements in v1.1.0
-
Native
.xapkPackage Support:- Full shell integration for
.xapkfiles including icon rendering, context menus, tooltips, and thumbnail generation. - Built-in
XapkReaderengine that dynamically extracts thebase.apkpackage from.xapkZIP containers in memory without extracting temporary files to disk.
- Full shell integration for
-
100% File Lock & Memory Leak Resolution:
- Resolved Windows Explorer file lock errors (
File in use by explorer.exe) when renaming or deleting.apk/.xapkfiles or parent folders. - Constructor exception safety: Added
try-catchcleanup logic acrossApkReaderandAppPackageReaderso corrupted files release file handles instantly. ReleaseZipStreamcustom stream wrapper: Manages inner streams andZipFilecontainers, ensuring 100% resource disposal on garbage collection or class disposal.- Set
FileShare.ReadWritemode for smooth Windows file operations.
- Resolved Windows Explorer file lock errors (
-
Smart Background Auto-Updater Service (
ApkShellextService):- Automatically checks GitHub releases on Windows startup and periodically every 12 hours.
- Dynamically detects the system drive (
%SystemDrive%, e.g.,C:\ApkShellext_ByAliSakkaforD:\ApkShellext_ByAliSakkaf). - Downloads release assets silently, displays a user update notification, uninstalls older versions, updates files, and restarts
explorer.exesmoothly.
-
GitHub Version Tag Formatting:
- Updated settings redirection logic to output clean 3-part version tags (e.g.
v1.1.0) preventing GitHub 404 redirection errors.
- Updated settings redirection logic to output clean 3-part version tags (e.g.
-
Streamlined Installer (
install.bat):- Preserved automatic SmartScreen unblocking via PowerShell
Unblock-File.
- Preserved automatic SmartScreen unblocking via PowerShell
📦 Package Contents
ApkShellext.dll- Core COM server shell extension library.ApkShellextService.exe- Background service with auto-updater engine.libwebp_x64.dll&libwebp_x86.dll- Native WebP image decoders.Google.Protobuf.dll- Protobuf parsing library.install.bat- One-click administrative installer script.uninstall.bat- Clean uninstaller script.restart_explorer.bat- Explorer process restarter.ar-SA\,de-DE\,es-ES\,fr-FR\, etc. - Resource folders for 15 localized languages.
🔧 Installation & Setup
- Download
ApkShellext-v1.1.0.zip. - Extract the archive to
%SystemDrive%\ApkShellext_ByAliSakkaf(or any folder of your choice). - Right-click
install.batand select Run as Administrator. - Restart Explorer or your system to enjoy seamless icon previews!
ApkShellext v1.0.1
ApkShellext v1.0.1 - Bug Fixes & Security Update
Welcome to the ApkShellext v1.0.1 release, focusing on execution stability, resolving Windows SmartScreen warnings, and mapping support paths inside the Preferences form.
🛠️ Improvements & Bug Fixes in v1.0.1
- SmartScreen & Untrusted Script Fixes: Added self-unblocking PowerShell commands at the start of all installer and uninstaller batch scripts (
install.bat,uninstall.bat,debug.bat). When run, the scripts automatically strip NTFS download Zone.Identifier metadata from themselves and adjacent DLLs/EXEs, preventing Windows from displaying security warnings or blocking execution. - Clean Package Compression: Automated build cleanup switches to exclude compiler PDB files and temporary archives from user releases.
📦 Package Contents
ApkShellext.dll- Core COM server library.ApkShellextService.exe- Background extraction service.libwebp_x64.dll&libwebp_x86.dll- WebP decoders.Google.Protobuf.dll- Protobuf utility library.install.bat- Standard installation tool.uninstall.bat- Standard uninstallation tool.restart_explorer.bat- Quick Explorer restarter.ar-SA\,de-DE\,es-ES\,fr-FR\, etc. - Resource folders for 15 localized languages.
🔧 Installation Guide
- Download and extract
ApkShellext-v1.0.1.zipto a permanent directory on your machine. - Right-click
install.batand select Run as Administrator. - Choose whether to enable watermark overlays (
YorN). - Restart your machine or run
restart_explorer.batto activate the extension.
ApkShellext v1.0.0
ApkShellext v1.0.0 - Modern Rebuild
Welcome to the initial release of ApkShellext v1.0.0, a thoroughly modernized, refactored, and rebranded fork of the Windows Shell Extension for application packages.
This release targets modern operating systems, upgrades core framework packages, resolves long-standing build and execution locks, and implements advanced dynamic rendering features.
🚀 Key Features
- Supported Formats: Fully supports native icon extraction, info-tips, and context-menus for Android (
.apk), iOS (.ipa), and Windows App Packages (.appx&.appxbundle). - High-Performance Parsers: Native binary decoders for iOS binary Plist (
bplist), iOS optimized PNG (PNGDecrush), Android Binary XML, and Android Resource Tables (.arsc).
🛠️ Improvements & Bug Fixes in v1.0.0
- Target Framework Upgrade: Upgraded targeting from old .NET versions to .NET Framework 4.8, providing superior memory management and execution stability on modern Windows kernels.
- Windows 11 & ARM64 Support: Certified compatibility across Windows 7, 8, 10, and Windows 11 on all major hardware architectures (x86, x64, and ARM64).
- Dynamic Watermark Scaling: Implemented a real-time font-size feedback loop to dynamically scale and center overlay overlays based on explorer grid size.
- 8-Directional Text Shadow Outline: Added high-contrast black border tracing around overlay text to ensure 100% legibility on any light, dark, or transparent background.
- Non-Disruptive Build Flow: Implemented build lock-bypassing using file renaming, allowing code modification and compilation without locking issues.
- Background Service Compilation Fix: Patched the PreBuildEvent error failure, allowing clean developer compilations out-of-the-box.
- Modern CLI Utilities: Replaced old install/uninstall batch scripts with clean, structured CLI installers.
📦 Package Contents
ApkShellext.dll- Core COM server library.ApkShellextService.exe- Background extraction service.libwebp_x64.dll&libwebp_x86.dll- WebP decoders.Google.Protobuf.dll- Protobuf utility library.install.bat- Standard installation tool.uninstall.bat- Standard uninstallation tool.restart_explorer.bat- Quick Explorer restarter.ar-SA\,de-DE\,es-ES\,fr-FR\, etc. - Resource folders for 15 localized languages.
🔧 Installation Guide
- Download and extract
ApkShellext-v1.0.0.zipto a permanent directory on your machine. - Right-click
install.batand select Run as Administrator. - Choose whether to enable watermark overlays (
YorN). - Restart your machine or run
restart_explorer.batto activate the extension.