========================================================================
   📥 MEDIA DOWNLOADER (macOS)
   YouTube • TikTok • Instagram • Twitter/X • Web
========================================================================

EASIEST 1-CLICK LAUNCH (NO GATEKEEPER PROMPTS):
------------------------------------------------------------------------
👉 Just double-click "Start_Media_Downloader.command"!
   It automatically clears macOS Gatekeeper quarantine and launches the app.

MANUAL OPEN / GATEKEEPER INSTRUCTIONS:
------------------------------------------------------------------------
1. UNZIP & OPEN:
   - Double-click "MediaDownloader-macOS.zip" to extract.
   - Double-click "Media_Downloader.app" to open.

2. IF MACOS SHOWS A SECURITY PROMPT ("Damaged" or "Unidentified Developer"):
   Because this app is independently developed and not from the App Store:
   METHOD A: Run "Start_Media_Downloader.command" (clears the quarantine flag).
   METHOD B: 
     a) Open "System Settings" ( menu -> System Settings).
     b) Go to "Privacy & Security" -> scroll to "Security".
     c) Click 👉 "Open Anyway" and confirm.
   METHOD C (Terminal):
     xattr -cr /path/to/Media_Downloader.app
   
   * Note: You only need to do this ONCE. Subsequent launches open instantly!

========================================================================
НАЙПРОСТІШИЙ ЗАПУСК В 1 КЛІК (БЕЗ ПОМИЛОК БЕЗПЕКИ):
------------------------------------------------------------------------
👉 Просто двічі клікніть на файл "Запустити_Завантажувач.command"!
   Він автоматично зніме обмеження macOS Gatekeeper та запустить додаток.

ЗВИЧАЙНИЙ ЗАПУСК / ЯКЩО З'ЯВИЛОСЯ ПОВІДОМЛЕННЯ MAC:
------------------------------------------------------------------------
1. РОЗПАКУЙТЕ ТА ВІДКРИЙТЕ:
   - Двічі клікніть на архів для розпакування.
   - Запустіть "Media_Downloader.app" (або "Завантажувач_Відео.app").

2. ЯКЩО З'ЯВИЛОСЯ "Програму пошкоджено" або "Невстановлений розробник":
   Оскільки додаток створено незалежним розробником (без щорічної платної підписки Apple):
   ВАРІАНТ 1: Запустіть файл "Запустити_Завантажувач.command" — він усе зробить автоматично.
   ВАРІАНТ 2: 
     a) Відкрийте "Системні параметри" ( -> Системні параметри).
     b) Розділ "Приватність і безпека" -> у самому низу в блоці "Безпека".
     c) Натисніть кнопку 👉 "Все одно відкрити" (Open Anyway) та підтвердіть "Відкрити".
   ВАРІАНТ 3 (через Термінал):
     xattr -cr ~/Downloads/Завантажувач_Відео.app

   * Примітка: Цю дію потрібно зробити лише 1 раз при першому завантаженні!
========================================================================
