Video DownloadHelper nie widzi innych ścieżek zapisu – Firefox, Chrome, Companion App, konfiguracja

Pytanie

dlaczego video downloadhelper nie widzi innych ścieżek zapisu

Odpowiedź Sztucznej Inteligencji

Bezpośrednia odpowiedź na pytanie

• Najczęstsza przyczyna: dodatek działa w trybie „przeglądarkowym” i z powodu ograniczeń WebExtensions może zapisywać tylko do folderu Pobrane (lub jego podkatalogów).
• Aby widzieć/wybierać dowolne ścieżki, Video DownloadHelper musi używać Aplikacji Towarzyszącej (Companion App, vdhcoapp) oraz mieć poprawnie skonfigurowane „Destinations”; dodatkowo system musi zezwolić na zapis do wybranego katalogu.

Kluczowe punkty:

• Ograniczenia API przeglądarki (sandbox) → brak swobodnego dostępu do systemu plików.
• Brak lub nieaktywny vdhcoapp → brak wyboru dowolnych ścieżek.
• Zła konfiguracja „Download mode/Processor” i „Destinations”.
• Uprawnienia systemowe/antywirus/zasady firmowe blokują zapis poza Pobrane.
• Nieistniejąca/niemontowana ścieżka (dysk zewnętrzny, udział sieciowy) lub brak praw do folderu.

Szczegółowa analiza problemu

• Architektura: Rozszerzenia oparte na WebExtensions (Firefox, Chrome/Edge) korzystają z downloads API, które pozwala wskazać nazwę pliku relatywnie do katalogu pobierania przeglądarki. Z przyczyn bezpieczeństwa nie wolno im samodzielnie zapisywać w dowolnej, absolutnej ścieżce.
• Rola Companion App (vdhcoapp): To natywna aplikacja uruchamiana z rozszerzenia przez Native Messaging. Działa poza sandboxem, ma zwykłe uprawnienia procesu użytkownika i potrafi zapisywać w dowolnym miejscu, składać strumienie (DASH/HLS), używać ffmpeg itd. Bez niej VDH „nie widzi” innych ścieżek (albo pokazuje tylko domyślną).
• Tryb pobierania:
  • „Browser/Native (przeglądarka)”: zapis ograniczony do Pobrane.
  • „CoApp/Companion App”: pełny wybór katalogów (o ile system pozwala).
• „Destinations”: Menedżer miejsc docelowych w VDH. Jeśli nie jest skonfigurowany, dodatek używa jednego miejsca. Po włączeniu CoApp można dodać dowolne foldery, reguły i ustawić domyślny katalog.
• Specyfika przeglądarek:
  • Firefox: elastyczniejszy (może pytać o lokalizację dla każdego pobierania; VDH dobrze współpracuje z CoApp).
  • Chrome/Edge (Chromium): bardziej restrykcyjne; jeśli „Download mode” = Browser, trafia do Pobrane niezależnie od VDH. Trzeba wymusić CoApp.
• System operacyjny i polityki:
  • Windows: „Controlled folder access” (Defender) potrafi blokować zapis do Dokumenty/Pulpit/D, trzeba dodać wyjątek dla vdhcoapp. Również uprawnienia NTFS mogą ograniczać zapis.
  • macOS: od 10.15 wzwyż wymagane uprawnienia do „Pełnego dostępu do dysku” dla aplikacji zapisujących poza standardowymi lokalizacjami; vdhcoapp może wymagać zgody w Prywatność i Bezpieczeństwo.
  • Linux: prawa do folderu/montażu (np. dysk NTFS montowany tylko do odczytu), AppArmor/SELinux mogą ograniczać dostęp.
• Ścieżki zewnętrzne/udostępnione: Dysk USB/SMB musi być zamontowany i dostępny pod stałą ścieżką; zmienione litery dysków w Windows (np. D: → E:) powodują, że zapisana w „Destinations” ścieżka przestaje istnieć.
• Inne czynniki:
  • Jeśli używasz konwersji/łączenia wideo i systemowego ffmpeg, to on może wymagać obecności w PATH, ale sam wybór ścieżki zapisu przez VDH od PATH nie zależy.
  • Zasady zarządzania (urządzenie firmowe): polityki przeglądarki mogą wymuszać konkretny folder pobrań i blokować pytanie o lokalizację.

Aktualne informacje i trendy

• Model bezpieczeństwa przeglądarek wciąż konsekwentnie ogranicza rozszerzenia, więc „gołe” WebExtensions nie uzyskają dostępu do dowolnych ścieżek.
• VDH utrzymuje architekturę hybrydową (rozszerzenie + vdhcoapp) – to obecnie standard w dodatkach wymagających zapisu poza Pobrane i obsługi złożonych strumieni (DASH/HLS/MPEG-TS).
• Systemy operacyjne zaostrzają polityki dostępu do plików (Windows Defender, macOS TCC), więc poprawne nadanie uprawnień natywnym komponentom staje się kluczowe.

Wspierające wyjaśnienia i detale

• Downloads API pozwala podać „filename”: „podkatalog/nazwa.mp4”, ale to nadal zapis wewnątrz katalogu pobierania. Próba narzucenia „D:\Filmy...” jest odrzucana lub ucinana do dozwolonej części.
• VDH w trybie CoApp przesyła strumień/URL do vdhcoapp, który sam tworzy plik w wybranym katalogu. Tu właśnie pojawia się możliwość wskazania dowolnej ścieżki oraz zastosowania reguł „Destinations” (np. per domena, per typ mediów).

Aspekty etyczne i prawne

• Upewnij się, że masz prawo do pobierania danej treści. Materiały chronione prawem autorskim, sygnały z DRM (Widevine/EME) i treści płatne mogą być prawnie i technicznie chronione przed zapisem.

Praktyczne wskazówki

1. Sprawdź status Companion App:
   • Otwórz ustawienia VDH → Companion App/CoApp → powinno być „zainstalowana/wykryta”. W razie braku – zainstaluj i uruchom ponownie przeglądarkę.
2. Wymuś użycie CoApp do pobierania:
   • VDH → Options/Preferences → Download/Behavior → Download mode/Processor = „CoApp/Companion App”.
3. Skonfiguruj „Destinations”:
   • VDH → Destinations → Dodaj katalog (np. D:\Multimedia\VDH) → Ustaw jako domyślny.
   • Opcjonalnie dodaj reguły (np. dla konkretnej domeny lub typu pliku).
4. Ustawienia przeglądarki (dla ręcznego wyboru):
   • Firefox: Ustawienia → Ogólne → Pliki i aplikacje → „Zawsze pytaj, gdzie zapisać pliki”.
   • Chrome/Edge: Ustawienia → Pobrane → „Pytaj, gdzie zapisywać każdy plik przed pobraniem”.
     Uwaga: to dotyczy pobierania „przez przeglądarkę”; dla pełnej swobody i tak użyj CoApp.
5. Uprawnienia systemu:
   • Windows: Dodaj vdhcoapp do wyjątków „Controlled folder access” lub wyłącz tę funkcję dla testu; sprawdź prawa NTFS do folderu docelowego.
   • macOS: Preferencje systemowe → Prywatność i bezpieczeństwo → Pełny dostęp do dysku → dodaj vdhcoapp/VDH.
   • Linux: upewnij się, że punkt montowania ma prawa zapisu dla Twojego UID; sprawdź, czy dysk/udział jest zamontowany.
6. Walidacja:
   • Włącz logowanie w VDH (Debug/Logs) i sprawdź, czy nie pojawia się błąd typu EACCES/EPERM/ENOENT (brak uprawnień/ścieżka nie istnieje).
   • Przetestuj zapisem do prostego katalogu bez spacji i z polskimi znakami (czasem problemem bywa normalizacja ścieżek).

Ewentualne zastrzeżenia lub uwagi dodatkowe

• Jeśli w VDH jest ustawiony tryb „Browser”, nawet poprawnie skonfigurowane „Destinations” nie zadziałają tak, jak oczekujesz.
• Dyski zewnętrzne/udziały sieciowe potrafią zmieniać literę/mount point po restarcie – VDH nie „zobaczy” starej ścieżki, jeśli już nie istnieje.
• PATH środowiskowy ma znaczenie tylko wtedy, gdy chcesz używać systemowego ffmpeg; nie wpływa na samą zdolność wyboru katalogu zapisu w VDH.
• Treści z DRM zwykle nie są obsługiwane – brak możliwości zapisu nie wynika wtedy z „ścieżek”, tylko z ochrony treści.

Sugestie dalszych badań

• Sprawdź dokumentację/FAQ Video DownloadHelper dotyczące Companion App i sekcji „Destinations”.
• Fora wsparcia Firefox/Chrome i repozytorium dyskusji VDH (aclap-dev) – typowe przypadki błędów EACCES i konfiguracji CoApp.
• Alternatywy do testów: yt-dlp (z GUI) lub JDownloader – pomogą sprawdzić, czy problem to VDH, czy ogólnie uprawnienia systemu.

Krótkie podsumowanie

Problem wynika głównie z ograniczeń bezpieczeństwa przeglądarki: bez Companion App VDH nie ma prawa zapisu poza folder Pobrane. Zainstaluj i włącz CoApp, przełącz „Download mode/Processor” na CoApp, skonfiguruj „Destinations”, a następnie upewnij się, że system i ewentualny antywirus pozwalają vdhcoapp pisać do wybranego katalogu. Jeśli podasz przeglądarkę, system oraz to, co obecnie widzisz w „Companion App/Download mode”, przygotuję dokładną checklistę dla Twojej konfiguracji.