WavesConverter
Dokumentacja
Wszystko co musisz wiedzieć — od instalacji po zaawansowane funkcje. Wybierz temat po lewej lub przewijaj od góry.
Instalacja
macOS 12 Monterey+
Pobierz plik .dmg, otwórz go i przeciągnij ikonę WavesConverter do folderu Applications. Przy pierwszym uruchomieniu kliknij prawym przyciskiem myszy ikonę → Otwórz → ponownie Otwórz w oknie Gatekeepera.
Windows 10+ (64-bit)
Pobierz plik .exe i uruchom instalator. Jeśli pojawi się niebieskie okno SmartScreen, kliknij Więcej informacji → Uruchom mimo to. Instalacja zajmuje kilka sekund.
Pobieranie filmów
Aby pobrać pojedynczy film z YouTube (lub publiczną treść z Instagram — patrz sekcja Instagram), wykonaj poniższe kroki:
Wklej URL — skopiuj link do filmu (youtube.com/watch, youtu.be lub Shorts) i naciśnij ⌘V (macOS) lub Ctrl+V (Windows). Możesz też użyć prefiksu wavesconverter:// przed linkiem (więcej). Link automatycznie pojawi się w polu i zacznie się pobieranie metadanych.
Kliknij Fetch — aplikacja pobierze tytuł, miniaturę i dostępne formaty z YouTube.
Wybierz format i jakość — przełącz między Video / Audio, wybierz format (MP4, MKV, MOV, WebM dla wideo; MP3, WAV, FLAC, M4A dla audio) oraz rozdzielczość lub bitrate.
Dodaj do kolejki — kliknij Add to Queue lub naciśnij ⌘D. Film trafi do zakładki Queue.
Start — przejdź do zakładki Queue i kliknij Start All lub Spacja. Obserwuj postęp i ETA.
WavesConverter obsługuje publiczne treści z Instagrama przez yt-dlp — tak samo jak YouTube: wklej link, Fetch, wybierz format i pobierz.
Obsługiwane typy
| Typ | Przykład URL | Uwagi |
|---|---|---|
| Reels | instagram.com/reel/… | Wideo — najczęstszy przypadek |
| Post (zdjęcie / wideo) | instagram.com/p/… | Pojedynczy post lub karuzela |
| IGTV | instagram.com/tv/… | Dłuższe wideo |
| Stories | instagram.com/stories/… | Nie działają bez cookies — ani publiczne, ani prywatne |
Skopiuj link z aplikacji Instagram (Udostępnij → Kopiuj link) i wklej w pole URL w zakładce Pobierz.
Fetch — aplikacja pobierze metadane. Dla karuzeli możesz wybrać konkretne media, jeśli yt-dlp zwróci wiele plików.
Format — wideo zapiszesz jako MP4 itd.; z postów ze zdjęciami często pobierane jest najlepsze dostępne wideo lub obraz.
Plik cookies — Stories i konta prywatne
Bez pliku cookies działa tylko publiczny content (posty, Reels). Stories w ogóle nie działają — ani publiczne, ani prywatne — dopóki nie wskażesz cookies.txt z zalogowanej sesji. Konta prywatne też wymagają cookies. W Ustawienia → Plik cookies (Instagram) wybierz plik wyeksportowany z przeglądarki (format Netscape, np. rozszerzenie „Get cookies.txt LOCALLY”). Zaloguj się na instagram.com w tej samej przeglądarce przed eksportem.
Pobieranie playlist
WavesConverter obsługuje pełne playlisty YouTube — możesz pobrać wszystkie filmy lub wybrać konkretne pozycje.
Wklej URL playlisty — link musi zawierać parametr list= (np. youtube.com/playlist?list=PL…). Naciśnij Fetch.
Wybierz pozycje — aplikacja wyświetli listę wszystkich filmów. Zaznacz lub odznacz poszczególne filmy. Przyciski All / None zaznaczają lub odznaczają wszystkie.
Ustaw globalne ustawienia — format, jakość i folder docelowy w sekcji Global settings zostaną zastosowane do wszystkich zaznaczonych filmów.
Nadpisz pojedyncze filmy — kliknij ikonę ustawień przy konkretnym filmie, aby zmienić format lub jakość tylko dla niego. Ustawienie per-item ma pierwszeństwo nad globalnym.
Add Selected to Queue — kliknij przycisk, aby dodać wszystkie zaznaczone filmy do kolejki.
Batch paste
Batch paste pozwala wkleić wiele linków YouTube naraz — każdy w osobnej linii. Aplikacja wykrywa wiele URLi i automatycznie przełącza się w tryb batch.
Skopiuj wiele URLi — każdy link w osobnej linii (oddzielone znakiem nowej linii). Wklej do pola URL (⌘V).
Panel Batch pojawi się automatycznie — zobaczysz listę wykrytych URLi z nagłówkiem informującym o ich liczbie. Tytuły zostaną pobrane dopiero podczas pobierania.
Ustaw format dla wszystkich — w sekcji Batch settings wybierz typ (Video / Audio), format, jakość i folder wyjściowy. Te ustawienia zostaną zastosowane do całego batcha.
Add All to Queue — kliknij przycisk, aby dodać wszystkie URL do kolejki jednocześnie.
Konwerter plików
Zakładka Convert pozwala konwertować dowolny lokalny plik multimedialny na inny format. Wszystko odbywa się lokalnie przy użyciu ffmpeg — żadnego uploadu.
Wybierz plik — przeciągnij plik na obszar drop zone lub kliknij Browse i wybierz plik z dysku. Obsługiwane wejście: MP4, MKV, MOV, AVI, WebM, MP3, WAV, FLAC, M4A, AAC, OGG i inne.
Wybierz format wyjściowy — z listy dostępnych formatów. Dla wideo możesz też zmienić rozdzielczość i bitrate audio.
Konwertuj — kliknij przycisk Convert. Postęp jest widoczny w czasie rzeczywistym. Przekonwertowany plik zostanie zapisany w tym samym folderze co oryginał (lub w wybranym folderze wyjściowym).
Tworzenie animowanych GIF-ów — po wybraniu formatu wyjściowego GIF, pojawią się dodatkowe opcje umożliwiające określenie czasu rozpoczęcia (Start Time) oraz czasu trwania (Duration). WavesConverter użyje profesjonalnego algorytmu podwójnego przejścia FFmpeg dla zachowania najwyższej jakości palety barw i płynności.
Kolejka i ETA
Zakładka Queue to centrum operacyjne WavesConverter — tu zarządzasz wszystkimi pobieraniami.
Równoległe pobierania
Aplikacja może pobierać kilka plików jednocześnie. Limit równoległych pobierań ustawiasz w Ustawieniach → Concurrent Downloads (domyślnie: 3). Każde pobieranie ma własny pasek postępu, ETA i aktualną prędkość.
Sterowanie kolejką
Start All — uruchamia wszystkie oczekujące pobierania (do limitu współbieżności). Skrót: Spacja.
Pause / Resume — zatrzymuje i wznawia pobieranie. Częściowo pobrane dane są zachowane.
Retry — ponawia pobieranie które zakończyło się błędem. Kliknij ikonę przy pozycji lub użyj przycisku Retry Failed.
Usuń — usuwa pozycję z kolejki. Nie usuwa pobranego pliku z dysku.
Historia
Zakładka History zapisuje wszystkie ukończone pobierania — tytuł, format, rozdzielczość, datę i ścieżkę pliku.
Otwieranie pliku z historii
Kliknij ikonę folderu przy dowolnej pozycji, aby otworzyć folder zawierający pobrany plik w Finderze (macOS) lub Eksploratorze plików (Windows). Możesz też kliknąć tytuł, aby otworzyć plik bezpośrednio.
Czyszczenie historii
Przycisk Clear History usuwa całą historię z aplikacji. Pliki na dysku pozostają nienaruszone.
Panel statystyk (Dashboard)
W górnej części zakładki History znajduje się zaawansowany panel statystyk, który pokazuje ogólne podsumowanie Twojej aktywności: łączną liczbę pobranych plików, ich łączny rozmiar na dysku oraz szacowany czas zaoszczędzony dzięki aplikacji.
Skróty klawiszowe
WavesConverter jest zoptymalizowany pod kątem klawiatury. Poniżej pełna lista skrótów:
| Skrót | Akcja |
|---|
Ustawienia
Zakładka Settings pozwala dostosować zachowanie aplikacji do własnych potrzeb.
Folder domyślny
Ustaw domyślny folder pobierania — każde nowe pobieranie trafi tam automatycznie, chyba że zmienisz folder ręcznie przy konkretnym pobraniu.
Limit równoległych pobierań
Określa ile plików może być pobieranych jednocześnie (1–10). Wyższa wartość = szybciej przy szybkim łączu, ale też większe zużycie zasobów. Domyślnie: 3.
Domyślny format i jakość
Ustaw domyślny typ (Video/Audio), format (MP4, MP3 itp.) i jakość. Możesz je nadpisywać przy każdym pobieraniu osobno.
Szablon nazwy pliku
Wybierz schemat nazewnictwa: %(title)s (samo tytuł), %(uploader)s - %(title)s (autor i tytuł), %(title)s [%(id)s] (z ID) lub wpisz własny wzorzec kompatybilny z yt-dlp.
Zaawansowane
W sekcji Zaawansowane znajdziesz przycisk Zainstaluj CLI (pakiet npm wavesconv), krótki tutorial terminala oraz opis deep linków wavesconverter://.
Deep linking
Po instalacji aplikacji desktopowej system rejestruje niestandardowy protokół wavesconverter://. Linki w tym formacie otwierają WavesConverter i przekazują akcję oraz opcjonalnie URL filmu (YouTube lub Instagram).
Skrót: prefiks przed linkiem
Nie musisz budować pełnego deep linka z parametrami — możesz po prostu dopisać wavesconverter:// przed zwykłym adresem YouTube lub Instagram. Aplikacja (i CLI) sama rozpoznają link i zamieniają go na czysty https://….
wavesconverter://https://youtu.be/dQw4w9WgXcQ wavesconverter://www.instagram.com/reel/ABC123/
Działa w: polu URL (zakładka Pobierz), auto-wykrywaniu schowka (skrót globalny), wklejaniu ⌘V/Ctrl+V oraz w terminalu (wavesconv, tryb interaktywny i wavesconv download …). Po rozpoznaniu w polu zostaje już tylko zwykły link HTTPS.
Jak to działa (pełne deep linki)
Użytkownik klika link wavesconverter://… w przeglądarce, skryptcie lub innym programie.
System uruchamia (lub aktywuje) WavesConverter i przekazuje pełny URL protokołu.
Aplikacja parsuje akcję (download, queue, open) i parametry — głównie url (zakodowany w UTF-8).
Dla download link trafia do zakładki Pobierz i uruchamia się Fetch. Dla queue z start=1 element trafia do kolejki i pobieranie startuje od razu.
Formaty linków
| Link | Działanie |
|---|---|
wavesconverter://https://youtu.be/… | Prefiks przed zwykłym linkiem — wyszukaj / otwórz (bez kodowania URL) |
wavesconverter://youtu.be/… | Ten sam skrót bez https:// |
wavesconverter://open | Tylko otwórz aplikację |
wavesconverter://download?url=ENCODED | Wklej URL i wyszukaj metadane |
wavesconverter://queue?url=ENCODED&start=1 | Dodaj do kolejki i rozpocznij pobieranie |
…&type=audio | Wymuś tryb audio przy kolejce |
Przykłady
wavesconverter://https://www.youtube.com/watch?v=dQw4w9WgXcQ
wavesconverter://download?url=https%3A%2F%2Fyoutu.be%2FdQw4w9WgXcQ
wavesconverter://queue?url=https%3A%2F%2Fwww.instagram.com%2Freel%2FABC123%2F&start=1
Parametr url musi być zakodowany (np. encodeURIComponent w JavaScript). Możesz też przekazać pełny HTTPS w ścieżce po hoście akcji, jeśli parser rozpozna https:// w pathname.
CLI (terminal)
wavesconv to wersja WavesConverter dla terminala — publikowana na npm. Idealna gdy wolisz wklejać linki w konsoli zamiast otwierać aplikację graficzną. Wymaga Node.js 18+.
Instalacja
npm install -g wavesconv@latest wavesconv --version
Przy pierwszym użyciu uruchom wavesconv tools install, aby pobrać yt-dlp. Do konwersji plików potrzebny jest też ffmpeg w PATH (lub zainstaluj go z poziomu aplikacji desktop).
Tryb interaktywny (wklej linki)
Uruchom samo wavesconv — pojawi się kolorowy prompt. Wklej link YouTube lub Instagram (opcjonalnie z prefiksem wavesconverter://) i naciśnij Enter — pobieranie startuje automatycznie.
wavesconv # 🔗 Wklej link › https://youtu.be/… # lub: wavesconverter://https://youtu.be/…
Polecenia jednorazowe
wavesconv download "https://youtu.be/…" -a -f mp3 wavesconv download "wavesconverter://https://youtu.be/…" -a -f mp3 wavesconv download "URL" -q 1080p -o C:\Videos
wavesconv info "URL" wavesconv convert film.mp4 -f mp3 -o out.mp3 wavesconv tools status
Komendy w trybie interaktywnym
| Komenda | Akcja |
|---|---|
/audio | Tryb audio (MP3) |
/video | Tryb wideo (MP4) |
/fmt mp3 | Ustaw format |
/q 1080p | Ustaw jakość |
/folder | Zmień folder pobierania |
/info URL | Podgląd metadanych |
/quit | Wyjście |
Aktualizacja CLI
npm install -g wavesconv@latest # lub konkretna wersja: npm install -g wavesconv@1.6.0
npm update -g wavesconv nie podnosi wersji, użyj npm install -g wavesconv@latest. Sprawdź wersję na registry: npm view wavesconv version.