RyukGram/README.md

RyukGram

A feature-rich iOS tweak for Instagram, forked from SCInsta with additional features and fixes.
Version v1.1.4 | Tested on Instagram 423.1.0

---

Note

To modify RyukGram's settings, check out this section below for help

---

Installation

Important

Which type of device are you planning on installing this tweak on?

• Jailbroken/TrollStore device -> Download pre-built tweak
• Standard iOS device -> Sideload the dylib using Feather or similar

Features

Features marked with * are new or improved in RyukGram

General

• Hide ads
• Hide Meta AI
• Copy description
• Profile copy button *
• Do not save recent searches
• Use detailed (native) color picker
• Enable liquid glass buttons
• 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

Feed

• Hide stories tray
• Hide entire feed
• No suggested posts
• No suggested for you (accounts)
• No suggested reels
• No suggested threads posts
• Disable video autoplay

Reels

• Modify tap controls
• Always show progress scrubber
• Disable auto-unmuting reels (properly blocks mute switch, volume buttons, and announcer broadcasts) *
• Confirm reel refresh
• Unlock password-locked reels *
• Hide reels header
• Hide reels blend button
• Disable scrolling reels
• Prevent doom scrolling (limit maximum viewable reels)
• Enhanced Pause/Play mode (when Pause/Play tap control is set): *
  • Mute toggle auto-hidden, only play/pause icon visible
  • Audio forced on in reels tab
  • Play indicator properly hidden when video plays (fixes IG bug after hold/zoom)
  • Playback toggle synced with overlay during hold/zoom
  • Works across IG A/B test variants

Saving

• Download feed posts (photo + video)
• Download reels
• Download stories
• Save profile picture
• Download buttons on media — tap a button directly on feed posts, reels sidebar, and story overlay *
• Download method — choose between download button or long-press gesture *
• Save action — choose between share sheet or save directly to Photos *
• Save to RyukGram album — optional toggle that routes downloads (and share-sheet "Save to Photos" picks) into a dedicated "RyukGram" album in Photos *
• Download confirmation — optional confirmation dialog before downloading *
• Non-blocking download HUD — pill-style progress at the top, tap to cancel *
• Debug fallback — if IG updates break downloads, shows diagnostic info instead of crashing *
• Customize finger count for long-press
• Customize hold time for long-press

Stories and messages

• Keep deleted messages (preserves unsent messages with visual indicator and notification pill) *
• Hide trailing action buttons on preserved messages
• Warn before clearing on refresh — optional confirmation when pulling to refresh the DMs tab if preserved messages would be cleared *
• Manually mark messages as seen (button or toggle mode) *
• Long-press the seen button for quick actions *
• Auto mark seen on send (marks messages as read when you send any message) *
• Auto mark seen on typing (marks messages as read the moment you start typing, even when typing status is hidden) *
• Mark seen on story like *
• Advance to next story when marking as seen — tapping the eye button auto-skips to the next story *
• Per-chat read-receipt exclusions — long-press any DM chat to exclude it from all read-receipt features. Excluded chats behave like a vanilla install (manual seen button, auto seen on send/typing, visual message blocking, view-once override are all skipped). Settings page lists excluded chats with search, sort, swipe-to-remove, and a per-entry override to also bypass keep-deleted-messages *
• Send audio as file — send audio files as voice messages from the DM plus menu *
• Download voice messages — adds a Download option to the long-press menu on voice messages, saves as M4A via share sheet *
• Disable typing status
• Unlimited replay of direct stories
• Disable view-once limitations
• Disable screenshot detection
• Disable story seen receipt (blocks network upload, toggleable at runtime without restart) *
• Keep stories visually unseen — keeps the colorful ring in the tray after viewing *
• Manual mark story as seen — button on story overlay to selectively mark stories as seen (button or toggle mode) *
• Long-press the story seen button for quick actions *
• Per-user story seen-receipt exclusions — exclude specific users so their stories behave normally. Manage via 3-dot menu, eye button long-press, or settings list *
• Stop story auto-advance — stories won't auto-skip when the timer ends *
• Story download button — download directly from the story overlay *
• Download disappearing DM media (photos + videos) *
• Mark disappearing messages as viewed button *
• Upload audio as voice message — send audio files, extract audio from videos, 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

Confirm actions

• Confirm like: Posts/Stories
• Confirm like: Reels
• Confirm follow
• Confirm repost
• Confirm call
• Confirm voice messages
• Confirm follow requests
• Confirm shh mode (disappearing messages)
• Confirm posting comment
• Confirm changing direct message theme
• Confirm sticker interaction

Tweak settings *

• Search bar in the main settings page — recursively finds any setting across nested pages with a breadcrumb to its location

Backup & Restore *

• Export RyukGram settings as a JSON file
• Import settings from a JSON file
• Searchable, collapsible, editable preview before saving or applying

Optimization

• Automatically clears unneeded cache folders, reducing the size of your Instagram installation

Known Issues

• Preserved unsent messages cannot be removed using "Delete for you". Pull to refresh in the DMs tab clears all preserved messages (with optional confirmation if "Warn before clearing on refresh" is enabled).
• "Delete for you" detection uses a ~2 second window after the local action. If a real other-party unsend happens to land in the same window, it may not be preserved. Rare in practice and limited to that specific overlap.

Opening Tweak Settings

Building from source

Prerequisites

• XCode + Command-Line Developer Tools
• Homebrew
• CMake (brew install cmake)
• Theos
• cyan *only required for sideloading
• ipapatch *only required for sideloading

Setup

1. Install iOS 16.2 frameworks for theos
   1. Click to download iOS SDKs
   2. Unzip, then copy the iPhoneOS16.2.sdk folder into ~/theos/sdks
2. Clone repo: git clone --recurse-submodules https://github.com/faroukbmiled/RyukGram
3. For sideloading: Download a decrypted Instagram IPA from a trusted source, making sure to rename it to com.burbn.instagram.ipa. Then create a folder called packages inside of the project folder, and move the Instagram IPA file into it.

Run build script

$ chmod +x build.sh
$ ./build.sh <sideload/rootless/rootful>

Credits

• SCInsta by @SoCuul — original tweak this fork is based on
• @BandarHL — creator of the original BHInstagram project
• @faroukbmiled — RyukGram modifications and additional features