Import a subscription

What a subscription URL is

Panels that hand out VLESS / Hysteria2 / etc. access — Marzban, 3X-UI, V2Board, Hiddify, Marzneshin — give every user one private URL. That URL returns the user's complete list of servers as plain text (or base64). The list refreshes whenever the operator changes anything: rotates an IP, adds a new region, revokes access.

Instead of copying 20 individual vless:// links by hand, you paste this URL once and tnhp pulls all of them in.

Where to find your URL

• TunHops — sign in to your account → open the subscription on the dashboard → copy the import link
• Marzban — log in to the user panel → the "Subscription" button at the top → "Copy link"
• 3X-UI — your operator gives it out manually, usually formatted as https://<panel>/sub/<token>
• V2Board — Dashboard → "Subscribe" → copy the link
• Hiddify — your operator sends a sub-link tagged for v2rayN / Sing-box / Clash; any of them works for tnhp
• Marzneshin — same pattern as Marzban; the "Subscription" section in the user panel

The URL is effectively your access token. Anyone who has it gets your servers. Don't paste it in public chats or screenshots.

Importing it into tnhp

1. Open tnhp.
2. Tap + in the bottom-right corner.
3. Tap Add subscription.
4. Paste the URL into the first field.
5. (Optional) give it a name — e.g. my-marzban. If you skip this, tnhp uses the hostname.
6. Tap Fetch.

The imported servers show up grouped under the subscription name. Tap the group header to collapse or expand it. Long-press it to remove the whole batch in one go.

Caveats

• tnhp accepts VLESS, Hysteria2, NaiveProxy and AmneziaWG / WireGuard. Lines in vmess://, trojan:// or ss:// are silently skipped — they will be supported in a future release.
• If the URL points at a GitHub viewer page (github.com/.../blob/...) the response is HTML and the import fails. Use the raw URL — raw.githubusercontent.com/....
• tnhp does not yet auto-refresh subscriptions. To pull the latest list, remove the subscription and import the URL again.