192 lines
13 KiB
Markdown
192 lines
13 KiB
Markdown
# Rclone UI Manager
|
||
|
||
Кроссплатформенный графический интерфейс для [rclone](https://rclone.org/), написанный на Rust с использованием [egui](https://github.com/emilk/egui). Приложение предоставляет удобный способ управления облачными хранилищами (Google Drive, Dropbox, S3 и др.) и локальными файлами, поддерживает копирование, перемещение, удаление и синхронизацию с отображением хода выполнения операций.
|
||
|
||
|
||
|
||
## Возможности
|
||
|
||
- **Автоматическая установка rclone** – обнаруживает системный rclone или загружает последнюю версию автоматически.
|
||
- **Управление удалёнными хранилищами (remotes)** – просмотр, создание, проверка, удаление и просмотр информации обо всех подключениях rclone.
|
||
- **Создание хранилищ через GUI** – мастер добавления с пошаговыми вопросами rclone (`--non-interactive`): укажите имя и тип, а для облаков с авторизацией (Google Drive, Dropbox и др.) автоматически откроется браузер для входа в аккаунт (OAuth).
|
||
- **Контекстное меню хранилищ** – по правой кнопке мыши: открыть, проверить доступность, посмотреть использование (объём/число файлов), удалить с подтверждением.
|
||
- **Локальный файловый менеджер** – навигация по локальной файловой системе, выбор папок назначения.
|
||
- **Основные файловые операции**:
|
||
- Копирование / Перемещение / Удаление нескольких файлов или папок.
|
||
- Рекурсивная обработка директорий.
|
||
- **Фоновые задачи** – асинхронные операции с индикаторами прогресса и статусом выполнения.
|
||
- **История навигации** – кнопки «Назад» / «Вперёд» для быстрого перемещения.
|
||
- **Пользовательские шрифты** – поддержка Sans.otf и NotoColorEmoji.ttf для улучшенного внешнего вида (опционально).
|
||
- **Кроссплатформенность** – работает на Windows, macOS и Linux.
|
||
|
||
## Системные требования
|
||
|
||
- **Rust** (при сборке из исходников) – стабильный инструментарий.
|
||
- **Cargo** – входит в состав Rust.
|
||
- **Операционная система** – Windows 10/11, macOS 10.15+ или современный дистрибутив Linux.
|
||
- **rclone** – не требуется, приложение загрузит его при необходимости.
|
||
|
||
## Установка
|
||
|
||
### Готовые сборки (пока не предоставляются)
|
||
|
||
В будущих релизах могут быть добавлены исполняемые файлы. Пока что собирайте из исходников.
|
||
|
||
### Сборка из исходников
|
||
|
||
1. Клонируйте репозиторий:
|
||
```bash
|
||
git clone https://github.com/yourusername/rclone-ui-manager.git
|
||
cd rclone-ui-manager
|
||
```
|
||
|
||
2. (Опционально) Поместите пользовательские шрифты в папку `assets/fonts/`:
|
||
- `Sans.otf`
|
||
- `NotoColorEmoji.ttf`
|
||
|
||
3. Соберите и запустите:
|
||
```bash
|
||
cargo run --release
|
||
```
|
||
|
||
Первый запуск может занять некоторое время из-за компиляции зависимостей. Исполняемый файл появится в `target/release/rclone-ui-manager` (или `rclone-ui-manager.exe` на Windows).
|
||
|
||
### Зависимости для Linux
|
||
|
||
На Linux могут потребоваться следующие системные библиотеки:
|
||
|
||
```bash
|
||
# Ubuntu / Debian
|
||
sudo apt install libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev libwayland-dev pkg-config
|
||
|
||
# Fedora
|
||
sudo dnf install libX11-devel libXrandr-devel libXinerama-devel libXcursor-devel libXi-devel wayland-devel pkgconf
|
||
```
|
||
|
||
## Использование
|
||
|
||
1. Запустите приложение.
|
||
2. На левой боковой панели отобразится список ваших rclone remote. Чтобы добавить новое хранилище, нажмите кнопку **«➕ Добавить облако»** и заполните мастер:
|
||
- **Имя** – например, `mydrive`.
|
||
- **Тип** – например, `drive`, `dropbox`, `s3`, `webdav`.
|
||
- Если выбранный тип требует авторизации (OAuth), после нажатия «Создать» автоматически откроется браузер для входа в аккаунт. При необходимости rclone задаст дополнительные вопросы (например, о Team Drive) – ответьте в окне мастера.
|
||
3. Нажмите на имя remote **левой кнопкой мыши**, чтобы просмотреть его содержимое.
|
||
4. **Правая кнопка мыши** по хранилищу открывает контекстное меню:
|
||
- **📂 Открыть** – перейти в хранилище.
|
||
- **🔍 Проверить доступность** – проверить подключение.
|
||
- **📊 Использование** – показать общий объём, занятое и свободное место, число файлов.
|
||
- **🗑️ Удалить** – удалить хранилище из конфигурации rclone (файлы в облаке при этом не удаляются; требуется подтверждение).
|
||
5. Выберите файлы/папки, щёлкая по их иконке (📁 или 📄). Можно выбирать несколько элементов.
|
||
6. После выбора внизу появятся кнопки: **Копировать**, **Переместить**, **Удалить**.
|
||
7. Для копирования/перемещения укажите путь назначения:
|
||
- **Облако** – введите путь в формате rclone (например, `gdrive:/backup`).
|
||
- **ПК** – выберите локальную папку через встроенный файловый браузер или введите путь вручную.
|
||
8. Нажмите **Начать** – операция запустится в фоне. Прогресс отображается на правой панели.
|
||
|
||
### Навигация
|
||
|
||
- **⬅ / ➡** – переход назад / вперёд по истории.
|
||
- **🔄** – обновить текущую директорию.
|
||
- **📁 .. (Вверх)** – подняться на уровень выше.
|
||
- **Правая кнопка мыши по хранилищу** – контекстное меню хранилища.
|
||
|
||
### Обработка ошибок
|
||
|
||
Сообщения об ошибках появляются во всплывающих окнах. Активные задачи перечислены на правой панели. Вы можете закрыть приложение, пока операции выполняются (они запускаются в отдельных потоках).
|
||
|
||
## Конфигурация
|
||
|
||
Приложение хранит настройки в стандартной пользовательской папке данных:
|
||
- Windows: `%APPDATA%\rclone-ui\`
|
||
- macOS: `~/Library/Application Support/rclone-ui/`
|
||
- Linux: `~/.local/share/rclone-ui/`
|
||
|
||
Сейчас в `AppSettings` хранятся только некоторые параметры (показ скрытых файлов, ограничение скорости). В будущих версиях они будут доступны через интерфейс.
|
||
|
||
## Разработка
|
||
|
||
### Структура проекта
|
||
|
||
```
|
||
src/
|
||
├── main.rs # Точка входа, загрузка шрифтов
|
||
├── ui.rs # Состояние UI и типы
|
||
├── ui/
|
||
│ ├── app.rs # Реализация egui::App
|
||
│ └── rcloneui.rs # Логика UI, фоновые задачи
|
||
├── operations/
|
||
│ ├── files.rs # Обёртка над rclone lsjson / about
|
||
│ ├── sync.rs # copy/move/delete/purge
|
||
│ ├── remotes.rs # list/get/check, интерактивное создание (config create --non-interactive)
|
||
│ ├── local_fs.rs # Чтение локальных директорий
|
||
│ ├── fileinfo.rs # Вспомогательные методы FileInfo
|
||
│ └── ... # info, search, check
|
||
└── rclone_install/
|
||
├── mod.rs # Определение RcloneApp
|
||
└── rclone_install_real.rs # Обнаружение и загрузка rclone
|
||
```
|
||
|
||
### Добавление новых функций
|
||
|
||
- **Новые операции с remotes** – расширяйте `operations/remotes.rs`.
|
||
- **Дополнительные команды файловых операций** – реализуйте в `operations/sync.rs` и вызывайте из `RcloneUI`.
|
||
- **Новые панели UI** – используйте `egui::SidePanel`, `CentralPanel` или `Window`.
|
||
|
||
### Тестирование
|
||
|
||
Запуск всех тестов:
|
||
|
||
```bash
|
||
cargo test
|
||
```
|
||
|
||
Некоторые тесты помечены как `ignore` (например, реальная загрузка rclone) – запустите их командой `cargo test -- --ignored`.
|
||
|
||
## Устранение неполадок
|
||
|
||
### «Rclone not found» / ошибка установки
|
||
|
||
- Проверьте интернет-соединение – приложение скачивает rclone с GitHub.
|
||
- На Linux убедитесь, что установлен `unzip` (хотя crate `zip` не требует его, но для ручной проверки может понадобиться).
|
||
- При работе через корпоративный прокси установите переменные окружения `HTTP_PROXY` и `HTTPS_PROXY`.
|
||
|
||
### Отсутствие шрифтов
|
||
|
||
Приложение нормально работает со стандартными системными шрифтами. Поместите файлы шрифтов в `assets/fonts/`, чтобы изменить внешний вид.
|
||
|
||
### Ошибки компиляции на Linux
|
||
|
||
Установите все необходимые пакеты для разработки X11 (см. раздел «Зависимости для Linux»).
|
||
|
||
### Приложение не показывает локальные директории на Windows
|
||
|
||
Локальный браузер по умолчанию открывает `C:\`. Чтобы перейти на другой диск, введите путь вручную (например, `D:\`) в поле назначения.
|
||
|
||
## Планы на будущее
|
||
|
||
- [ ] Графическое изменение конфигурации существующих remote.
|
||
- [ ] Предварительный просмотр синхронизации (dry-run со списком файлов).
|
||
- [ ] Ползунок ограничения скорости.
|
||
- [ ] Поиск файлов по имени/пути.
|
||
- [ ] Поддержка фильтров rclone (`--include`, `--exclude`).
|
||
- [ ] Переключение светлой/тёмной темы.
|
||
|
||
## Лицензия
|
||
|
||
Проект лицензируется на условиях **MIT License** или **Apache License 2.0** на ваш выбор. Файл `LICENSE` будет добавлен позднее.
|
||
|
||
## Участие в разработке
|
||
|
||
Приветствуются любые вклады! Пожалуйста, создавайте issue или pull request. Соблюдайте существующий стиль кода и по возможности добавляйте тесты.
|
||
|
||
## Благодарности
|
||
|
||
- [rclone](https://rclone.org/) – основа всех операций с хранилищами.
|
||
- [egui](https://github.com/emilk/egui) – библиотека для мгновенного GUI.
|
||
- [tokio](https://tokio.rs/) – асинхронная среда выполнения для загрузки rclone.
|
||
- [dirs](https://crates.io/crates/dirs) – кросс-платформенное определение директорий.
|
||
|
||
---
|
||
|
||
**Наслаждайтесь удобным управлением вашими облачными файлами!**
|