whatisgithub

What is simorgh?

rezakhosh78/simorgh — explained in plain English

Analysis updated 2026-05-18

14KotlinAudience · generalComplexity · 3/5Setup · moderate

In one sentence

An Android VPN app built for censored networks like Iran, offering several proxy and IP-scanning methods to keep internet access working when routes get blocked.

Mindmap

mindmap
  root((repo))
    What it does
      Bypasses network blocks
      Scans working IPs
      Manages proxy profiles
    Tech stack
      Kotlin
      Android
    Use cases
      Connect in Iran
      Switch to healthy config
      Route via domestic network
    Audience
      Censored network users
    Modes
      Proxy mode
      VPN mode

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

Automatically connect to a working proxy config when international internet access is blocked.

USE CASE 2

Scan IP ranges to find working paths when only domestic network routes are reachable.

USE CASE 3

Run a local proxy that other apps on the device can route through.

USE CASE 4

Import and manage NipoVPN profile links alongside the built-in connection methods.

What is it built with?

KotlinAndroidXRAY

How does it compare?

rezakhosh78/simorghcomposablehorizons/material-3-compose-unstyledlyosu/hortay-android
Stars141414
LanguageKotlinKotlinKotlin
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Android 10 or higher, effectiveness depends on current network blocking conditions in the user's country.

License terms are not stated in the explanation.

So what is it?

SIMORGH VPN is an Android application built for users in environments where internet access is frequently blocked, throttled, or redirected to a national intranet. The app focuses specifically on Iran network conditions, where international traffic may be cut off entirely while domestic routes remain reachable. It tries several connection methods depending on what kind of access is currently available. The app has three main sections. The Simple page handles standard connections using XRAY proxy configs, a type of configuration common in censored networks. It downloads configs from a built-in subscription source, tests them automatically, and connects to the first one that responds. If the current connection stops working, a Next Healthy button switches to the next tested config without starting over. The Advance page is designed for situations where international internet is blocked but Iran's domestic network is still reachable. In those cases, the app uses its own routing engine along with IP scanning to find working paths. It scans ranges of IP addresses, tests them against a selected domain name for TLS, and builds a pool of working IPs. You can run it in Proxy Mode, which starts a local proxy on port 9990 or 9991 that other apps on your device can point to, or in VPN Mode, which routes all Android traffic through the tunnel. The NipoVPN page adds support for a separate connection type using nipovpn:// profile links. You can import, save, edit, and delete profiles, and connect using the NipoVPN core bundled inside the app. The README is written as detailed technical documentation aimed at users who already understand the context of Iranian internet restrictions and proxy tools. Version 1.1.23.44 requires Android 10 (SDK 29) or higher.

Copy-paste prompts

Prompt 1
Explain the difference between the Simple page and the Advance page in SIMORGH VPN.
Prompt 2
Explain what IP scanning does and why it helps when international internet is blocked.
Prompt 3
Walk me through switching to Proxy Mode versus VPN Mode in this app.
Prompt 4
Explain what an XRAY proxy config is in plain terms.
Prompt 5
List the Android version requirements for running SIMORGH VPN.

Frequently asked questions

What is simorgh?

An Android VPN app built for censored networks like Iran, offering several proxy and IP-scanning methods to keep internet access working when routes get blocked.

What language is simorgh written in?

Mainly Kotlin. The stack also includes Kotlin, Android, XRAY.

What license does simorgh use?

License terms are not stated in the explanation.

How hard is simorgh to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is simorgh for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.