Deep Links

Deep Links (URL scheme)

🌐 English · Русский · 中文

SlothClash can import a subscription straight from a link. Opening such a link (in a browser, chat, or a panel's "Add to app" button) launches SlothClash, shows a consent dialog, and imports the subscription as a named profile.

Scheme — slothclash://

slothclash://install-config?url=<URL-ENCODED subscription URL>&name=<optional name>

• url (required) — your subscription URL, percent-encoded.
• name (optional) — a display name for the imported profile.

The path form is also accepted:

slothclash:///install-config?url=<encoded>&name=<name>

Example

Subscription URL:

https://panel.example.com/sub/abc123

Deep link (URL-encoded):

slothclash://install-config?url=https%3A%2F%2Fpanel.example.com%2Fsub%2Fabc123&name=SwiftVPN

Always URL-encode the url value. Un-encoded ?, &, =, / in the subscription URL will break parsing.

Behaviour & safety

• Opening a link never imports silently — you see a consent dialog naming the subscription before anything is added, because a deep link can be triggered by any web page.
• The target URL is validated (SSRF guard) before it's fetched — it can't be used to make SlothClash probe internal/loopback addresses.
• The imported profile behaves exactly like one added manually (auto-update, etc.).
• If SlothClash isn't installed, the link does nothing — host it behind a normal web page with a download fallback.

For panels / operators

Emit a per-user install link with the subscription URL already percent-encoded:

slothclash://install-config?url=<ENCODED_SUBSCRIPTION_URL>&name=<USERNAME>

Related

• Getting Started — importing subscriptions in-app
• Encrypted Subscriptions