Skip to content

KayJannOnGit/CapsuleGram

 
 

Repository files navigation

CapsuleGram

A feature-rich iOS modification for the Instagram app. This project is a personal fork of RyukGram (which originates from SCInsta), maintained for standalone sideloading and future personal tweaks.

Version: v1.0.0 \ Tested Instagram iOS App Version: 429.0.0


Installation

This fork is focused on non-jailbroken devices using IPA sideloading, since I don't own any jailbroken iPhone..

For Non-Jailbroken Devices (IPA Sideloading)

  1. Follow the Build instructions below to compile your custom IPA.
  2. Sign and install the generated IPA using your preferred installer (Feather, AltStore, SideStore, or TrollStore).

For Jailbroken Devices (.deb)

  1. Compile the project as a rootless or rootful package.
  2. Install the resulting .deb via Sileo, Zebra, or TrollStore.

Features

Category Features
General - Hide ads
- Hide Meta AI
- Hide metrics (likes, comments, shares counts)
- Disable app haptics
- Copy description
- Copy comment text from long-press menu
- Download GIF comments
- Profile copy button
- Replace domain in shared links for embeds (Discord, Telegram, etc.)
- Strip tracking params from shared links
- Open links in external browser
- Strip tracking from browser links
- Do not save recent searches
- Open link from clipboard — long-press the search tab
- Use detailed (native) color picker
- Enable liquid glass buttons
- Enable liquid glass surfaces
- Enable teen app icons

IG Notes:
- Hide notes tray
- Hide friends map
- Enable note theming
- Custom note themes

Focus/Distractions:
- No suggested users
- No suggested chats
- Hide trending searches
- Hide explore posts grid

Live:
- Anonymous live viewing
- Toggle live comments

Privacy:
- Hide UI on screenshots, screen recordings, and mirroring
Feed - Hide stories tray
- Hide suggested stories
- View profile picture from story tray long-press menu
- Hide entire feed
- No suggested posts
- No suggested for you (accounts)
- No suggested reels
- No suggested threads posts
- Disable video autoplay
- Media zoom — long press media to expand in full-screen viewer
- Custom date format — feed, notes/comments/stories, and DMs
- Disable background refresh, home button refresh, and home button scroll
- Disable reels tab button refresh
- Hide repost button in feed
Reels - Modify tap controls
- Auto-scroll reels mode
- Always show progress scrubber
- Disable auto-unmuting reels
- Confirm reel refresh
- Unlock password-locked reels
- Hide reels header
- Hide repost button in reels
- Hide reels blend button
- Disable scrolling reels
- Prevent doom scrolling (limit maximum viewable reels)

Enhanced Pause/Play mode:
- Mute toggle auto-hidden
- Audio forced on in reels tab
- Play indicator hidden during playback
- Playback toggle synced with overlay during hold/zoom
- Optional tap-to-mute on photo reels
Action buttons - Context-aware action menu on feed, reels, and stories
- Configurable default tap action per context
- Carousel and multi-story reel support with bulk download
- Repost via IG's native creation flow
- Full-screen media viewer with zoom and swipe
- Story playback pauses when menus are open
Profile - Zoom profile photo — long press to view full-screen
- Save profile picture
- View highlight cover from profile long-press menu
- Profile copy button
- Follow indicator — shows whether the user follows you
- Copy note on long press
- Fake profile stats — verified badge and follower/following/post counts
Profile Analyzer - Follower and following scans with progress and cancel
- Mutuals and non-followbacks lists
- New and lost followers/following trackers across scans
- Profile change history — username, name, bio, pfp
- Searchable lists with batch follow/unfollow
Saving - Enhanced HD downloads up to 1080p
  • Quality picker with preview playback
  • Audio-only and raw photo download options
  • Fallback to 720p without FFmpegKit
- Download pill with progress bar and bulk counter
- Save to custom album
- Download confirmation dialog
- Output filenames formatted as @username_context_timestamp
- Legacy long-press gesture (customizable finger count + hold time)
Stories & Messages - Keep deleted messages
- Hide trailing action buttons on preserved messages
- Warn before pull-to-refresh clears preserved messages
- Manually mark messages as seen (button or toggle mode)
- Long-press the seen button for quick actions
- Auto mark seen on send
- Auto mark seen on typing
- Mark seen on story like
- Mark seen on story reply
- Advance to next story when marking as seen
- Advance on story like
- Advance on story reply
- Per-chat read-receipt exclusion list with Block all / Block selected mode
- Send audio as file from DM plus menu
- Download voice messages
- Disable typing status
- Disable vanish mode swipe
- Hide voice/video call buttons (independent toggles)
- Unlimited replay of direct stories
- Full last active date
- Send files in DMs (experimental)
- Notes actions — copy text, download GIF/audio
- Copy note text on long press
- Disable view-once limitations
- Disable screenshot detection
- Disable story seen receipt
- Keep stories visually seen locally
- Manual mark story as seen (button or toggle mode)
- Long-press the story seen button for quick actions
- Per-user story seen-receipt exclusion list with Block all / Block selected mode
- Story audio mute/unmute toggle
- View story mentions
- Stop story auto-advance
- Reveal poll/slider vote counts and quiz answers on stories and reels before interacting
- Force legacy Quiz sticker back into the story composer tray
- Disappearing DM media overlay — action button, mark-as-viewed eye, and audio toggle
- Download disappearing DM media
- Upload audio as voice message with built-in trim editor
- Disable instants creation
Navigation - Modify tab bar icon order
- Modify swiping between tabs
- Hiding tabs (Hide feed tab, Hide explore tab, Hide reels tab, Hide create tab, Hide messages tab)
- Messages-only mode — inbox + profile only, launch straight into inbox (with floating settings gear)
- Launch tab — pick which tab the app opens to
Confirm actions - Confirm like: Posts/Stories / Reels
- Confirm story emoji reaction
- Confirm follow / unfollow
- Confirm repost
- Confirm voice call / video call
- Confirm voice messages
- Confirm follow requests
- Confirm vanish mode
- Confirm posting comment
- Confirm changing direct message theme
- Confirm sticker interaction (stories / highlights, separate toggles)
Fake location - Override location app-wide for any IG feature reading coordinates
- MapKit picker with search + reverse-geocoded names
- Saved presets
- Quick toggle button on the Friends Map
Theme - Force dark mode
- Full OLED — pure black app-wide
- OLED chat theme — pure black DM thread and incoming bubbles
- Keyboard theme — dark or OLED
- Apply & restart button
Tweak settings - Search bar with breadcrumbs across nested pages
- Pause playback when opening settings
- Quick-access via long-press on feed tab
Advanced Features - Toggle hidden Instagram experiments: QuickSnap (Instants), Direct Notes reply types, Friend Map, Homecoming, Prism
- Batched changes with an Apply & restart button
- Auto-reset after 3 consecutive launch crashes
Backup & Restore - Export settings as JSON
- Import settings from JSON
- Preview before saving or applying
Localization - Multi-language UI with fallback to English
- Built-in language picker in Settings
- Currently shipping: English, Spanish, Russian, Korean, Arabic, Chinese (Traditional)
Optimization - Clear Instagram cache on demand with optional auto-clear interval

Opening Tweak Settings

To access the configuration panel, long-press the Home/Feed tab icon within the Instagram app.

Feed Shortcut View Settings Menu View

Building From Source

Prerequisites

Install the following components in the exact order listed below.

Base Environment

  • macOS with Xcode and Command-Line Developer Tools installed.
  • Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • CMake
brew install cmake
  • Theos Development Environment
bash -c "$(curl -fsSL https://raw.githubusercontent.com/theos/theos/master/bin/install-theos)"

Requirements for Standalone IPA Packaging

  • Pipx
  brew install pipx
  pipx ensurepath
  • Cyan
  pipx install --force https://github.com/asdfzxcvbn/pyzule-rw/archive/main.zip
  • IPAPatch
  brew install ipapatch

Environment Setup

  1. Download the required iOS SDKs (e.g., iPhoneOS16.2.sdk) and place the folder inside ~/theos/sdks/.
  2. Clone this repository with all its dependencies:
   git clone --recurse-submodules [https://github.com/KayJannOnGit/CapsuleGram](https://github.com/KayJannOnGit/CapsuleGram)
   cd CapsuleGram
  1. Acquire a decrypted Instagram IPA file from a trusted source (Such as Decrypt Store), rename it exactly to com.burbn.instagram.ipa, and place it inside a new folder named packages at the root of the project.

Compilation

Run the automated build script matching your target environment:

chmod +x build.sh
./build.sh sideload

(Replace sideload with rootless or rootful if compiling a jailbreak package).


Credits

About

RyukGram Fork for me and my friends

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Objective-C 58.1%
  • Logos 38.9%
  • Shell 1.6%
  • C 1.1%
  • Objective-C++ 0.1%
  • Makefile 0.1%
  • Other 0.1%