Tutorial for HiddifyNext app - Xen-neX/Hiddify-Manager GitHub Wiki

Lang_Farsi  فارسی          

Tutorial for HiddifyNext app

This app is a multi-platform client based on Sing-box that serves as a universal proxy toolchain. This app offers a wide range of capabilities. It also supports a large number of protocols. The app is free to use, ad-free, and open-source. It provides a secure and private tool for getting access to the free internet.

🚀 Supporting a wide range of protocols such as: ECH, Sing-box, V2ray, Xray, Vless, Vmess, Trojan, Reality, gRPC, WebSocket, Quic, TUIC, Hysteria, Hysteria2, Shadowtls, SSH, Clash, Clash meta

🟡 Supporting different subscription links like: Clash, Sing-box, Shadowsocks

View more features

For reading the tutorial follow this article.

Software installation

Choose one of the following based on your operating system.



Install on Windows (click)
  • First download the program from here.

  • Now run the downloaded file. This Windows security message will appear and you must click Yes.

  • In Windows 11, a warning may be displayed like this, click on More info.
  • Then click Run Anyway to open the file.
  • In the next step, it displays the installation location of the program, which you can change if needed and click Next.
  • At this stage, it asks you for more settings, such as creating a shortcut on the desktop and enabling Automatically start the app. You can choose the options you want and click Next.
  • Now just click Install to start installing the program.
  • In this way, the program starts to install.
  • At the end of the installation, the following window will appear, click Finish.
  • Now the program is running. If it does not run, run its shortcut on the desktop.

  • The first time it will ask you for your language and location settings. Click on Language to change the language and click on Region to change the region and choose the options you want and run the program.

  • Enable Analytics help us collect data to improve the app

  • In the next step, the program will open.

  • The next time you run the program, you will always face this page and the previous steps will not be needed.

Note: As you know, Windows 7 is no longer supported by Microsoft. Therefore, you may encounter problems when installing this program on Windows 7. It is possible that your problem will be solved by installing this package, but if you still could not install the program, we recommend using Windows 10 with 64-bit architecture.


Install on Mac (click)
  • First, download the program from here.

  • Then find the downloaded file in Downloads and open it.

Downloaded_App

  • Now program the file and drop it in Applications. With this, the application file will be transferred to the Applications section.
drag_app
  • Now the program is permanently copied to the Applications. Double click on it to run.
  • This message is given the first time you open the app because it was downloaded from a source other than the App Store.
Cannot open
  • Go to the Security and Privacy section and click Open Anyway in the General tab.
open for ever
  • Now click on Open.
open for ever
  • Go to the Applications section again and open the program easily.
  • The first time it will ask you for your language and location settings. Click on Language to change the language and click on Region to change the region and choose the options you want and run the program.
  • Enable Analytics help us collect data to improve the app

  • The program opens like this.

Screen Shot 1402-07-10 at 20 26 48
  • From now on, you can easily run the program in the Applications section.

Install on Linux (click)
  • First, download the program from here.
  • Extract the downloaded file from the compressed mode and then check with the following command that it has access to execute.

Assume that the downloaded file is in Downloads in the Home folder, so run the following command.

ls -la ~/Downloads/hiddify-linux-x64.AppImage
  • If the output was as follows,

rwxr-xr-x 1 user user 26272960 Sep 30 07:55 ~/Downloads/hiddify-linux-x64.AppImage

It means that it has x or executable permission and you can run it easily. Otherwise, you can run the following command in the terminal to add executive access.

  • Now just run the file.
  • The first time it will ask you for your language and location settings. Click on Language to change the language and click on Region to change the region and choose the options you want and run the program.
  • Enable Analytics help us collect data to improve the app

Adding a profile to the app

  • First, open the link related to your user in the panel.
  • The following page is visible. By clicking on Tap to Start Anti-Filter, the link related to your profile will be loaded in the app.
  • If profile link is not added automatically, this page will open. Just click on Copy Link to copy the profile link.
  • Now enter the program and tap on the + button on the top left on the Home menu, so that the page of adding a new profile appears.
  • You can add the copied link in two ways on this page.

Method 1: Click Add from clipboard. The copied link will be added automatically.

Method 2: Click on Add manually, on the next page enter a desired name in the Name field and copy the link in the URL field. Then hit the Save button.

Add single configs

  • For this, go to the user page and click on All Configs.
  • In the displayed list, select the single config you want.
  • Click Copy to copy the config.
  • Enter the program and click the `+' button.
  • Tap Add from clipboard.
  • The config is added to the program.

Working with the app

Connect to the VPN

  • When the profile is added, you will see this on the Home page.
  • Just click on the connection button in the middle of the screen to connect the VPN.
  • If you need to update your profile, click on this button.
  • If you need to change the profile, click on the profile section and select the desired profile from the opened list.
  • In this section you can edit profiles.

Checking and testing proxies

  • To view the proxies, first connect the VPN. Then go to the Proxies menu.
  • On this page, the proxies or configs related to the profile, are displayed or you can see the individual configs added to the software.

  • The VPN automatically connects to the best proxy based on the test, but you can also choose the desired proxy manually.

  • Along with these proxies, their delay is also displayed.

  • If you need to test the delay, you should click on its button at the bottom right.

  • You can sort the proxies by name or test result with the upper right button.

General settings

  • In the Settings menu, you can see the General settings.
General-settings
  • You can change the language of the software using the Language menu.
  • By using Theme Mode you can choose your desired theme from dark, light or device mode.
  • The Pure Black button makes the device theme deeply black.
  • The Start on Boot button is used to run the program when the operating system starts up for the first time.
  • The Silent Start button causes a window not to be displayed when the software is running, and the software is only displayed in the bottom toolbar after execution.

Advanced settings

Enabling TUN

  • To activate the tunnel, you must first open the program with admin or root access. This work is different according to different operating systems.

Opening the app with admin privilege on Windows - If the program was previously open with non-admin privilege, close the program. That is, right-click on the program icon in the lower toolbar and click `Exit`. - Now, on the desktop or in the list of `Start` programs, right-click on the program icon and click `Run as administrator`.
Run ad admin
  • The program opens with admin privilege.

Opening the app with admin privilege on Mac
  • If the program was previously open with non-admin access, close the program. That is, right-click on the program icon in the upper toolbar and click Exit.
  • Open the terminal.
  • Now go to Applications. Right click on the program icon and click Show contents.
  • Go into the MacOS folder and grab the HiddifyNext file and drop it on the terminal. With this, the address of this file will be placed in the terminal.
  • Press ctrl+a to go to the start of the line in terminal. Now type sudo. For example, you will have

sudo \Applications\HiddifyNext.app\Contents\MacOS\HiddifyNext

  • Now press Enter to run the program with admin privilege.

Opening the app with root privilege on Linux
  • If the program was previously open with non-admin access, close the program. That is, right-click on the program icon in the toolbar and click Exit.
  • Now open the terminal and if, for example, the program is in the Downloads folder in Home, then execute the following command to run the program with root privilege.
sudo ~/Downloads/hiddify-linux-x64.AppImage

Note: If the program is in a different path, change the above command accordingly.


  • Now that the program is opened with admin or root access level, just go to the Settings menu.
  • Enter the Config Options in the Advanced section.
  • Turn on Enable TUN button.
advanced-setting
  • Now go to the Home menu and tap the Connect button until it turns green.
⚠️ **GitHub.com Fallback** ⚠️