Skip to content

mapleafgo/singcast

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

514 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Singcast

Singcast

Multi-platform proxy client powered by sing-box, with Clash config support

English | 中文

Telegram

Singcast is an open-source multi-platform proxy client built with Flutter and powered by a customized sing-box core. It supports Clash subscription links and configuration files out of the box — just import and go.

Available on Windows, Linux, macOS, and Android.

  • Desktop: Core runs as an independent privileged process communicating via JSON-RPC (IPC), keeping the UI sandboxed and stable.
  • Mobile: Core is loaded as a native library via FFI, integrated tightly with the platform VPN service.
  • TUN mode: Transparent proxy with automatic route management — no manual system proxy setup needed.

Documentation

Preview

Home

Features

  • Support Clash subscriptions and configuration files
  • System proxy and TUN mode (transparent proxy)
  • Proxy node selection and latency testing
  • Real-time traffic statistics
  • Subscription management, import and update subscription links
  • Log viewer with export
  • System tray on desktop

Usage

Linux

Make sure to install the following dependencies before using

sudo apt-get install libayatana-appindicator3

Download

GitHub Releases

Build

  1. Install Flutter v3.41+

    Follow the Flutter official documentation to set up the environment for your target platform. For example, Android development requires Android SDK.

  2. Download core

    Download the core for your platform from singcast-cli Releases and place it at:

    # Desktop (IPC standalone process)
    windows/core/singcast-core.exe
    linux/core/singcast-core
    macos/Frameworks/singcast-core
    
    # Mobile (FFI native library)
    android/app/libs/libsingcast.aar
    ios/Frameworks/libsingcast-darwin.xcframework
  3. Build and run

    # Install dependencies
    flutter pub get
    # Generate code
    dart run build_runner build --delete-conflicting-outputs
    # Run
    flutter run -d linux

FAQ

Subscription fetch / update failed

If the subscription keeps loading or returns an error, the provider may be restricting certain User-Agent strings. Try changing the UA in Settings → General → Subscription User-Agent (e.g. clash-verge/v2.0.0, clash-meta), then update the subscription again.

Tech Stack

About

Multi-platform proxy client powered by sing-box, with Clash config support

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors