👈 Click arrows to expand/collapse details on this page

Windows Batch Script Wrapper (apkeditor.bat)

This tool uses ARSCLib to edit any apk resources and has six main features. (Tool documentation remains the same as provided in the prompt - Decompile, Build, Merge, Refactor, Protect, Info sections)

To make using APKEditor.jar more convenient on Windows, you can use the following batch script wrapper. It allows you to call the tool using a simple apkeditor command from anywhere in your terminal, provided you set it up correctly.

Features:

• Easy Access: Run APKEditor.jar using the apkeditor command.
• PATH Integration: Add the script's location to your system PATH for global access.
• Argument Forwarding: Passes all arguments directly to APKEditor.jar.
• Colorized Output: Uses ANSI escape codes for clearer console feedback (requires a compatible terminal like Windows Terminal, PowerShell 7+, Git Bash).
• Built-in Help: Shows basic usage or forwards to APKEditor.jar -h when no command or a help flag is provided.

Steps to Set Up:

1. Download APKEditor.jar: Get the latest release from the Releases Page and place APKEditor.jar in a dedicated folder (e.g., C:\APKEditor\).
2. Save the Script: Copy the code below and save it as apkeditor.bat in the same folder as APKEditor.jar (e.g., C:\APKEditor\apkeditor.bat).
3. Add Folder to System PATH:
   • Search for "Environment Variables" in the Windows Start Menu and open "Edit the system environment variables".
   • Click the "Environment Variables..." button.
   • Under "System variables" (or "User variables" for just your user), find the Path variable, select it, and click "Edit...".
   • Click "New" and add the full path to the folder where you saved the script and JAR (e.g., C:\APKEditor).
   • Click "OK" on all open windows.
   • Important: You may need to close and reopen any open Command Prompt or PowerShell windows for the PATH change to take effect.

Batch Script Code (apkeditor.bat):

@echo off
setlocal EnableDelayedExpansion

::  colors
set "red=�[91m"
set "green=�[92m"
set "yellow=�[93m"
set "cyan=�[96m"
set "reset=�[0m"

set "JAR_PATH=%~dp0APKEditor.jar"
if not exist "%JAR_PATH%" (
    echo %red%[ERROR] APKEditor.jar not found in %~dp0%reset%
    exit /b 1
)

if "%~1"=="" (
    echo %yellow%APKEditor%reset% 
	
    echo %cyan%Usage:%reset% apkeditor [command] [options]
    echo %cyan%Commands:%reset% use %green% apkeditor -h %reset%- to see the available commands
    echo %cyan%Example:%reset% apkeditor d -i app.apk
    exit /b 0
)

echo %yellow%[INFO] Running command: java -jar APKEditor.jar %* %reset%
java -jar "%JAR_PATH%" %*

exit /b %ERRORLEVEL%

Usage Examples (using the wrapper):

Now you can open Command Prompt, PowerShell, or Windows Terminal and use the tool like this:

• Get Help:

  apkeditor -h

• Decompile an APK:

  apkeditor d -i myapp.apk -o myapp_json

• Build APK from decompiled files:

  apkeditor b -i myapp_json -o myapp_rebuilt.apk

• Merge multiple APK files:

  apkeditor m -i apks-folder -o merged_app.apk

• Refactor obfuscated resources:

  apkeditor x -i myapp.apk -o myapp_refactored.apk

• Protect APK resources:

  apkeditor p -i myapp.apk -o myapp_protected.apk

• Get detailed APK information:

  apkeditor info -v -resources -i myapp.apk

Notes:

• Color Support: ANSI color codes work best in modern terminals like Windows Terminal, PowerShell 7+, or Git Bash. They might appear as garbled text in older cmd.exe windows on older Windows versions.
• Java Requirement: Ensure you have a compatible Java Runtime Environment (JRE) installed and available in your system's PATH for the java command to work.

APKEditor

Powerful android apk resources editor

This tool uses ARSCLib to edit any apk resources and has six main features

java -jar APKEditor.jar -h

$ java -jar APKEditor.jar -h
APKEditor - x.x.x
Using: ARSCLib-x.x.x
https://github.com/REAndroid/APKEditor
Android binary resource files editor
Usage: 
 java -jar APKEditor.jar <command> <args>
 commands: 
  1)  d | decode     -   Decodes android resources binary to readable json
  2)  b | build      -   Builds android binary from json
  3)  m | merge      -   Merges split apk files from directory or XAPK, APKM, APKS ...
  4)  x | refactor   -   Refactors obfuscated resource names
  5)  p | protect    -   Protects/Obfuscates apk resource
  6)  info           -   Prints information of apk
 run with <command> -h to get detailed help about each command
 

1- Decompile

• Decompiles resources of apk to human readable json string.
• Decompiles resources of apk to XML source code (for un-obfuscated apk only). Use -t xml

java -jar APKEditor.jar d -i path/to/your-file.apk

$ java -jar APKEditor.jar d -i test.apk -o test_json
00.000 I: [DECOMPILE] Decompiling ...
 Input: test.apk
Output: test_json
 ---------------------------- 
00.036 I: [DECOMPILE] Loading ...
00.129 I: [DECOMPILE] Decompiling to json ...
30.093 I: [DECOMPILE] Done

2- Build

Builds back to apk from decompiled json/XML files

java -jar APKEditor.jar b -i path/to/decompiled-directory

$ java -jar APKEditor.jar b -i test_json -o test_edited.apk

00.000 I: [BUILD] Building ...
 Input: test_json/base
Output: test_edited.apk
 ---------------------------- 
00.048 I: [BUILD] Scanning directory ...
00.247 I: [BUILD] Writing apk...
22.032 [BUILD] Writing: method=STORED total=284921526 bytes : resources.arsc  
25.009 I: [BUILD] Zip align ...
27.101 I: [BUILD] Saved to: test_edited.apk
30.217 I: [BUILD] Done

3- Merge

Merges multiple splitted apk files (directory, xapk, apkm, apks ...) to standalone apk

java -jar APKEditor.jar m -i path/to/input

$ java -jar APKEditor.jar m -i apk_files
00.049 I: [MERGE] Merging ...
  Input: apk_files
Output: apk_files_merged.apk
---------------------------- 
00.050 I: [MERGE] Searching apk files ...
00.060 I: [MERGE] Found apk files: 3           
00.192 I: [MERGE] Found modules: 3
00.302 I: [MERGE] Merging: base
00.307 I: [MERGE] Added [base] classes.dex -> classes.dex
00.308 I: [MERGE] Merging resource table: base
01.302 I: [MERGE] Merging: config.xxhdpi-1
01.304 I: [MERGE] Merging resource table: config.xxhdpi-1
01.386 [MERGE] tum_ic_visibility_white_24.png
01.386 I: [MERGE] Merging: config.arm64_v8a-1
01.390 [MERGE] : lib/arm64-v8a/libnativeai.so

01.475 I: [MERGE] Sanitizing manifest ...
01.478 I: [MERGE] Removed: extractNativeLibs
01.480 I: [MERGE] Removed: isSplitRequired

01.480 I: [MERGE] Writing apk...
03.686 [MERGE] Writing: total=47693672 bytes : resources.arsc
03.729 I: [MERGE] Zip align ... 
04.611 I: [MERGE] Saved to: apk_files_merged.apk
04.700 I: [MERGE] Done

4- Refactor

Refactors obfuscated resource entry names

java -jar APKEditor.jar x -i path/to/input.apk

$ java -jar APKEditor.jar x -i input.apk
00.000 I: [REFACTOR] Refactoring ...
  Input: input.apk
Output: input_refactored.apk
---------------------------- 
00.017 I: [REFACTOR] Loading apk: input.apk
00.952 I: [REFACTOR] Renamed entries: 5888
00.954 I: [REFACTOR] Writing apk ...
03.268 [REFACTOR] Writing: total=47589184 bytes : resources.arsc              
03.350 I: [REFACTOR] Zip align ...
03.504 I: [REFACTOR] Saved to: input_refactored.apk
03.504 I: [REFACTOR] Done

5- Protect

Protects apk resources against almost all known decompile/modify tools.

java -jar APKEditor.jar p -i path/to/input.apk

00.026 I: [PROTECT] Protecting ...
  Input: test.apk
Output: test_protected.apk
---------------------------- 
00.027 I: [PROTECT] Loading apk file ...
00.052 I: [PROTECT] Protecting files ..
00.454 I: [PROTECT] Protecting resource table ..
00.474 I: [PROTECT] Writing apk ...
02.264 [PROTECT] Writing: total=47654392 bytes : resources.arsc              
02.346 I: [PROTECT] Zip align ...
02.451 I: [PROTECT] Saved to: test_protected.apk
02.451 I: [PROTECT] Done

6- Info (⭐NEW⭐)

Prints/dumps from basic up to detailed information of apk.

java -jar APKEditor.jar info -v -resources -i input.apk

Package name=com.mypackage id=0x7f
 type string id=1 entryCount=1
   resource 0x7f010000 string/app_name
     () My Application
     (-de) Meine Bewerbung
     (-ru-rRU) Мое заявление
 type mipmap id=2 entryCount=1
   resource 0x7f020000 mipmap/ic_launcher_round
     () res/mipmap/ic_launcher_round.png
 type drawable id=3 entryCount=1
   resource 0x7f030000 drawable/ic_launcher
     () #006400

---

Build executable jar

./gradlew fatJar

# NB: Due to my lazyness , the dependency ARSCLib.jar is pre-built and placed under APKEditor/libs/ARSCLib.jar or you can build yourself and replace it.
git clone https://github.com/REAndroid/APKEditor
cd APKEditor
./gradlew fatJar
# Executable jar will be placed ./build/libs/APKEditor-x.x.x.jar

Downloads

• Latest release with pre-built executable jar

Contribute

• Everyone is so welcome in this project, if you have some code improvements please make a pull request
• Please share your ideas / thoughts in discussions
• Please create issue you faced while using this tool along with your apk

Contact

• Telegram: @kikfox
• Email: thekikfox@gmail.com