Skip to content

V2pn 1.1.0

Choose a tag to compare

@Piwqust Piwqust released this 16 Nov 01:01
· 77 commits to v2pn since this release

Provider looks

A provider can now dress V2pn in its own look. The first is Configra.

  • A provider's site or bot can open V2pn with a v2pn://add link, on Windows and on macOS. V2pn always asks before adding the subscription, and says when the provider is a confirmed V2pn partner. A link to a subscription you already have only says so. Happ, v2RayTun and Hiddify add links work the same way.
  • When the provider is a V2pn partner, V2pn checks its signature and offers its look once: open it or stay in plain V2pn. Switch any time from the name in the title bar, the tray menu, Ctrl+1…9 or the Appearance page; the new look opens as a circle from where you clicked. The connection, settings and servers stay as they are.
  • V2pn draws two looks in the provider's colours. Neon is one column like a VPN app on a phone: the provider at the top with Proxy or VPN, one big round Connect button in a glowing ring of its colours (or a row with the server and a switch), the server, the state and what goes through the VPN under it, and at the bottom one sheet: your plan and the days left, the traffic, the provider's offer, then one list with its buttons first and its servers after. It is made for the mini window and opens there the first time when the provider asks; a wider window puts the card beside the column. The Pass is plain V2pn with the provider's card over the status card, like a bank card in Wallet: its logo, your plan and devices, the days left in big type, the traffic, and links to renew and to its cabinet. Configra gets the same two looks.
  • Both looks fit every window size, down to the mini window, in light and dark, and have every control: the server list, Proxy or VPN, what goes through the VPN, ping, update and "+". Text in a look always reads well, whatever colours or picture the provider picks.
  • On the Appearance page you pick the look, and for Neon light or dark and the provider's colour or one of V2pn's. Neon starts dark; dialogs, menus and settings follow it, and every text in it is checked to read well. The Pass keeps your appearance of plain V2pn; what you set for Neon stays with Neon.
  • The look starts with the provider's servers and shows its subscription: traffic, the term, its note, its cabinet and support, and, when the provider shares them, your plan, devices and how many of its servers work by its own checks. When you are connected through another provider's server, the look says so and offers the provider's fastest one.
  • A partner's subscription shows its mark in the list, and the subscription window says whether its look is confirmed and until when.
  • A provider's look goes away with its last subscription, when the provider stops offering it, when its confirmation runs out or when V2pn withdraws it; V2pn says why and opens plain V2pn.
  • The provider does not see your traffic, gets nothing about your device, and cannot change what the connection state says.

What your provider sets for its subscription

Many providers already set up their subscriptions for Happ, INCY and v2RayTun. V2pn now understands the same settings, so they work in V2pn without any change on the provider's side.

  • A provider's banner shows under its subscription in the list, above its servers and in the subscription window: a short note in green, blue or red (V2pn's own colours) with a button such as "Buy" or "More".
  • When a subscription ends within three days, or has ended, the banner reminds you instead, with a "Renew" button that leads to the provider's renewal page or its site. The provider can word the reminder itself or turn it off.
  • An announcement with a link gets a "More" button.
  • A provider can ask V2pn to connect when it starts: to the last server you used, the fastest one or a random one. This happens only when V2pn starts switched off; if you left it connected, it connects as before. A message says where it connected and why. In the subscription window, "Connect at start" → "I'll choose myself" turns it off for that subscription.
  • A provider can set the order of its servers (fastest first, by name, or as it sends them), and ask V2pn to update the subscription and test its servers when it starts. The subscription window shows what the provider asked for, and "Server order" lets you pick your own.
  • A provider whose V2pn partner certificate covers a new address can move its subscription there; the log says so. Other subscriptions can't move themselves: otherwise anyone answering on the old address could take the subscription away.
  • Links from these settings open only if they are https or Telegram.
  • When downloading a subscription, V2pn now adds its own name after v2rayN's in the User-Agent, so a provider can answer V2pn with its own settings.

Your provider's buttons and servers

A V2pn partner can now describe its servers and add a few buttons of its own. What each button does is V2pn's: the provider only names it.

  • Up to four buttons such as "Fastest", "Most stable", "For YouTube" or "Renew" sit under Connect while you use one of the provider's servers, and in every look of the provider, at every window size. A connect button tests the servers first and then says where it connected and why: "Germany 2: the fastest", "Netherlands: by Kestrel's check".
  • "Most stable" remembers V2pn's last ten checks of each server and takes the one that answered most often and most evenly. "For YouTube" asks the provider which server suits YouTube now and falls back to the fastest suitable one when the provider does not answer.
  • Other buttons open the provider's cabinet, renewal page, support or a page on its site, update the subscription, show a short note from the provider, or check whether YouTube, Telegram and ChatGPT open through the connection.
  • The provider's servers come in its groups, with their city, what they are for (YouTube, games, mobile internet, whitelists and so on) and a short note. A server the provider hides is not listed.
  • The subscription window says what the provider may do: its look, plan details, its own buttons, closed settings.

Closed settings

A provider that V2pn has checked by hand can close the settings of its subscription, as in Happ and INCY, to keep its servers from being copied.

  • The servers' addresses are hidden, and they cannot be edited, shared, copied as links, shown as QR codes, exported or put into a backup. The subscription's link cannot be changed, and the provider can hide it too.
  • You can always connect, pick any of its servers, delete the subscription, go back to plain V2pn and use your own servers and routing.
  • The subscription says "Settings closed by ", so it never looks like V2pn broke. From any other subscription these settings do nothing.

Your provider's routes and connection settings

A provider can now offer its own routes and tune how V2pn connects to its servers. V2pn uses each of these only after reading the exact file by hand; if the provider changes it later, V2pn stops using it until it is checked again.

  • "What goes through the VPN" gets one more mode, " routes", while you use one of its servers: for example YouTube, Telegram and AI through the VPN, banks direct. V2pn tells you once that the mode is there; it never switches to it by itself. Your local network always stays direct.
  • The provider's fragmentation (and noise on mKCP and Hysteria servers) is used for its servers only, in place of your own fragment setting for them. Your other connections don't change.
  • A provider can add its own relay or extra servers, balance between them and send some sites to them, for its servers only. All of it passes the same filter as configs from subscriptions: nothing listens on your network, writes files or reaches your computer from outside.
  • The subscription window lists what V2pn checked and whether each part is used, turned off by you, or changed after the check and not used. " connection settings" turns the fragmentation and the extra servers off for that subscription.
  • When the provider's subscription is deleted or its confirmation ends, its routes go too, and V2pn switches to "Everything through VPN" if they were on.

For providers: the theme builder

With developer mode on (About → updates), the ☰ menu has "Theme builder". A provider puts its theme together there without writing JSON, before it has a certificate.

  • A short form: name and id, one to three colours, the two looks as small pictures (a click picks the one the pack opens in), Neon's Connect button and window, the Pass card's background (the brand colour, a gradient or a picture), the pictures and the buttons. A picture that does not fit its place is refused at once, and the place says why.
  • On the right, the real look draws it on made-up data: Neon, or the Pass card when the pack opens in the Pass, mini, medium or wide, light or dark, with what V2pn changed so text reads and what it leaves out.
  • It opens and saves a pack folder, signs it with the provider's key the same way tools/partner.cs pack does, and writes the certificate request. The key can be made there too.
  • An older pack opens too: the builder lists the fields V2pn no longer uses and leaves them out when it saves.
  • "Show in V2pn" dresses the running app in the unsigned theme. The title bar marks it "Preview" and takes it away; nothing of it is kept, and it is gone after a restart.
  • A long state in a look's pill now ends in "…" instead of being cut off.

First start

A new install now walks you through the setup in five steps: the language (English or Russian), your servers, what goes through the VPN, Proxy or VPN mode, and a summary with a Connect button. Each step can be changed later in the same place on the main screen, and "Skip" is always there.

  • The language can be picked right away. A new install no longer has to start in English and be switched in Appearance.
  • The servers step shows the download as it goes: how many servers have arrived, and when they are ready.
  • The summary shows which server Connect will use, and every choice has a "Change" link.

Moving from other apps

On the first start V2pn looks for other VPN apps on the computer and offers to bring their subscriptions and servers over: Clash Verge, Clash Party (Mihomo Party), Clash Nyanpasu, Clash for Windows, FlClash, NekoRay and NekoBox, Throne, Hiddify, v2RayTun, Karing, GUI.for.Clash and GUI.for.SingBox, and v2rayN as before. With several apps found, the card lists them with ticks; one button moves all that are ticked.

  • Subscriptions come over with the names you gave them and download right away. Servers you added by hand come over as they are.
  • The other apps are only read: they keep working as they did.
  • A server V2pn already has, or a subscription it already has, is not added twice.
  • Kinds of servers V2pn cannot run (plain HTTP proxies, shadow-tls, h2) stay behind, and the message says how many.
  • Routing rules of other apps don't come over; V2pn's own modes cover what they are usually for.
  • The same is in the menu any time: Tools → "Move from another app". A portable copy the search missed (NekoRay or Throne unpacked somewhere unusual) is found with "Choose the app's folder…".
  • Happ keeps its servers encrypted, so V2pn can't read them. The menu shows Happ with a hint: copy the subscription link in Happ and paste it into V2pn.
  • A subscription that answers only in Clash format now becomes a list of servers, each on the map, instead of one opaque Clash profile.

Interface

  • The "What goes through the VPN" menu is redone. It has the same dark surface as the bar it opens from instead of a light grey one. Each mode has its own icon, and a radio button shows which one is on. The ad blocker and your own rules line up under the modes, and "Routing settings" became a link at the bottom. The modes on the first-run card look the same.
  • Other pop-up panels (pickers in the server window, the theme and backup menus) use the same dark surface too.

Safety

  • Some subscriptions send a whole Xray, sing-box or Clash config instead of server links. Such a config could open your computer to the local network as a proxy, write files to your disk, read your files or let the server connect back to you. V2pn now runs it only after taking all of that out: the servers and the routing to them stay, and its local ports listen on this computer only. The log says what was taken out. Configs you import from your own files run as before.
  • A whole config for a core other than Xray, sing-box and Clash is no longer run from a subscription; V2pn says so and suggests asking the provider for server links.

Download

Download for Windows   Download for macOS

System File
Windows 10 and 11, x64 V2pn-windows-x64.zip
Windows 11 on ARM V2pn-windows-arm64.zip
macOS 13.6 or later, Apple silicon (M1 and later) V2pn-macos-arm64.dmg
macOS 13.6 or later, Intel V2pn-macos-x64.dmg

Or in one command. Windows (Terminal): irm https://github.com/Piwqust/V2pn/releases/latest/download/install.ps1 | iex. Mac (Terminal): curl -fsSL https://github.com/Piwqust/V2pn/releases/latest/download/install.sh | bash. Both install without the first-launch warning and move your servers from v2rayN.

Already using V2pn? Nothing to download: it updates itself.

On the first launch of a downloaded file, Windows and macOS warn that they do not know the developer, because the app has no paid signature. How to get past it is in the README.

The other files in the list below

They are for the app, not for people. The updater reads -update.zip, the macOS .zip, release.json and release.json.sig; -update.zip has no cores, so it does not work as a first install. .sha256 files are checksums: sha256sum -c V2pn-windows-x64.zip.sha256. install.ps1 and install.sh are the one-command installers above.

По-русски: README.ru.md. Интерфейс переключается на русский в «Appearance».