# sysadmindoc/hushgram architecture

> Architecture diagram of the GitHub repository sysadmindoc/hushgram, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sysadmindoc/hushgram
- Repository: https://github.com/sysadmindoc/hushgram

## Overview

HushGram is a Morphe patch set that modifies Instagram for Android, adding user-configurable privacy, media, messaging, and interface features. The principal workflow is: a user supplies an Instagram APK to Morphe Manager, which applies HushGram patches; the user then enables features in Instagram’s settings and uses them in the modified app. The tree shows those feature areas and shared settings/diagnostics code, but sampled source is limited, so most feature-level runtime connections are not inferred.

Main entry points: [`extensions/instagram/src/main/java/app/hushgram/extension/instagram/settings`](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/settings) (Settings screen), [`extensions/instagram/src/main/java/app/hushgram/extension/instagram`](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram) (Modified Instagram), [`extensions/instagram/src/main/java/app/hushgram/extension/instagram/direct`](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/direct) (Direct messaging), [`extensions/shared/library/src/main/java/app/hushgram/extension/shared/diagnostics`](https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/diagnostics) (Diagnostics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_patching["Patch workflow"]
  node_patches["HushGram patches"]
  node_modified_instagram["Modified Instagram"]
end

subgraph group_experience["Instagram features"]
  node_feed_explore["Feed and discovery"]
  node_direct["Direct messaging"]
  node_downloads["Media saving"]
  node_comments["Comment tools"]
  node_background_play["Background playback"]
  node_privacy_features["Privacy features"]
end

subgraph group_shared["Shared runtime"]
  node_shared_runtime["Shared runtime"]
  node_diagnostics["Diagnostics"]
  node_log_export["Log export"]
end

subgraph group_support["Settings and diagnostics"]
  node_settings_ui["Settings screen"]
  node_setting_values[("Setting values")]
end

node_user(("User"))
node_instagram_apk["Instagram APK"]
node_manager["Morphe Manager"]
node_instagram_service["Instagram services"]

node_user -->|"supplies"| node_instagram_apk
node_user -->|"uses"| node_manager
node_manager -->|"applies"| node_patches
node_manager -->|"builds"| node_modified_instagram
node_instagram_apk -->|"patches input"| node_manager
node_user -->|"configures"| node_settings_ui
node_settings_ui -.->|"edits"| node_setting_values
node_user -->|"uses"| node_feed_explore
node_user -->|"uses"| node_direct
node_user -->|"saves media"| node_downloads
node_user -.->|"uses"| node_comments
node_user -.->|"plays media"| node_background_play
node_user -->|"uses"| node_privacy_features
node_modified_instagram -->|"opens"| node_settings_ui
node_direct -.->|"reads and sends messages"| node_instagram_service
node_shared_runtime -.->|"reports failures"| node_diagnostics
node_diagnostics -->|"exports reports"| node_log_export

click node_patches "https://github.com/sysadmindoc/hushgram/tree/main/patches/src/main/kotlin/app/morphe/patches/instagram"
click node_modified_instagram "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram"
click node_settings_ui "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/settings"
click node_setting_values "https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings"
click node_feed_explore "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/feed"
click node_direct "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/direct"
click node_downloads "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/download"
click node_comments "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/comment"
click node_background_play "https://github.com/sysadmindoc/hushgram/blob/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/media/BackgroundPlayService.java"
click node_privacy_features "https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram"
click node_shared_runtime "https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared"
click node_diagnostics "https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/diagnostics"
click node_log_export "https://github.com/sysadmindoc/hushgram/blob/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings/preference/LogBufferManager.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_patches,node_modified_instagram,node_user toneBlue
class node_feed_explore,node_direct,node_downloads,node_comments,node_background_play,node_privacy_features toneAmber
class node_shared_runtime,node_diagnostics,node_log_export toneMint
class node_settings_ui,node_setting_values toneRose
class node_instagram_apk,node_manager,node_instagram_service toneIndigo
```

## Components

### Patch workflow

- [HushGram patches](https://github.com/sysadmindoc/hushgram/tree/main/patches/src/main/kotlin/app/morphe/patches/instagram): `patches/src/main/kotlin/app/morphe/patches/instagram`
- [Modified Instagram](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram): `extensions/instagram/src/main/java/app/hushgram/extension/instagram`

### Instagram features

- [Feed and discovery](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/feed): `extensions/instagram/src/main/java/app/hushgram/extension/instagram/feed`
- [Direct messaging](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/direct): `extensions/instagram/src/main/java/app/hushgram/extension/instagram/direct`
- [Media saving](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/download): `extensions/instagram/src/main/java/app/hushgram/extension/instagram/download`
- [Comment tools](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/comment): `extensions/instagram/src/main/java/app/hushgram/extension/instagram/comment`
- [Background playback](https://github.com/sysadmindoc/hushgram/blob/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/media/BackgroundPlayService.java): `extensions/instagram/src/main/java/app/hushgram/extension/instagram/media/BackgroundPlayService.java`
- [Privacy features](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram): `extensions/instagram/src/main/java/app/hushgram/extension/instagram`

### Shared runtime

- [Shared runtime](https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared): `extensions/shared/library/src/main/java/app/hushgram/extension/shared`
- [Diagnostics](https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/diagnostics): `extensions/shared/library/src/main/java/app/hushgram/extension/shared/diagnostics`
- [Log export](https://github.com/sysadmindoc/hushgram/blob/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings/preference/LogBufferManager.java): `extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings/preference/LogBufferManager.java`

### Settings and diagnostics

- [Settings screen](https://github.com/sysadmindoc/hushgram/tree/main/extensions/instagram/src/main/java/app/hushgram/extension/instagram/settings): `extensions/instagram/src/main/java/app/hushgram/extension/instagram/settings`
- [Setting values](https://github.com/sysadmindoc/hushgram/tree/main/extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings): `extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings`

### Other components

- **User**
- **Instagram APK**
- **Morphe Manager**
- **Instagram services**

## Connections

- User → Instagram APK: supplies
- User → Morphe Manager: uses
- Morphe Manager → HushGram patches: applies
- Morphe Manager → Modified Instagram: builds
- Instagram APK → Morphe Manager: patches input
- User → Settings screen: configures
- Settings screen → Setting values: edits (evidence: `extensions/instagram/src/main/java/app/hushgram/extension/instagram/settings/Settings.java`)
- User → Feed and discovery: uses
- User → Direct messaging: uses
- User → Media saving: saves media
- User → Comment tools: uses
- User → Background playback: plays media
- User → Privacy features: uses
- Modified Instagram → Settings screen: opens (evidence: `extensions/instagram/src/main/java/app/hushgram/extension/instagram/media/BackgroundPlayService.java`)
- Direct messaging → Instagram services: reads and sends messages
- Shared runtime → Diagnostics: reports failures (evidence: `extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings/preference/LogBufferManager.java`)
- Diagnostics → Log export: exports reports (evidence: `extensions/shared/library/src/main/java/app/hushgram/extension/shared/settings/preference/LogBufferManager.java`)
