chore: Merge branch dev to main

README.md

@@ -5,7 +5,7 @@
 </p>
 
 <h1 align="center">
-    Morphe patches focused on Twitter/X <br>
+    Morphe patches focused on Twitter/X & Instagram<br>
     <a href="https://t.me/pikopatches">
         <img src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white"/>
     </a>
@@ -29,8 +29,8 @@ Use the deep link to add Piko as a patch source in Morphe Manager:
 
 [➕ Add Piko to Morphe](https://morphe.software/add-source?github=crimera/piko)
 
-Then patch Twitter/X:
-1. Tap X app icon in Morphe
+Then patch Twitter/X or Instagram:
+1. Tap X or Instagram app icon in Morphe
 2. Download original APKM file from ApkMirror. Do _not_ unspilt or modify the file, Morphe patches APKM directly
 3. Wait for patching to complete, install
 
@@ -47,7 +47,7 @@ java -jar cli.jar patch --patches piko.mpp input.apkm
 ## ⚙️ Patch Details
 
 <details>
-<summary>Show patches</summary>
+<summary>Show Twitter/X patches</summary>
 
 <table>
 <thead>
@@ -68,7 +68,7 @@ java -jar cli.jar patch --patches piko.mpp input.apkm
 <tr><td><code>Custom emoji font</code></td><td>Customise emoji font style</td></tr>
 <tr><td><code>Custom font</code></td><td>Customise font style</td></tr>
 <tr><td><code>Custom sharing domain</code></td><td>Allows using domains like fxtwitter when sharing tweets/posts.</td></tr>
-<tr><td><code>Custom translator</code></td><td>A custom translator with multiple providers.</td></tr>
+<tr><td><code>Native translator</code></td><td>A native translator with multiple providers.</td></tr>
 <tr><td><code>Customise post font size</code></td><td></td></tr>
 <tr><td><code>Customize Inline action Bar items</code></td><td></td></tr>
 <tr><td><code>Customize Navigation Bar items</code></td><td></td></tr>
@@ -107,7 +107,7 @@ java -jar cli.jar patch --patches piko.mpp input.apkm
 <tr><td><code>Hide nudge button</code></td><td>Hides follow/subscribe/follow back buttons on posts</td></tr>
 <tr><td><code>Hide post metrics</code></td><td>Hides like, reposts etc counts.</td></tr>
 <tr><td><code>Hide promote button</code></td><td>Hides promote button under self posts</td></tr>
-<tr><td><code>Hide timeline posts by category</code></td><td>Hides different post categories like who to follow, news etc from timeline.</td></tr>
+<tr><td><code>Hide recommendation items</code></td><td>Adds options to hide recommendation items such as "Who to follow" and "Today's news" in timeline, search, and replies.</td></tr>
 <tr><td><code>Hook feature flag</code></td><td>Toggle feature flags to enable development features.</td></tr>
 <tr><td><code>Legacy share links</code></td><td>Brings back username on post share links. Works post 11.4x.xx</td></tr>
 <tr><td><code>Log server response</code></td><td>Log json responses received from server</td></tr>
@@ -126,6 +126,48 @@ java -jar cli.jar patch --patches piko.mpp input.apkm
 <tr><td><code>Show poll results</code></td><td>Adds an option to show poll results without voting</td></tr>
 <tr><td><code>Show post source label</code></td><td>Source label will be shown only on public posts</td></tr>
 <tr><td><code>Show sensitive media</code></td><td>Disables the sensitive media banner</td></tr>
+<tr><td><code>Import/Export login token</code></td><td>Adds an feature to export and import the token of accounts. This is useful when logging in on your second device or when re-installing piko.</td></tr>
+</tbody>
+</table>
+
+</details>
+<br>
+<details>
+<summary>Show Instagram patches</summary>
+<table>
+<thead>
+<tr>
+<th>Patch Name</th>
+<th>Patch Description</th>
+</tr>
+</thead>
+<tbody>
+<tr><td><code>Disable ads</code></td><td></td></tr>
+<tr><td><code>Hide suggested content</code></td><td>Hides suggested stories, reels, threads (Suggested posts will still be shown).</td></tr>
+<tr><td><code>Disable comments</code></td><td></td></tr>
+<tr><td><code>Disable explore</code></td><td></td></tr>
+<tr><td><code>Disable stories</code></td><td></td></tr>
+<tr><td><code>Hide stories tray</code></td><td>Hides stories tray from main feed.</td></tr>
+<tr><td><code>Disable analytics</code></td><td>Block analytics that are sent to Instagram/Facebook servers.</td></tr>
+<tr><td><code>Disable discover people</code></td><td>Disables discover people section on user profile</td></tr>
+<tr><td><code>View live anonymously</code></td><td></td></tr>
+<tr><td><code>View stories anonymously</code></td><td></td></tr>
+<tr><td><code>Sanitize share links</code></td><td></td></tr>
+<tr><td><code>Open links externally</code></td><td>Changes links to always open in your external browser, instead of the in-app browser.</td></tr>
+<tr><td><code>Remove build expired popup</code></td><td>Removes the popup that appears after a while, when the app version ages.</td></tr>
+<tr><td><code>Unlock developer options</code></td><td></td></tr>
+<tr><td><code>Download media</code></td><td>Adds ability to download posts, reels, stories and highlights</td></tr>
+<tr><td><code>Add settings</code></td><td>Adds settings to control preferences are patching</td></tr>
+<tr><td><code>Customise story timestamp</code></td><td>Customise the timestamp that shows when the story was posted</td></tr>
+<tr><td><code>Disable story flipping</code></td><td>Disable automatic flipping/moving to next story</td></tr>
+<tr><td><code>View story mentions</code></td><td>Add option to view visible and hidden story mentions.</td></tr>
+<tr><td><code>Make ephemeral media permanent</code></td><td>Changes view once, view twice media to permanent view. Do note older ephemeral media might look blank.</td></tr>
+<tr><td><code>Follow back indicator</code></td><td>Adds a label on the profile page, indicating whether a user is follows you back.</td></tr>
+<tr><td><code>Hide group creation button on sharesheet</code></td><td></td></tr>
+<tr><td><code>Improve image viewing</code></td><td>Fetches max resolution images from server.</td></tr>
+<tr><td><code>Hide reshare button</code></td><td>Hides the reshare button from both posts and reels.</td></tr>
+<tr><td><code>Hide navigation buttons</code></td><td>Hides navigation bar buttons, such as the Reels and Create button.</td></tr>
+<tr><td><code>Hide navigation buttons</code></td><td>Hides navigation bar buttons, such as the Reels and Create button.</td></tr>
 </tbody>
 </table>
 

docs/about_login_token_patch.md

@@ -0,0 +1,104 @@
+# About "Import/Export login token" patch
+
+## About this feature
+
+It exports the session token for the currently logged-in account.
+
+This is useful in the following cases:
+
+- If you already have a device logged in and want to log in on another device
+- If you want to reinstall Piko
+- If you want to log into a cloned APK
+- If you have another rooted device and can log in normally
+
+Tokens and other necessary data will be exported in JSON format.  
+You can use it from the login screen.
+
+To import additional accounts, select "Create a new account" instead of "Add an existing account".
+
+**Important: This patch does NOT fix the login attestation problem.**
+
+## WARNING
+
+Exported tokens are highly confidential information. Never share it with anyone!  
+If a third party obtains this token, they can freely access your account until you log out of the session.
+
+Please also be careful of your clipboard or exported files.
+
+## How it works
+
+X for Android stores the session token and some cached information into the Android system's AccountManager.  
+This information continues to work even if you clear the app data.  
+(This is also why X still be logged in even after clearing the app data.)
+
+Therefore, you can restore this information and log in after re-installation.
+
+## A note when removing account from the app
+
+Please be careful if you want to remove an account from one device after importing the token into another device.
+
+Logging out from settings will log out of the session associated with that token.  
+Therefore, if you simply press the logout button in the settings, you will also be logged out of other devices using the same token.
+
+There are two ways to remove an account from the app without logging out.
+
+- Press the Logout button in airplane mode. (no internet connections)
+- If the app has only one account currently logged in, just uninstall and reinstall the app.
+
+## Troubleshooting
+
+**Q: After importing a token, a notification "You were logged out of @username due to an error." appears immediately.**
+
+A: The session has already been logged out. That token cannot be used.
+
+**Q: After importing a token, it's not logged in even after restarting the app, but there is no notification.**
+
+A: Allow notifications for the X app and try again.
+
+## Appendix
+
+### The format of piko's token file
+
+```json
+{
+  "username": "",
+  "token": "",
+  "secret": "",
+  "userdata": {
+    "account_user_id": "",
+    "account_state": "",
+    "account_field_version": "",
+    "account_user_type": "",
+    "account_settings": "",
+    "account_teams_contributor": "",
+    "account_teams_contributees": "",
+    "account_user_info": "",
+    "account_can_access_x_payments": "",
+    "account_is_x_payments_enrolled": "",
+    "com.twitter.android.oauth.token.teamsContributeeUserId": ""
+  }
+}
+```
+
+- "token" is the value of an auth token `com.twitter.android.oauth.token` from AccountManager
+- "secret" is the value of an auth token `com.twitter.android.oauth.token.secret` from AccountManager
+- "userdata" is an array of the user data stored in AccountManager in key-value format
+
+Not all keys in "userdata" necessarily exist.  
+However, some keys are required. If any required keys are missing when importing an account, the X app will remove that account immediately after it is imported.
+
+### Get token from rooted device without piko
+
+If you are using official X instead of piko on a rooted device (e.g., using an Xposed module) and want to export tokens to use with piko, you can extract your tokens and user data without piko using the following method.
+
+1. Use any file manager app that supports root access
+2. Get `/data/system_ce/0/accounts_ce.db`
+3. Open it with any SQLite database browser/editor app
+4. Open `accounts` table
+5. Remember the number of `_id` of the account you want to export
+6. Open `authtokens` table
+7. Find records where `accounts_id` field is the number you have remembered above
+8. Copy the values of `com.twitter.android.oauth.token` and `com.twitter.android.oauth.token.secret` into the corresponding properties in the JSON format shown above
+9. Open `extras` table
+10. Find records where `accounts_id` field is the number you have remembered above
+11. Copy all the keys and values into the `userdata` property of the JSON format above. Note that `account_user_info` is a JSON text in itself, so you must escape all double quotes.

extensions/instagram/build.gradle.kts

@@ -0,0 +1,12 @@
+android {
+    defaultConfig {
+        minSdk = 26
+    }
+}
+
+dependencies {
+    compileOnly(project(":extensions:shared:library"))
+    compileOnly(project(":extensions:instagram:stub"))
+    compileOnly(libs.annotation)
+    compileOnly(libs.appcompat)
+}

extensions/instagram/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest/>

extensions/instagram/src/main/java/app/morphe/extension/instagram/constants/Arrays.java

@@ -0,0 +1,17 @@
+/*
+    * Copyright (C) 2026 piko <https://github.com/crimera/piko>
+    *
+    * This file is part of piko.
+    *
+    * Any modifications, derivatives, or substantial rewrites of this file
+    * must retain this copyright notice and the piko attribution
+    * in the source code and version control history.
+*/
+
+
+package app.morphe.extension.instagram.constants;
+
+public class Arrays{
+    public static final CharSequence[] CUSTOMISE_STORY_TIMESTAMP_KEY = new String[]{"Default","Detailed timestamp","Time left"};
+    public static final CharSequence[] CUSTOMISE_STORY_TIMESTAMP_VAL = new String[]{"default","detailed","timeleft"};
+}

extensions/instagram/src/main/java/app/morphe/extension/instagram/constants/Strings.java

@@ -0,0 +1,124 @@
+/*
+ * Copyright (C) 2026 piko <https://github.com/crimera/piko>
+ *
+ * This file is part of piko.
+ *
+ * Any modifications, derivatives, or substantial rewrites of this file
+ * must retain this copyright notice and the piko attribution
+ * in the source code and version control history.
+ */
+
+
+package app.morphe.extension.instagram.constants;
+
+public class Strings {
+    public static final String PIKO = "piko";
+    public static final String PIKO_SETTINGS = PIKO + "_settings";
+    public static final String SHARED_PREF_NAME = PIKO_SETTINGS;
+    public static final String PIKO_SETTINGS_TITLE = "Piko settings";
+
+    public static final String CATEGORY_ADS = "Ads";
+    public static final String DISABLE_ADS = "Disable ads";
+    public static final String HIDE_SUGEESTED_CONTENT = "Hide suggested content";
+    public static final String HIDE_SUGEESTED_CONTENT_DESC = "Hides suggested stories, reels, threads (Suggested posts will still be shown).";
+
+    public static final String CATEGORY_DEV_OPTIONS = "Developer options";
+    public static final String ENABLE_DEV_OPTIONS = "Enable developer options";
+    public static final String REMOVE_BUILD_EXPIRE_POPUP = "Remove build expire popup";
+    public static final String REMOVE_BUILD_EXPIRE_POPUP_DESC = "Removes the popup that appears after a while, when the app version ages";
+    public static final String EXPORT_DEV_OVERRIDES = "Export overrides";
+    public static final String IMPORT_DEV_OVERRIDES = "Import overrides";
+    public static final String IMPORT_ID_MAPPING = "Import mapping files";
+
+    public static final String CATEGORY_LINKS = "Links";
+    public static final String OPEN_LINKS_EXTERNALLY = "Open links externally";
+    public static final String OPEN_LINKS_EXTERNALLY_DESC = "Open links in external browser instead of in-app browser";
+    public static final String SANITIZE_SHARE_LINKS = "Sanitize share links";
+
+    public static final String CATEGORY_GHOST = "Ghost";
+    public static final String VIEW_STORIES_ANONYMOUSLY = "View stories anonymously";
+    public static final String VIEW_LIVE_ANONYMOUSLY = "View live anonymously";
+
+    public static final String CATEGORY_DISTRACTION_FREE = "Distraction free";
+    public static final String DISABLE_STORIES = "Disable stories";
+    public static final String DISABLE_EXPLORE = "Disable explore";
+    public static final String DISABLE_COMMENTS = "Disable comments";
+    public static final String LIMIT_FOLLOWING_FEED = "Limit feed to following profiles";
+    public static final String LIMIT_FOLLOWING_FEED_DESC = "Filters the home feed to display only content from profiles you follow.";
+    public static final String HIDE_STORIES_TRAY = "Hide stories tray";
+    public static final String HIDE_STORIES_TRAY_DESC = "Hide stories tray from main feed";
+    public static final String HIDE_GROUP_CREATION_BUTTON_ON_SHARESHEET = "Hide group creation button on sharesheet";
+
+    public static final String CATEGORY_MISC = "Misc";
+    public static final String DISABLE_ANALYTICS = "Disable analytics";
+    public static final String DELETE_ANALYTICS_CACHE = "Delete analytic cache";
+    public static final String DISABLE_ANALYTICS_DESC = "Block analytics that are sent to Instagram/Facebook servers";
+    public static final String DISABLE_DISCOVER_PEOPLE = "Disable discover people";
+    public static final String DISABLE_DISCOVER_PEOPLE_DESC = "Disables discover people section on user profile";
+    public static final String FOLLOW_BACK_INDICATOR = "Enable follow back indicator";
+    public static final String FBI_FOLLOWS_YOU = "Follows you";
+    public static final String FBI_DOESNT_FOLLOWS_YOU = "Does not follow you";
+    public static final String VIEW_STORY_MENTIONS = "View story mentions";
+    public static final String VSM_TITLE = "Story mentions";
+    public static final String VSM_NO_MENTIONS = "No mentions on this story";
+    public static final String DISABLE_STORY_FLIPPING = "Disable story flipping";
+    public static final String DISABLE_STORY_FLIPPING_DESC = "Disable automatic flipping/moving to next story";
+    public static final String DISABLE_VIDEO_AUTOPLAY = "Disable video autoplay";
+    public static final String CUSTOMISE_STORY_TIMESTAMP = "Customise story timestamp";
+    public static final String CUSTOMISE_STORY_TIMESTAMP_DESC = "Customise the timestamp that shows when the story was posted";
+    public static final String UNLIMITED_REPLAYS = "Make ephemeral media permament";
+    public static final String UNLIMITED_REPLAYS_DESC = "changes view once, view twice media to permanent view. Do note older ephemeral media might look blank";
+    public static final String IMPROVE_IMAGE_VIEWING = "Improve image viewing";
+    public static final String IMPROVE_IMAGE_VIEWING_DESC = "Fetches max resolution images from server";
+    public static final String HIDE_RESHARE_BUTTON = "Hide reshare button";
+
+    public static final String CATEGORY_DOWNLOAD_MEDIA = "Download media";
+    public static final String ENABLE_DOWNLOAD = "Enable download";
+    public static final String ENABLE_DIRECT_DOWNLOAD = "Enable direct download";
+    public static final String ENABLE_DIRECT_DOWNLOAD_DESC = "Downloads the current viewing media without asking for options";
+    public static final String DOWNLOAD_USERNAME_FOLDER = "Split media by username";
+    public static final String DOWNLOAD_USERNAME_FOLDER_DESC = "Creates subfolders based on username";
+    public static final String DOWNLOAD_CURRENT_MEDIA = "Download current media";
+    public static final String DOWNLOAD_AS_IMAGE = "Download as image";
+    public static final String DOWNLOAD_OPTIONS = "Download options";
+    public static final String COPY_MEDIA_LINK = "Copy media link";
+    public static final String COPIED_MEDIA_LINK = "Copied media link";
+    public static final String DOWNLOAD_ALL = "Download all";
+    public static final String DOWNLOADING_MEDIA = "Downloading : ";
+    public static final String DOWNLOADED_MEDIA = "Downloaded : ";
+    public static final String MEDIA_EXISTS = "Media exists";
+    public static final String DOWNLOAD_FAILED_MEDIA = "Download failed : ";
+
+
+    public static final String CATEGORY_HIDE_NAVIGATION_BUTTONS = "Hide navigation buttons";
+
+    public static final String HIDE_NAVIGATION_FEED = "Hide Feed button";
+    public static final String HIDE_NAVIGATION_REELS = "Hide Reels button";
+    public static final String HIDE_NAVIGATION_DIRECT = "Hide Direct button";
+    public static final String HIDE_NAVIGATION_SEARCH = "Hide Search button";
+    public static final String HIDE_NAVIGATION_CREATE = "Hide Create button";
+    public static final String HIDE_NAVIGATION_PROFILE = "Hide Profile button";
+
+
+    public static final String PATCH_INFO_TITLE = "Patch information";
+    public static final String EXPORT_PIKO_PREF = "Export piko preferences";
+    public static final String IMPORT_PIKO_PREF = "Import piko preferences";
+    public static final String APP_VERSION = "App version: %s";
+    public static final String PATCH_VERSION = "Patch version: %s";
+
+    public static final String EXPORT_SUCCESS = "Exported successfully";
+    public static final String EXPORT_FAIL = "Exporting failed";
+    public static final String FAIL_NO_PATH = "No destination path provided";
+    public static final String FAIL_NO_FILE = "File not found";
+    public static final String IMPORT_SUCCESS = "Imported successfully";
+    public static final String IMPORT_FAIL = "Import failed";
+    public static final String RESTART_APP = "The app needs to be restarted for the changes to reflect";
+    public static final String OK = "OK";
+    public static final String DELETED = "Deleted";
+    public static final String PIKO_DEBUG = "Piko debug";
+
+    public static final String OPEN_IMAGE_EXTERNALLY = "Open image externally";
+    public static final String OPEN_VIDEO_EXTERNALLY = "Open video externally";
+    public static final String OPEN_IMAGE_WITH = "Open image with";
+    public static final String OPEN_VIDEO_WITH = "Open video with";
+}