# Maasea/sgmodule

surge module

Repository: https://github.com/Maasea/sgmodule
Canonical: https://ross.abutalabs.com/products/sgmodule
Language: JavaScript
License: Apache-2.0
License Family: permissive
Last push: 2026-07-19T08:34:04+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 93, release rhythm 35, longevity 100
- inputs: {"age_days": 2271, "days_push": 45, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1359, forks 175 (observed 2026-08-28T04:04:29.741164+00:00)

## What it is
A collection of Surge modules (sgmodule files) written in JavaScript that enhance or modify mobile apps and network behavior, such as removing ads from YouTube and Bilibili and adapting Aliyun DoH JSON API authentication. The scripts are tested with Surge and compatibility with other proxy clients is not guaranteed.

## Use cases
- block ads in the YouTube app on iOS
- enable background playback and picture-in-picture for YouTube Music
- remove danmaku and ads from Bilibili
- block P2P traffic from Bilibili
- simplify the Keep app navigation and remove its ads
- authenticate requests to Aliyun DoH JSON API
- customize app behavior via Surge MITM scripts

## When to choose
- you use Surge on iOS or macOS and want ready-made modules for ad removal and app enhancement
- you need Aliyun DoH JSON API auth support in Surge
- you prefer lightweight, per-app module configurations

## When to avoid
- you use a proxy client other than Surge, since compatibility is not guaranteed
- you need a general-purpose ad blocker outside the Surge ecosystem
- you want guaranteed long-term support for specific app versions

## Facets
- artifact type: plugin
- maturity: active
- function: middleware, privacy, web-scraping, security
- domain: privacy, networking, mobile-development, censorship-circumvention
- platform: cross-platform
- tags: surge-module, ad-blocking, mitm-scripts, youtube, bilibili, doh, proxy-rules, ios, macos

## Member repositories
- Maasea/sgmodule (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:29.741164+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:41:41.473149+00:00, confidence not recorded.
  - readme: https://github.com/Maasea/sgmodule (fetched 2026-08-28T04:04:29.741164+00:00, sha f8ba714b54c5)
- Data as of 2026-08-30T08:39:29.467469+00:00.