<div align="center" markdown="1"> ^{Special thanks to:} <br> <a href="https://go.warp.dev/SwitchHosts"> <img alt="Warp sponsorship" width="400" src="https://github.com/user-attachments/assets/bb4a0222-12bf-4c79-bb80-a8ed4672b801" /> </a>

Warp, the intelligent terminal for developers

Available for MacOS, Linux, & Windows<br>

</div>

---

SwitchHosts

• Polski
• 简体中文
• 繁體中文

Homepage: https://switchhosts.vercel.app

SwitchHosts is an App for managing hosts file, it is based on Electron, React, Jotai, Mantine, etc.

Screenshot

<img src="https://raw.githubusercontent.com/oldj/SwitchHosts/master/screenshots/sh_light.png" alt="Capture" width="960">

Features

• Switch hosts quickly
• Syntax highlight
• Remote hosts
• Switch from system tray

Install

Download

You can download the source code and build it yourself, or download the built version from following links:

• SwitchHosts Download Page (GitHub release)

You can also install the built version using the package manager Chocolatey:

choco install switchhosts

Backup

SwitchHosts stores data at ~/.SwitchHosts (Or folder .SwitchHosts under the current user's home path on Windows), the ~/.SwitchHosts/data folder contains data, while the ~/.SwitchHosts/config folder contains various configuration information.

Develop and build

Development

• Install Node.js
• Change to the folder ./, run npm install to install dependented libraries
• Run npm run dev to start the development server
• Then run npm run start to start the app for developing or debuging

Build and package

• It is recommended to use electron-builder for packaging
• Go to the ./ folder
• Run npm run build
• Run npm run make, if everything goes well, the packaged files will be in the ./dist folder.
• This command may take several minutes to finish when you run it the first time, as it needs time to download dependent files. You can download the dependencies manually here, or Taobao mirror, then save the files to ~/.electron . You can check the Electron Docs for more infomation.

# build
npm run build

# make
npm run make # the packed files will be in ./dist

Copyright

SwitchHosts is a free and open source software, it is released under the Apache License.