SwitchHosts README

The project's README from github.com/oldj/SwitchHosts. As one markdown file: README.md.

Special thanks to:
Warp sponsorship

Warp, the intelligent terminal for developers

Available for MacOS, Linux, & Windows


SwitchHosts

Homepage: https://switchhosts.vercel.app

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

Screenshot

SwitchHosts screenshot

Features

Install

Download

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

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). In the v5 data layout:

For a complete manual backup, copy the whole ~/.SwitchHosts folder. The in-app export creates a hosts data backup JSON; it does not include preferences or histories.

Develop and build

Prerequisites

Development

Build and package

# development
npm run tauri:dev

# production build
npm run tauri:build

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

SwitchHosts (oldj/SwitchHosts)

Searching Database…

Что это такое?SwitchHosts — это бесплатное настольное приложение с открытым исходным кодом для управления файлом hosts: можно хранить несколько профилей hosts и переключаться между ними одним щелчком из главного окна или системного трея.
Это настольное приложение или библиотека, которую нужно добавить в мой проект?Отдельное настольное приложение, созданное на Tauri с интерфейсом на React, Jotai и Mantine — оно сидит в системном трее и управляет системным файлом hosts. В проект ничего добавлять не нужно.
Нужно ли мне что-то ещё на компьютере, чтобы оно работало?Ничего лишнего — скачанное приложение полностью самодостаточно. Node.js, Rust и системные зависимости Tauri нужны только для сборки из исходников.
Если я экспортирую свои данные hosts, в экспорт попадёт всё?Нет — встроенный экспорт содержит данные hosts в JSON без настроек и истории. Для полной резервной копии скопируйте всю папку ~/.SwitchHosts.
На каких системах я могу её запускать?Windows, macOS и Linux — из единой кодовой базы Tauri; сборки лежат на странице GitHub releases, для Windows есть пакет в Chocolatey.
Где SwitchHosts хранит мои данные hosts?Локально, в ~/.SwitchHosts (папка .SwitchHosts в домашней папке пользователя на Windows): manifest.json — дерево hosts, entries/ — содержимое, trashcan.json — удалённые записи.
Пользоваться ею можно бесплатно?Да — это бесплатное программное обеспечение с открытым исходным кодом, распространяемое по лицензии Apache 2.0.
Что она умеет помимо включения и выключения профилей?Довольно много: подсветку синтаксиса для файлов hosts, поиск и замену по всем записям, удалённые hosts с обновлением вручную или по расписанию, импорт и экспорт, включая резервные копии по URL, корзину с восстановлением и локальный HTTP API.
Каково это — редактировать файл hosts внутри неё?Как в редакторе кода: у записей hosts есть подсветка синтаксиса и поиск с заменой, всё это работает на CodeMirror, который входит в зависимости приложения.
Можно ли её автоматизировать, например запускать переключения из скрипта?В настройках есть локальный HTTP API и команды, выполняемые после применения, так что можно открыть HTTP-эндпоинт и запускать команды после того, как записи hosts применены.
Почему для сборки нужен Rust, если приложение написано на TypeScript?Интерфейс написан на TypeScript/React, но настольная оболочка — это Tauri, чей нативный бэкенд — код на Rust в src-tauri, поэтому Node.js и Rust оба нужны для сборки.
Creator
oldj
Size
36.5 MB
Stars
27.3K
Age
15y
Commits · 90 Days