Skip to content

Home

Jump to bottom
Ali Sakkaf edited this page Jul 20, 2026 · 2 revisions

Welcome to the ApkShellext Wiki!

ApkShellext is a modern, high-performance Windows Shell Extension that integrates natively with Windows File Explorer to extract, render, and display the embedded icons of mobile app packages in real-time.

This comprehensive guide covers installation, configurations, renaming variables, and troubleshooting.

📂 Table of Contents

  1. Installation & Setup
  2. Tuning & Configurations
  3. Bulk Renaming Guide
  4. Troubleshooting & FAQ

1. Installation & Setup

Automated Installation (Recommended)

  1. Download the compiled release ZIP package (ApkShellext-v1.x.x.zip).
  2. Extract the ZIP contents to a permanent folder on your drive (e.g., C:\Program Files\ApkShellext).
  3. Right-click install.bat and select Run as Administrator.
  4. Follow the command-line prompts to set your watermark preference.
  5. Restart your computer or run the included restart_explorer.bat to load the extension.

Automated Uninstallation

  1. Right-click uninstall.bat and select Run as Administrator.
  2. This cleanly unregisters the DLL from the COM registry, deletes configurations, and stops background helper services.

Manual Registration

If you prefer to register the extension manually using the Microsoft .NET Register Assembly Utility (regasm.exe), run the following commands in an elevated command prompt:

  • For 64-bit systems (x64): 
    %windir%\Microsoft.NET\Framework64\v4.0.30319\regasm.exe /codebase "C:\Path\To\ApkShellext.dll"
  • For 32-bit systems (x86): 
    %windir%\Microsoft.NET\Framework\v4.0.30319\regasm.exe /codebase "C:\Path\To\ApkShellext.dll"

2. Tuning & Configurations

Configurations and user preferences are stored in the Windows Registry under the path: HKEY_CURRENT_USER\Software\ApkShellext

You can customize these parameters directly using the Registry Editor (regedit.exe) or via the Preferences panel (right-click an app package and select Preferences).

Registry Key Type Default Value Description
ShowAliSakkaFWatermark REG_SZ "False" Enables or disables the developer watermark overlay text on icons.
ShowOverLayIcon REG_SZ "True" Displays small overlay badges representing the app platform (Android, iOS, Windows).
EnableThumbnail REG_SZ "True" Enables rendering of large previews in File Explorer.
SupportAdaptiveIcon REG_SZ "True" Enables rendering of vector-based Android Adaptive Icons.
Language REG_SZ "auto" Overrides the language (e.g. en, ar, zh).
RenamePattern REG_SZ "%AppName%_%Version%" Default naming pattern used in the renaming tool.
ToolTipPattern REG_SZ (Detailed) Default hover tip layout pattern.

3. Bulk Renaming Guide

ApkShellext includes a powerful bulk renaming tool available in the explorer right-click context menu. You can rename files using placeholders that correspond to the application's internal metadata:

Available Pattern Placeholders

  • %AppName%: The display name of the application (e.g. WhatsApp).
  • %Package%: The unique bundle identifier or package name (e.g. com.whatsapp).
  • %Version%: The human-readable version string (e.g. 2.23.1.2).
  • %Revision%: The internal build or revision code.
  • %FileSize%: The size of the package file.
  • %LastModify%: The date when the file was last modified.
  • %OS%: The target operating system (Android, iOS, or Windows).
  • %Publisher%: The developer or publishing entity.
  • Attr(name, default): Resolves custom manifest attributes (e.g. Attr(minSdkVersion, 21)).

Example Pattern:

  • Input Pattern: %AppName%_v%Version%
  • Result: WhatsApp_v2.23.1.2.apk

4. Troubleshooting & FAQ

Q: Icons are not showing or appear blank

  1. Run the debug.bat script as Administrator to register the DLL and restart the shell.
  2. If icons are still cached incorrectly, clear the Windows Thumbnail Cache:
    • Open Disk Cleanup (cleanmgr.exe).
    • Select the OS drive, check Thumbnails, and click OK.
    • Restart your PC.

Q: I get "Access is Denied" when compiling or updating the DLL

Windows Explorer locks COM DLLs in memory. To bypass this lock:

  1. Rename the locked DLL in your directory to ApkShellext.dll.old.
  2. Paste or compile the new ApkShellext.dll into the same folder.
  3. Restart Windows Explorer (or run restart_explorer.bat) to load the new file.
  4. You can then delete the .old file safely.

Clone this wiki locally