# Glance Dashboard Configuration

Конфигурация для [Glance](https://github.com/glanceapp/glance) - минималистичного дашборда для самостоятельного хостинга.

## 📁 Структура проекта

```
glance/
├── home.yml                      # Главный файл конфигурации
├── widgets/                      # Отдельные виджеты (модульная структура)
│   ├── bookmarks-general.yml     # Общие закладки (Личное)
│   ├── bookmarks-homelab.yml     # Закладки Homelab (Администрирование)
│   ├── countdown.yml             # Виджет обратного отсчета
│   ├── qbittorrent.yml           # Виджет qBittorrent
│   └── ...                       # Другие виджеты
├── upload-glance-config.ps1      # PowerShell скрипт для загрузки (Windows)
├── upload-glance-config.sh       # Shell скрипт для загрузки (Linux/macOS)
└── README.md                     # Этот файл
```

## 🚀 Установка и настройка

### Требования

**Для Windows:**
- PowerShell 5.1+ (предустановлен в Windows 10/11)
- Установленный OpenSSH Client (обычно предустановлен в Windows 10/11)
  - Проверить: `ssh -V`

**Для Linux/macOS:**
- `bash`
- `ssh` и `scp`

## 📤 Загрузка конфигурации на сервер

### Windows (PowerShell)

Скрипт использует нативный OpenSSH клиент в Windows.

```powershell
# Запуск из директории репозитория (параметры по умолчанию)
.\upload-glance-config.ps1

# С указанием хоста
.\upload-glance-config.ps1 -RemoteHost "192.168.50.114"

# Полная версия (если запускаете из другой папки)
.\upload-glance-config.ps1 -LocalDir "e:\repos\glance" -User "root" -RemoteHost "192.168.50.114"
```

### Linux/macOS (Bash)

```bash
# Добавьте права на выполнение
chmod +x upload-glance-config.sh

# Запуск
./upload-glance-config.sh
```

## ⚙️ Параметры скрипта (PowerShell)

| Параметр | Описание | Значение по умолчанию |
|----------|----------|----------------------|
| `LocalDir` | Локальная директория с конфигурацией | `.` (Текущая директория) |
| `User` | Пользователь SSH | `root` |
| `RemoteHost` | IP адрес или hostname сервера | `192.168.50.114` |

## 📋 Что делает скрипт

1. **Загружает `home.yml`** → `/opt/glance/config/glance.yml` на сервере.
2. **Синхронизирует директорию `widgets/`** → `/opt/glance/config/widgets/` на сервере.
3. **Автоматически создает** необходимые директории на сервере.

> Glance автоматически перезагружает конфигурацию при обнаружении изменений.

## 🎨 Модульная структура виджетов

Конфигурация использует функцию `include` для организации виджетов:

```yaml
# В home.yml
pages:
  - name: Главная
    columns:
      - size: full
        widgets:
          - type: include
            path: widgets/bookmarks-homelab.yml
```

Это позволяет разделять конфигурацию на логические блоки (например, `bookmarks-general.yml` и `bookmarks-homelab.yml`).

## 🔧 Настройка SSH ключей (рекомендуется)

Для автоматической загрузки без ввода пароля настройте SSH ключи:

```powershell
# Windows / Linux / macOS
# 1. Генерируем ключ (если нет)
ssh-keygen -t ed25519 -C "glance-config"

# 2. Копируем на сервер
# Windows (PowerShell):
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh root@192.168.50.114 "cat >> .ssh/authorized_keys"

# Linux/macOS:
ssh-copy-id root@192.168.50.114
```

## 📚 Полезные ссылки

- [Glance Documentation](https://github.com/glanceapp/glance)
- [Glance Configuration Examples](https://github.com/glanceapp/glance/blob/main/docs/configuration.md)