whatisgithub

What is iringo?

nsringo/iringo — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

A set of proxy scripts that unlock Apple features restricted to certain countries, Apple News, Apple Intelligence, Siri extras, Maps, by intercepting network traffic through apps like Surge, Loon, or Quantumult X.

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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

JavaScript

How does it compare?

nsringo/iringohuggingface/skillsautomattic/harper
Stars10,48310,48310,482
LanguagePythonRust
Setup difficultyhardeasyeasy
Complexity3/52/52/5
Audiencegeneraldeveloperwriter

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is iringo?

A set of proxy scripts that unlock Apple features restricted to certain countries, Apple News, Apple Intelligence, Siri extras, Maps, by intercepting network traffic through apps like Surge, Loon, or Quantumult X.

How hard is iringo to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is iringo for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.