nsringo/iringo

★ 10,483Audience · generalComplexity · 3/5Setup · hard

Mindmap

mindmap
  root((iRingo))
    Apple services
      Apple News
      Apple Intelligence
      Siri extras
      Maps and Weather
    Supported apps
      Surge
      Loon
      Quantumult X
      Shadowrocket
    Modules
      Weather
      Location
      TestFlight
      Apple TV
    Setup
      BoxJs config
      MitM required
      iOS 14 to 18

mindmap root((iRingo)) Apple services Apple News Apple Intelligence Siri extras Maps and Weather Supported apps Surge Loon Quantumult X Shadowrocket Modules Weather Location TestFlight Apple TV Setup BoxJs config MitM required iOS 14 to 18

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Unlock Apple News on an iPhone outside the US by loading the iRingo News module in Surge or Quantumult X.

USE CASE 2

Enable Apple Intelligence features unavailable in your region by installing the Siri and Intelligence module.

USE CASE 3

Make Apple Maps behave as if your device is in the US to access features not yet available in your country.

Tech stack

JavaScript

Getting it running

Difficulty · hard Time to first run · 1h+

Requires a paid proxy app (Surge, Quantumult X, or similar) with rewrite and MitM features enabled and a separate BoxJs installation for configuration.

In plain English

iRingo is a collection of scripts for network proxy applications that aims to unlock Apple features and services that are restricted to certain countries or regions. The README is written in Chinese. The project is aimed at people outside markets like the United States who want to access Apple services that Apple has not made available in their region, such as Apple News, Apple Intelligence, certain Siri features, and full functionality in Apple Maps and WeatherKit. The scripts work by running inside specialized proxy and network-filtering apps on Apple devices. The tools it supports include Surge, Loon, Stash, Egern, Quantumult X, and Shadowrocket. These apps can intercept and rewrite network traffic passing through the device, which is how iRingo makes Apple services behave as if the device is in a different region. Each of these apps needs to have its rewrite, script, and MitM (traffic inspection) features turned on for the scripts to work. The project is organized into independent modules covering different Apple services: weather (WeatherKit), location, maps, Apple Intelligence and Siri, Apple TV, Apple News, TestFlight, and Apple Watch features. Each module can be used on its own without the others. The README lists which versions of iOS, iPadOS, macOS, and watchOS each module has been tested against, ranging from iOS 14 through iOS 18 and macOS 12.3 through macOS 15. Configuration is managed through a visual settings panel that requires a separate open-source tool called BoxJs. The project has a companion website with a full wiki, and users can get updates and ask questions through a Telegram channel and group linked in the README.

Copy-paste prompts

Prompt 1

I have Surge on my iPhone and want to unlock Apple News using iRingo. Show me how to add the module and which rewrite and MitM settings to enable.

Prompt 2

How do I install BoxJs to manage my iRingo module settings through a visual panel?

Prompt 3

I am on iOS 17 outside the US. Which iRingo modules support my iOS version for Apple Intelligence and WeatherKit?

Prompt 4

How do I enable MitM and script rewrites in Quantumult X so iRingo modules can intercept and rewrite Apple service traffic?

Open on GitHub → Explain another repo

← nsringo on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.