{"id":17925270,"url":"https://github.com/righettod/powershell-android-utils","last_synced_at":"2025-03-24T03:31:07.684Z","repository":{"id":97552093,"uuid":"231337982","full_name":"righettod/powershell-android-utils","owner":"righettod","description":"PowerShell module providing utility commands to manipulate a APK file on Windows","archived":false,"fork":false,"pushed_at":"2024-10-23T17:28:11.000Z","size":29232,"stargazers_count":11,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-19T02:38:43.646Z","etag":null,"topics":["android","pentesting","powershell","windows"],"latest_commit_sha":null,"homepage":"https://righettod.github.io/powershell-android-utils/","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/righettod.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-01-02T08:21:00.000Z","updated_at":"2025-01-07T12:42:26.000Z","dependencies_parsed_at":"2023-11-14T18:48:40.880Z","dependency_job_id":null,"html_url":"https://github.com/righettod/powershell-android-utils","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/righettod%2Fpowershell-android-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/righettod%2Fpowershell-android-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/righettod%2Fpowershell-android-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/righettod%2Fpowershell-android-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/righettod","download_url":"https://codeload.github.com/righettod/powershell-android-utils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245204482,"owners_count":20577358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","pentesting","powershell","windows"],"created_at":"2024-10-28T20:53:16.872Z","updated_at":"2025-03-24T03:31:02.998Z","avatar_url":"https://github.com/righettod.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"![MadeWitVSCode](https://img.shields.io/static/v1?label=Made%20with\u0026message=VisualStudio%20Code\u0026color=blue\u0026?style=for-the-badge\u0026logo=visualstudio) ![AutomatedWith](https://img.shields.io/static/v1?label=Automated%20with\u0026message=GitHub%20Actions\u0026color=blue\u0026?style=for-the-badge\u0026logo=github) ![GenerateDocumentation](https://github.com/righettod/powershell-android-utils/workflows/GenerateDocumentation/badge.svg?branch=master)\n\n# šŸ¤” Description\n\nšŸ“¦ PowerShell module providing utility commands to manipulate a APK file on Windows.\n\nšŸ’” This module can be combined with the tool [objection](https://github.com/sensepost/objection) in this way:\n\n1. Use the module to alter the original APK in order to prepare it to be passed to **objection** for patching:\n\n* Example of alteration: Change a value in a Flutter or Cordova configuration file, disable a option in the network security configuration file, disable a flag in the Smali code, etc.\n\n2. Patch the APK with [objection](https://github.com/sensepost/objection/wiki/Patching-Android-Applications).\n\n# šŸ“š Online documentation\n\nSee [here](https://righettod.github.io/powershell-android-utils/).\n\n# šŸ“‹ Requirements\n\n\u003e **Note**: You can use the function `Test-Tools` to verify that your installation is OK.\n\nThe module assume that the following tools are available in `%PATH%`:\n\n* [adb](https://developer.android.com/studio/command-line/adb)\n* [apktool](https://ibotpeaches.github.io/Apktool/)\n* [apksigner](https://developer.android.com/studio/command-line/apksigner)\n* [zipalign](https://developer.android.com/studio/command-line/zipalign)\n* [java](https://adoptopenjdk.net) (Runtime or JDK)\n\n# šŸš§ Module installation\n\n## Step 1\n\nOpen a PowerShell window and type this command to install the module into one of the auto-importing location:\n\n```powershell\nPS\u003e $moduleLocation = $env:PSModulePath.Split(\";\")[0] + \"\\Android-Utils\"\nPS\u003e git clone https://github.com/righettod/powershell-android-utils.git $moduleLocation\n```\n\n## Step 2\n\nClose the PowerShell window above, open a new one and type the following command to test that the module is operational:\n\n```powershell\nPS\u003e Show-Android-Functions\n\nCommandType Name Version Source\n----------- ---- ------- ------\nFunction Backup-Data-APK 1.0 Android-Utils\nFunction Compress-APK 1.0 Android-Utils\nFunction Connect-Android-Device 1.0 Android-Utils\nFunction Expand-APK 1.0 Android-Utils\nFunction Find-Framework 1.0 Android-Utils\nFunction Get-APK 1.0 Android-Utils\nFunction Get-APK-Flags 1.0 Android-Utils\nFunction Get-APK-Permissions 1.0 Android-Utils\nFunction Get-Memory-Dump 1.0 Android-Utils\nFunction Get-Packages 1.0 Android-Utils\nFunction Get-Screenrecord 1.0 Android-Utils\nFunction Get-Screenshot 1.0 Android-Utils\nFunction Install-APK 1.0 Android-Utils\nFunction Show-Android-Functions 1.0 Android-Utils\nFunction Show-Device-Screen 1.0 Android-Utils\nFunction Show-Diff-APK 1.0 Android-Utils\nFunction Show-Signature-APK 1.0 Android-Utils\nFunction Test-Tools 1.0 Android-Utils\nFunction Watch-Device-Broadcasts 1.0 Android-Utils\nFunction Watch-Log 1.0 Android-Utils\n\nPS\u003e Test-Tools\nEnsure that the following Android SDK folders are added to the PATH environment variable:\n- [SDK_HOME]\\platform-tools\n- [SDK_HOME]\\build-tools\\[LAST_INSTALLED_VERSION_FOLDER]\n- [SDK_HOME]\\tools\n- [SDK_HOME]\\tools\\bin\nCurrent version of Android tools:\nADB (https://developer.android.com/studio#downloads):\nAndroid Debug Bridge version 1.0.41\nVersion 29.0.5-5949299\nAPKSIGNER (https://developer.android.com/studio#downloads):\n0.8\nAPKTOOL (https://bitbucket.org/iBotPeaches/apktool/downloads):\n2.4.1\nJAVA (https://adoptopenjdk.net):\nopenjdk 12.0.2 2019-07-16\nOpenJDK Runtime Environment AdoptOpenJDK (build 12.0.2+10)\nOpenJDK 64-Bit Server VM AdoptOpenJDK (build 12.0.2+10, mixed mode, sharing)\n```\n\nšŸš€ Module is ready to be used!\n\n# šŸ‘€ Help\n\nUse the following command to get help about a function:\n\n```powershell\n# Get-Help \u003cFunctionName\u003e -full\nPS\u003e Get-Help Watch-Log -full\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frighettod%2Fpowershell-android-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frighettod%2Fpowershell-android-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frighettod%2Fpowershell-android-utils/lists"}