Установка¶
HistorySync работает на Windows, macOS и Linux. Выберите наиболее подходящий вам способ.
Готовые Пакеты (Рекомендуется)¶
Загрузите последний выпуск со страницы GitHub Releases.
| Пакет | Примечания |
|---|---|
HistorySync-vX.Y.Z-windows-x64-setup.exe |
Полный установщик, добавляет запись в меню «Пуск» и опциональный автозапуск |
HistorySync-vX.Y.Z-windows-x64-portable.zip |
Портативная версия — распакуйте и запускайте откуда угодно, установка не требуется |
Запустите установщик и следуйте инструкциям на экране. Дополнительные зависимости не требуются.
| Пакет | Примечания |
|---|---|
HistorySync-vX.Y.Z-macos-arm64.dmg |
Установка перетаскиванием |
- Откройте файл
.dmg. - Перетащите HistorySync в папку
Applications. - При первом запуске macOS может показать запрос безопасности — нажмите Открыть, чтобы продолжить.
Разрешение на доступ к специальным возможностям
Глобальное сочетание клавиш Ctrl+Shift+H требует разрешения Специальные возможности. macOS запросит его при первом использовании. Предоставьте доступ в Системных настройках → Конфиденциальность и безопасность → Специальные возможности.
| Пакет | Примечания |
|---|---|
HistorySync-vX.Y.Z-linux-x86_64.AppImage |
Работает на любом современном дистрибутиве Linux |
HistorySync-vX.Y.Z-linux-x86_64.tar.gz |
Универсальный tar-архив для любого дистрибутива Linux |
historysync_X.Y.Z_amd64.deb |
Для дистрибутивов на базе Debian/Ubuntu |
AppImage:
Debian/Ubuntu .deb:
Глобальные сочетания клавиш на Linux/Wayland
Глобальные сочетания клавиш через pynput не поддерживаются на Wayland. Сочетание Ctrl+Shift+H для открытия наложения не будет работать в сессии Wayland. В качестве обходного решения используйте --quick с системным сочетанием клавиш (см. Сочетания клавиш).
Установка из Исходного Кода¶
Используйте этот метод, если хотите запустить последнюю версию кода разработки или внести вклад в проект.
Требования¶
- Python 3.10+ (рекомендуется Python 3.12 — соответствует CI)
- Git
Шаги¶
# 1. Клонировать репозиторий
git clone https://github.com/TheSkyC/HistorySync.git
cd HistorySync
# 2. Создать и активировать виртуальное окружение (настоятельно рекомендуется)
python -m venv venv
# Windows
.\venv\Scripts\activate
# macOS / Linux
source venv/bin/activate
# 3. Установить зависимости времени выполнения
pip install -r requirements.txt
# 4. Запустить приложение
python -m src.main
Установка CLI hsync (необязательно)¶
Готовые бинарные файлы hsync доступны на странице GitHub Releases:
| Пакет | Платформа |
|---|---|
hsync-vX.Y.Z-windows-x64-setup.exe |
Установщик Windows |
hsync-vX.Y.Z-windows-x64.zip |
Windows портативная версия |
hsync-vX.Y.Z-macos-arm64.tar.gz |
macOS (Apple Silicon) |
hsync-vX.Y.Z-linux-x86_64.tar.gz |
Linux x86-64 |
Также интерфейс командной строки без GUI можно вызывать напрямую через Python:
Чтобы установить его как команду hsync в PATH:
# Создать простой скрипт-обёртку (Linux / macOS)
echo '#!/bin/sh\npython -m src.cli "$@"' > /usr/local/bin/hsync
chmod +x /usr/local/bin/hsync
Проверка Установки¶
Запустите GUI и проверьте номер версии в строке заголовка, или выполните:
# GUI
python -m src.main --version
# CLI
python -m src.cli --version
# или если установлено:
hsync --version
Обновление¶
Замените существующий бинарный файл новым со страницы Releases. HistorySync хранит конфигурацию и базу данных отдельно от бинарного файла приложения, поэтому обновление никогда не затрагивает ваши данные.
Расположение данных по умолчанию:
| Платформа | Директория |
|---|---|
| Windows | %APPDATA%\HistorySync\ |
| macOS | ~/Library/Application Support/HistorySync/ |
| Linux | ~/.config/HistorySync/ |
Вы можете переопределить это с помощью --config-dir или использовать режим --portable для хранения всех данных рядом с исполняемым файлом.
Удаление¶
- Удалите бинарный файл приложения / AppImage / пакет.
- При желании удалите директорию данных, указанную выше, чтобы стереть все данные браузера и настройки.
Warning
Удаление директории данных необратимо. Сначала создайте резервную копию базы данных, если хотите сохранить историю.