Subscriptions
A subscription is a URL that returns a list of servers. DubiDubi understands plain text with links, base64 of that text, Clash YAML, and arrays of full Xray configs.
Metadata
Providers can pass metadata as HTTP response headers or as #key: value lines at the top of a plain-text body:
| Key | What it does |
|---|---|
profile-title | Name shown on the subscription card. |
subscription-userinfo | upload=…; download=…; total=…; expire=… — bytes and a Unix timestamp. total=0 means unlimited. |
profile-update-interval | Hours before the list is refreshed automatically. |
support-url | Support link shown under the card. |
announce | A notice shown to the user. |
new-url, new-domain | Move clients to a new address without an app update. |
fallback-url | Backup address used on errors or timeouts. |
Directives in the body only work when the body is plain text. If the list is base64-encoded, send them as HTTP headers instead.
A minimal subscription file
#profile-title: Home servers
#profile-update-interval: 24
vless://…#Amsterdam
vless://…#Frankfurt
Serve it over HTTPS and paste the file's URL into the app.
Opening links from other apps
Links like dubidubi://import?url=<encoded subscription URL> open DubiDubi and add the subscription in one tap.