QNapi – program do pobierania napisów do filmów na Mac i Linux

W erze streamingu i domowych bibliotek filmowych napisy są kluczem do pełnego zrozumienia treści, zwłaszcza dla polskich widzów oglądających produkcje zagraniczne. QNapi to darmowy program do automatycznego pobierania i dopasowywania napisów do filmów, który świetnie sprawdza się na macOS i Linux, gdzie brakuje natywnych alternatyw. Rozwiązanie korzysta z baz NapiProjekt, OpenSubtitles i Napisy24, wspiera wiele języków i formatów oraz jest rozwijane przez polskiego programistę Krzemina.

Ten przewodnik prezentuje historię projektu, funkcje, instalację, obsługę oraz praktyczne wskazówki dla użytkowników macOS i Linuksa.

Historia i rozwój QNapi – od Linuksa do multiplatformowości

QNapi powstał jako odpowiedź na brak oficjalnego klienta NapiProjekt poza Windowsem. Pierwotnie stworzony dla Linuksa i Mac OS X, zadebiutował w 2008 roku pod opieką autora Krzemina ([email protected]). Od wersji 0.1.4 zyskał wsparcie dla Windows, stając się narzędziem wieloplatformowym.

Ostatnia stabilna wersja, 0.2.3 (październik 2023), ma ok. 14,4 MB i jest dystrybuowana na licencji GNU GPL v2 lub nowszej. Program napisano w C++, co przekłada się na wysoką stabilność i wydajność nawet przy skanowaniu dużych bibliotek. Działa w dwóch trybach: graficznym (GUI) oraz konsolowym, dzięki czemu jest elastyczny dla zaawansowanych użytkowników.

QNapi rozwinął się z prostego pobieracza w poręcznego menedżera napisów, z integracją z powłoką systemową (prawy klik na pliku uruchamia pobieranie). Społeczność ceni go za prostotę i skuteczność, a projekt jest aktywnie wykorzystywany i rozwijany.

Kluczowe funkcje QNapi – automatyzacja na najwyższym poziomie

QNapi wyróżnia się automatycznym dopasowywaniem napisów do filmów lokalnych i zdalnych, rozpoznając je po nazwie, hashu lub sumie kontrolnej CRC. Obsługuje popularne kontenery wideo (MKV, AVI, MP4 itp.) oraz konwertuje napisy m.in. do SRT, TMP, MicroDVD (mDVD), MPL2.

Najważniejsze działania QNapi obejmują:

• pobieranie z wielu baz – NapiProjekt (główna polska baza z precyzyjnym dopasowaniem), OpenSubtitles (międzynarodowa), Napisy24;
• skanowanie katalogów – automatyczne przeszukiwanie dysków w poszukiwaniu filmów i wsadowe pobieranie napisów;
• preferencje językowe – ustawienia języka głównego (-l) i zapasowego (-lb), np. polski z priorytetem;
• integracja z systemem – na Linuksie i macOS: prawy klik w menedżerze plików (Nautilus, Finder) uruchamia pobieranie;
• tryb konsolowy – idealny do skryptów automatyzujących, np. qnapi -c film.mkv pobiera napisy bez GUI;
• dodatkowe opcje – zgłaszanie niepasujących napisów, korekta i wysyłka do bazy, konwersja dla DVD;
• ciche działanie – przełączniki -q/--quiet ukrywają komunikaty, a -d pomija listę proponowanych napisów.

Program działa w zasobniku systemowym, oszczędnie korzystając z zasobów. Zgłaszanie błędów i sugestii działa przez SourceForge.

Najważniejsze polecenia i opcje w skrócie:

Instalacja na macOS i Linux – krok po kroku

Na dystrybucjach Linuksa (Ubuntu, Arch itp.)

QNapi jest dostępny w repozytoriach wielu dystrybucji:

• Ubuntu/Debian – sudo apt install qnapi (strona podręcznika dostępna w repozytorium);
• Arch Linux – sudo pacman -S qnapi (pełna strona podręcznika po polsku);
• Integracja z Nautilusem – po instalacji dodaj skrypt kontekstowy, np. nautilus-scripts-install qnapi (jeśli dostępny).

W trybie konsolowym wyświetlisz pomoc poleceniami: qnapi --help lub qnapi --help-languages. To najszybszy sposób, by poznać wszystkie przełączniki i skróty.

Na macOS

Pobierz aplikację QNapi 0.2.3 z SourceForge lub z zaufanego serwisu (np. instalki.pl), ewentualnie skompiluj ze źródeł. Instalacja jest prosta i nie wymaga dodatkowych zależności.

Kroki instalacji:

1. Rozpakuj plik .dmg lub .zip.
2. Uruchom z Terminala: ./qnapi lub dodaj katalog do zmiennej PATH.
3. Integracja z Finderem: użyj Automatora, aby dodać akcję do menu kontekstowego.

Na obu platformach wymagane są biblioteki C++ (zwykle preinstalowane). Licencja GPL pozwala na swobodną kompilację i modyfikację.

Praktyczne wskazówki i rozwiązywanie problemów

Aby zmaksymalizować skuteczność, zastosuj poniższe rekomendacje:

• priorytet NapiProjektu – to zwykle najdokładniejsze polskie napisy dla popularnych tytułów;
• seriale – precyzyjne nazwy plików (sezon, odcinek, releas) znacznie poprawiają trafność dopasowania;
• problemy z CRC – ustaw OpenSubtitles jako źródło zapasowe i spróbuj ponownie;
• zgłaszanie błędów – użyj strony projektu: sourceforge.net/projects/qnapi;
• aktualizacje – wersja 0.2.3 jest stabilna, ale warto okresowo sprawdzać repozytoria.

QNapi nie wymaga konta (choć NapiProjekt może czasem poprosić o klucz) i po konfiguracji działa także w trybie pół-offline. Na macOS i Linuksie unika problemów typowych dla zależności Windows.

Porównanie z alternatywami i dlaczego QNapi na macOS/Linux?

W ekosystemie Apple i Linuksa brakuje prostych, natywnych narzędzi (rozwiązania jak Subliminal czy Bazarr wymagają Pythona lub Dockera). QNapi wygrywa natywnością C++, integracją systemową i dostępem do polskich baz – to świetny wybór dla użytkowników w Polsce.

Oto krótkie porównanie najpopularniejszych opcji: