W erze streamingu i multimediów, idealne napisy do filmów i seriali to podstawa komfortowego oglądania. QNapi 0.1.5 to lekki, otwartoźródłowy program, który automatyzuje pobieranie i dopasowywanie napisów z polskich i międzynarodowych baz danych, idealnie sprawdzając się na Linuxie i macOS. Aplikacja oszczędza godziny poszukiwań, oferując precyzyjne dopasowanie do konkretnego pliku wideo.
Czym jest QNapi i jak działa?
QNapi to program do automatycznego pobierania i dopasowywania napisów do filmów, który analizuje plik wideo – często na podstawie sumy kontrolnej MD5 z fragmentu pliku – i wyszukuje idealnie pasujące dialogi. Działa w dwóch trybach: graficznym (GUI) oraz konsolowym, co czyni go elastycznym narzędziem dla każdego użytkownika.
Główne serwisy, z których czerpie dane:
- NapiProjekt.pl – polska baza z napisami do najnowszych produkcji;
- Napisy24.pl – dodatkowe polskie zasoby;
- OpenSubtitles.com – międzynarodowa baza z napisami w wielu językach, w tym angielskimi.
Program nie tylko pobiera napisy, ale też je przetwarza: konwertuje formaty (np. na SRT), usuwa polskie znaki diakrytyczne (jeśli odtwarzacz ich nie obsługuje) i umożliwia skanowanie całych katalogów w poszukiwaniu plików wideo. W razie niedopasowania, QNapi pozwala zgłaszać błędy lub ręcznie poprawiać napisy, co wspiera rozwój bazy danych.
Wersja 0.1.5 to stabilna edycja, dostępna w repozytoriach Debiana i Ubuntu (np. qnapi 0.1.5-3 lub nowsze patche w testing/unstable), choć nowsze aktualizacje (jak w 2023 r.) ożywiły aplikację, przywracając pełną funkcjonalność po okresie przestoju.
Instalacja na Linuxie – krok po kroku
Na dystrybucjach opartych na Debianie/Ubuntu instalacja jest prosta dzięki PPA lub natywnym pakietom.
Ubuntu/Debian:
Wykonaj kolejno polecenia w terminalu:
sudo add-apt-repository ppa:krzemin/qnapi
sudo apt-get update
sudo apt-get install qnapi
Ta metoda instaluje QNapi wraz z integracją systemową (np. qnapi-gnome dla pulpitu GNOME). Po instalacji program pojawia się w menu kontekstowym – kliknij prawym przyciskiem na plik wideo i wybierz „Pobierz napisy do filmu z QNapi”.
Arch Linux:
Szczegóły dostępne na stronie podręcznika – wpisz w terminalu:
man qnapi
Program zainstalujesz z oficjalnych repozytoriów (pacman) lub z AUR.
Inne dystrybucje:
Sprawdź repozytoria (np. Fedora, openSUSE) lub skompiluj ze źródeł z GitHub. Wersja 0.1.5 jest kompatybilna ze starszymi systemami, jak Ubuntu 9.04 czy Xubuntu 16.04, choć zalecana jest aktualizacja dla pełnej stabilności.
Problemy? Użytkownicy zgłaszali błędy pobierania w starszych wydaniach Ubuntu, rozwiązywane przez aktualizacje repozytoriów.
Instalacja i obsługa na macOS
Na macOS QNapi dostępny jest jako natywna aplikacja do pobrania z alternatywnych katalogów z aplikacjami lub bezpośrednio ze stron dystrybucji. Pobierz plik .dmg, zainstaluj i uruchom – program automatycznie przeszukuje bazę NapiProjekt i OpenSubtitles, dopasowując napisy do plików na dysku.
Kluczowe funkcje na Macu
Na macOS QNapi oferuje m.in.:
- skanowanie katalogów w poszukiwaniu filmów,
- automatyczne pobieranie polskich i angielskich napisów,
- integrację z Finderem (prawe kliknięcie na plik wideo).
Aplikacja współpracuje z odtwarzaczami jak VLC czy IINA, eliminując opóźnienia i niedopasowania.
Ustawienia i zaawansowane opcje
Po instalacji skonfiguruj QNapi w panelu ustawień:
- zakładka główne – wybierz domyślny język (polski/angielski);
- moduły – ustaw kolejność baz (np. najpierw NapiProjekt, potem OpenSubtitles) i włącz „Przerwij wyszukiwanie po znalezieniu pasujących napisów” dla szybszego działania;
- przetwarzanie napisów – aktywuj konwersję, usuwanie diakrytyków i wybór formatu (SRT, ASS).
Tryb konsolowy (dla zaawansowanych użytkowników):
Przykładowe polecenia do pracy w terminalu:
qnapi -c /ścieżka/do/filmu.mkv # pobierz w konsoli
qnapi -c -q /ścieżka/do/filmu.mkv # cicho, bez komunikatów
qnapi -c -s /ścieżka/do/filmu.mkv # pokaż listę dostępnych napisów
Najważniejsze opcje: -q (tryb cichy), -d (tylko pobieranie). Program integruje się też z powłoką – prawy klik na pliku wideo uruchamia pobieranie jednym kliknięciem.
Historia rozwoju i aktualizacje
QNapi powstał jako otwartoźródłowy klon windowsowego NapiProjekt, zyskując popularność w polskim środowisku Linuksa i macOS. Wersja 0.1.5 (ok. 2009–2010) była szeroko dostępna w repozytoriach Debiana. Po latach przestoju (ok. 2017–2023), aplikacja przestała pobierać napisy z powodu zmian w API serwisów.
Przełom nastąpił ok. miesiąc przed publikacją artykułu w 2023 r.: drobna aktualizacja kodu przywróciła pełną funkcjonalność, choć GitHub nadal wskazuje 0.2.3 z 2017 r. jako najnowszą. Dziś QNapi działa stabilnie na Linuxie (w tym na NAS-ach jak QNAP) i macOS, obsługując najnowsze filmy.
Zalety i wady w porównaniu do alternatyw
Zalety QNapi 0.1.5
Najważniejsze atuty QNapi 0.1.5 to:
- darmowy i otwartoźródłowy – bez reklam i zbędnych dodatków;
- precyzyjne dopasowanie – identyfikacja po MD5 minimalizuje ryzyko desynchronizacji;
- lekki i multiplatformowy – Linux, macOS, Windows;
- automatyzacja – skanowanie folderów, integracja z menu kontekstowym.
Wady
Warto znać ograniczenia:
- starsza wersja – na najnowszych systemach może wymagać łatek lub obejść;
- zależność od serwisów – awarie zewnętrznych baz blokują pobieranie;
- obsługa formatów – brak natywnego wsparcia niektórych plików 4K/HEVC bez dodatków.
Poniżej skrócone porównanie QNapi z wybranymi alternatywami:
| Cecha | QNapi 0.1.5 | Alternatywy (np. SubDownloader) |
|---|---|---|
| Polskie bazy | Tak (NapiProjekt) | Częściowo |
| Linux/macOS | Natywnie | Tak, ale mniej zintegrowane |
| Konsola/GUI | Oba | Głównie GUI |
| Aktualizacje | Okazjonalne | Częstsze |
Praktyczne wskazówki i rozwiązywanie problemów
Aby szybko rozwiązać typowe kłopoty, skorzystaj z poniższych podpowiedzi:
- skanowanie katalogu – uruchom GUI, wskaż folder – QNapi przetworzy wszystkie pliki MKV/MP4/AVI;
- problemy z pobieraniem – sprawdź połączenie z serwerami, zaktualizuj repozytoria; na Ubuntu 9.04+ błędy rozwiązywano przez reinstalację;
- konwersja – włącz usuwanie znaków ą, ę, ó, ł, ś – idealne dla starszych TV;
- bezpieczeństwo – pobieraj z zaufanych źródeł (PPA, GitHub), unikaj nieoficjalnych plików wykonywalnych na Macu.
QNapi 0.1.5 udowadnia, że proste narzędzia przetrwają dekady i wciąż dostarczają świetne rezultaty. Na Linuxie i macOS to obowiązkowa pozycja dla kinomaniaków ceniących automatyzację i polskie napisy.






