Посібник користувача: Налаштування та запуск ClipFlow

Цей документ містить універсальну інструкцію зі створення єдиної конфігурації та запуску спільного буфера обміну для всіх підтримуваних платформ (Android / Desktop).

Крок 1: Створення конфігурації в Google Firebase

Вся інфраструктура ClipFlow працює на вашому особистому акаунті Google, що гарантує незалежність та безпеку даних.

  1. Перейдіть до консолі Firebase та увійдіть під своїм Google-акаунтом.
  2. Натисніть кнопку "Create a project" (Створити проект) і вкажіть назву проекту (наприклад, ClipFlow).
  3. У панелі керування створеного проекту натисніть на іконку Android, щоб додати програму.
  4. У полі "Android package name" обов'язково введіть такий ідентифікатор: com.clipflow.android
  5. Натисніть кнопку "Register app" (Зареєструвати програму) і завантажте отриманий конфігураційний файл: google-services.json.

Важливо: Цей файл є єдиним ключем для всієї вашої персональної мережі. Він використовується на всіх ваших пристроях, незалежно від того, Android це чи десктопна версія.

Крок 2: Налаштування автентифікації та правил бази даних Firebase

Перед використанням ClipFlow необхідно увімкнути анонімну автентифікацію та встановити правильні правила безпеки у Firebase.

  1. У консолі Firebase перейдіть до "Authentication" → "Sign-in method" та увімкніть провайдер "Anonymous" (Анонімний).
  2. Потім перейдіть до "Realtime Database" → "Rules" та замініть існуючі правила на наступні:
  3. { "rules": { ".read": "auth != null", ".write": "auth != null" } }
  4. Натисніть "Publish" (Опублікувати), щоб зберегти правила.

Важливо: Без цих кроків програма не зможе підключитися до бази даних. Правила гарантують, що лише автентифіковані користувачі (навіть анонімні) можуть читати та записувати дані.

Крок 3: Завантаження конфігурації в програму

Інструкція однакова для будь-якої платформи, на якій запущено ClipFlow.

  1. Відкрийте програму ClipFlow на вашому пристрої (смартфон або комп'ютер).
  2. Натисніть кнопку імпорту конфігурації та виберіть завантажений раніше файл google-services.json (або скопіюйте його текстові дані в поле введення).

Крок 4: Встановлення єдиного пароля шифрування

Безпека ClipFlow будується на базі наскрізного шифрування (E2EE), де пароль не передається в мережу, а зберігається тільки у вашій голові.

  1. У полі введення пароля наберіть свій секретний ключ.
  2. Головна умова: Цей пароль має бути абсолютно однаковим на всіх ваших пристроях (на Android та на ПК).
  3. Як це працює: З цього пароля локально генерується ключ шифрування AES-256-GCM. Якщо паролі на пристроях відрізнятимуться, вони фізично не зможуть розшифрувати дані один одного.

Крок 5: Активація спільного буфера обміну

  1. В інтерфейсі програми натисніть кнопку "Background Sync Start" (Запустити фонову синхронізацію).
  2. Система активна. Тепер будь-який текст, скопійований до буфера обміну на одному пристрої, автоматично та в зашифрованому вигляді передається на всі інші пристрої у вашій мережі.