Instrukcja instalacji

Jak zacząć
z LektorFilm

Pobierz playlistę YouTube, wygeneruj polskie napisy i wgraj je na stronę — w kilku krokach. Działa na Windows, Mac i Linux.

Spis kroków — Windows
  1. Zainstaluj Python
  2. Zainstaluj ffmpeg
  3. Utwórz folder LektorFilm
  4. Zainstaluj biblioteki
  5. Zapisz klucz API
  6. Pobierz cookies z YouTube
  7. Pobierz lektorfilm.py
  8. Uruchom pipeline
  9. Wgraj na stronę
Krok 1
Zainstaluj Python 3.12
Python to środowisko uruchomieniowe dla naszego skryptu.
1
Pobierz Python ze strony oficjalnej
Wejdź na python.org/downloads i kliknij duży żółty przycisk „Download Python 3.12.x".
python.org/downloads
🐍
Python 3.12.x
▼ Download Python 3.12.x
2
Uruchom instalator — WAŻNE: zaznacz "Add to PATH"
Kliknij dwukrotnie pobrany plik python-3.12.x-amd64.exe.

⚠️ Na pierwszym ekranie instalatora koniecznie zaznacz checkboksa:
Python 3.12 Installer
Install Python 3.12.x (64-bit)
☑ Add python.exe to PATH ← MUSI być zaznaczone!
☐ Use admin privileges when installing py.exe
Install Now
💡 Kliknij Install Now. Instalacja trwa ok. 1-2 minuty.
3
Sprawdź czy Python działa
Otwórz Terminal (Command Prompt) skrótem ⊞ Win + R, wpisz cmd, naciśnij Enter.

Następnie wpisz:
python --version
Command Prompt
C:\Users\Ty> python --version
Python 3.12.x ← taki wynik = sukces ✓
Krok 2
Zainstaluj ffmpeg
ffmpeg jest wymagany do konwersji audio przez Whisper.
1
Zainstaluj przez winget (najłatwiej)
W tym samym oknie terminala wpisz jedną komendę:
winget install ffmpeg
💡 winget to wbudowany menedżer pakietów Windows 10/11 — nie trzeba nic dodatkowego instalować.
2
Sprawdź instalację
Zamknij terminal i otwórz nowy (ważne!), a następnie wpisz:
ffmpeg -version
Command Prompt
C:\Users\Ty> ffmpeg -version
ffmpeg version 7.x ... ← taki wynik = sukces ✓
Krok 3
Utwórz folder LektorFilm
Wszystkie playlisty i skrypt będą w jednym miejscu.
1
Utwórz folder w Pobranych
Otwórz Eksplorator plików skrótem ⊞ Win + E.
Przejdź do Pobrane i utwórz nowy folder o nazwie LektorFilm.
📁 C:\Users\TwójNazwaUżytkownika\ └── 📁 Downloads\ └── 📁 LektorFilm\ ← tutaj będzie wszystko ├── lektorfilm.py ← skrypt pipeline └── 📁 output\ ← tu pojawią się playlist.json
2
Otwórz terminal bezpośrednio w folderze LektorFilm
To najłatwiejszy sposób — nie musisz znać ścieżki ani nazwy swojego konta.

Otwórz folder LektorFilm w Eksploratorze Windows, kliknij na pasek adresu u góry okna (gdzie widać ścieżkę), wpisz cmd i naciśnij Enter.
Eksplorator Windows — pasek adresu
📁 cmd ← wpisz tutaj i Enter
↓ terminal otworzy się od razu w tym folderze
D:\Pobrane\LektorFilm> ← gotowe, bez wpisywania cd ✓
💡 Działa niezależnie od tego czy folder jest na dysku C:\, D:\, czy gdziekolwiek indziej — i bez względu na nazwę konta użytkownika. Zawsze otwiera terminal dokładnie tam gdzie jesteś.
⚠️ Jeśli Twój folder Pobrane jest w niestandardowym miejscu (np. D:\Pobrane), ta metoda jest jedynym wygodnym sposobem — nie musisz zgadywać ścieżki.
Krok 4
Utwórz środowisko wirtualne i zainstaluj biblioteki
Środowisko wirtualne (venv) izoluje biblioteki — nie miesza się z resztą systemu.
1
Utwórz venv w folderze LektorFilm
python -m venv venv
2
Aktywuj środowisko
venv\Scripts\activate
Command Prompt
(venv) C:\...\LektorFilm> ← pojawi się "(venv)" = aktywne ✓
⚠️ Jeśli pojawi się błąd „cannot be loaded because running scripts is disabled", wpisz:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
i potwierdź literą T. Następnie spróbuj aktywować ponownie.
3
Zainstaluj wszystkie biblioteki (jednorazowo, ~5-10 min)
pip install yt-dlp openai-whisper anthropic
Command Prompt — instalacja bibliotek
Collecting yt-dlp...
Collecting openai-whisper...
Downloading torch-2.x.x... ████████ 2.3GB
← pobieranie modelu AI może chwilę potrwać
Successfully installed yt-dlp openai-whisper anthropic ✓
💡 Biblioteka openai-whisper pobiera model AI (~500MB). Przy wolnym internecie może to potrwać kilka minut.
Krok 5
Zapisz klucz Anthropic API
Klucz API jest potrzebny do tłumaczenia przez Claude.
1
Zdobądź klucz na console.anthropic.com
Wejdź na console.anthropic.com → API Keys → Create Key.
Skopiuj klucz — zaczyna się od sk-ant-...
2
Zapisz klucz do pliku (jednorazowo)
W terminalu wpisz (wstaw swój klucz):
echo sk-ant-TWÓJ_KLUCZ_TUTAJ > %USERPROFILE%\.anthropic_key
🔑 Klucz jest zapisany w C:\Users\TwójLogin\.anthropic_key — skrypt czyta go automatycznie przy każdym uruchomieniu.
Krok 6
Pobierz plik cookies z YouTube
Windows blokuje bezpośredni dostęp do cookies przeglądarki — zamiast tego eksportujemy je raz do pliku.
1
Zainstaluj rozszerzenie w Chrome
Otwórz Chrome i wejdź na Chrome Web Store — Get cookies.txt LOCALLY.

Kliknij Dodaj do Chrome → Dodaj rozszerzenie.
Chrome Web Store
🍪
Get cookies.txt LOCALLY
Rahul Khinchi · ★★★★★ · 200 000+ użytkowników
Dodaj do Chrome
2
Zaloguj się na YouTube w Chrome
Wejdź na youtube.com i upewnij się że jesteś zalogowany na swoje konto Google (ikona avatara w prawym górnym rogu).
youtube.com
▶ YouTube
TY
← zalogowany ✓
3
Eksportuj cookies do pliku
Kliknij ikonę rozszerzenia 🍪 w pasku narzędzi Chrome (prawy górny róg), a następnie kliknij Export.
Rozszerzenie Get cookies.txt LOCALLY
🍪 Get cookies.txt LOCALLY
⬇ Export ← kliknij to
Export for current domain only
Przeglądarka pobierze plik: youtube.com_cookies.txt
4
Przenieś plik do folderu LektorFilm i zmień nazwę
Pobrany plik youtube.com_cookies.txt znajdziesz w folderze Pobrane.

Przenieś go do E:\POBRANE\LektorFilm\ i zmień nazwę na cookies.txt.
📁 E:\POBRANE\LektorFilm\ ├── lektorfilm.py ├── cookies.txt ← tu ma być ten plik ├── 📁 venv\ └── 📁 output\
⚠️ Cookies wygasają po pewnym czasie (zwykle kilka tygodni). Jeśli pipeline przestanie pobierać filmy — wróć do tego kroku i eksportuj ponownie.
Krok 7
Pobierz plik lektorfilm.py
Główny skrypt pipeline — umieść go w folderze LektorFilm.
1
Pobierz lektorfilm.py ze strony
Kliknij przycisk poniżej aby pobrać skrypt, a następnie przenieś plik do folderu LektorFilm.
📁 Plik powinien być w: C:\Users\...\Downloads\LektorFilm\lektorfilm.py
Krok 8
Uruchom pipeline
Teraz pobieramy playlistę, transkrybujemy i tłumaczymy.
1
Otwórz terminal w folderze LektorFilm i aktywuj venv
Otwórz folder LektorFilm w Eksploratorze, kliknij pasek adresu, wpisz cmd i naciśnij Enter. Terminal otworzy się od razu we właściwym miejscu.

Następnie aktywuj środowisko wirtualne:
venv\Scripts\activate
Command Prompt
(venv) D:\Pobrane\LektorFilm> ← "(venv)" = gotowe ✓
💡 Aktywację venv robisz za każdym razem gdy otwierasz nowy terminal. Wystarczy kliknąć pasek adresu w Eksploratorze i wpisać cmd — jesteś od razu w dobrym miejscu.
2
Uruchom dla wybranej playlisty YouTube
python lektorfilm.py --playlist "https://youtube.com/playlist?list=TUTAJ_ID" --cookies cookies.txt
Command Prompt — pipeline w trakcie
╔══════════════════════════════════════════╗
║ 🎵 LektorFilm Pipeline 🎵 ║
╚══════════════════════════════════════════╝
 
🔑 Klucz z .anthropic_key
✓ Znaleziono 15 filmów: NazwaPlaylisty
 
[1/15] Tytuł Filmu (8:13)
✓ Audio pobrane (7.5 MB)
⏳ Ładuję model Whisper 'small'...
100%|████████████| transkrypcja...
✓ Transkrypcja gotowa (24 segmenty)
✓ Przetłumaczone ✓
⏱ Przy 15 filmach (po ~10 minut każdy) całość trwa ok. 30-60 minut. Możesz zostawić komputer i wrócić później.
3
Przydatne opcje
rem Wznów po przerwaniu (pomija już przetłumaczone) python lektorfilm.py --playlist "URL" --resume rem Tylko jeden film python lektorfilm.py --video "https://youtu.be/FILM_ID" rem Dokładniejszy model (wolniejszy) python lektorfilm.py --playlist "URL" --model medium rem Bez tłumaczenia (tylko EN) python lektorfilm.py --playlist "URL" --skip-translate
Krok 9
Wgraj playlistę na stronę
Gotowy plik JSON wgrywasz jednym kliknięciem.
1
Znajdź wygenerowany plik
Po zakończeniu pipeline znajdziesz plik w:
C:\Users\...\Downloads\LektorFilm\output\NazwaPlaylisty_playlist.json
2
Wgraj na lektorfilm.q64.pl
Wejdź na lektorfilm.q64.pl, kliknij przycisk „+ Wgraj listę" w lewym górnym rogu i wybierz plik playlist.json.
lektorfilm.q64.pl
＋ Wgraj listę
← kliknij tutaj
Pojawi się okno — wybierz NazwaPlaylisty_playlist.json
✓ Lista załadowana — 15 filmów gotowych
🎉

Gotowe! Playlista działa z polskim lektorem.

Kliknij dowolny film na liście — napisy będą czytane automatycznie głosem lektora.

⚡ Ściągawka — następnym razem
Za miesiąc chcesz wgrać nową playlistę. Oto cały proces od zera — bez stresu.
Krok po kroku
  • 1
    Otwórz folder LektorFilm w Eksploratorze 📁 E:\POBRANE\LektorFilm\ (lub gdzie go masz)
  • 2
    Kliknij pasek adresu → wpisz cmd → Enter Terminal otworzy się od razu w dobrym folderze
  • 3
    Aktywuj środowisko wirtualne venv\Scripts\activate — pojawi się (venv) na początku linii
  • ⚠
    Sprawdź czy plik cookies.txt jest aktualny Cookies wygasają co kilka tygodni. Jeśli minął miesiąc — wejdź na youtube.com w Chrome, kliknij rozszerzenie 🍪 Get cookies.txt i eksportuj ponownie. Podmień plik w folderze LektorFilm.
  • 4
    Uruchom pipeline z linkiem do playlisty YouTube python lektorfilm.py --playlist "URL_PLAYLISTY" --cookies cookies.txt
  • 5
    Poczekaj na zakończenie — terminal wyświetli komunikat z nazwą pliku Przy 15 filmach po ~10 min każdy — ok. 25-60 minut. Możesz zostawić komputer.
  • 6
    Wejdź na lektorfilm.q64.pl → kliknij + Wgraj listę Plik jest w: LektorFilm\output\NazwaPlaylisty_playlist.json
Jeśli coś nie działa
  • !
    Błąd pobierania audio / autoryzacji YouTube Eksportuj nowy cookies.txt z rozszerzenia Chrome i podmień plik. To najczęstszy powód problemów po przerwie.
  • !
    Pipeline przerwał się w połowie Uruchom ponownie z flagą --resume — pominie już przetworzone filmy i zacznie od miejsca przerwania.
  • !
    Napisy są słabej jakości lub mają błędy Dodaj --model small lub --model medium — dokładniejszy model, ale wolniejszy.
Spis kroków — macOS
  1. Zainstaluj Homebrew
  2. Zainstaluj Python i ffmpeg
  3. Utwórz folder LektorFilm
  4. Utwórz venv i zainstaluj biblioteki
  5. Zapisz klucz API
  6. Pobierz lektorfilm.py
  7. Uruchom pipeline
  8. Wgraj na stronę
Krok 1
Zainstaluj Homebrew
Homebrew to menedżer pakietów dla macOS — jak App Store dla programistów.
1
Otwórz Terminal
Naciśnij ⌘ Cmd + Spacja, wpisz Terminal, naciśnij Enter.
2
Wklej komendę instalacji Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
🔑 System może zapytać o hasło — wpisz hasło swojego Maca (nie wyświetla się przy pisaniu, to normalne).
3
Dodaj Homebrew do PATH (M1/M2/M3/M4 Mac)
Po instalacji terminal pokaże polecenia do skopiowania. Wklej te trzy linie:
echo >> /Users/$USER/.zprofile echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> /Users/$USER/.zprofile eval "$(/opt/homebrew/bin/brew shellenv zsh)"
Krok 2
Zainstaluj Python 3.12 i ffmpeg
brew install [email protected] ffmpeg
Terminal
~$ brew install [email protected] ffmpeg
==> Downloading [email protected]...
==> Installing ffmpeg...
🍺 /opt/homebrew/Cellar/[email protected]/...
🍺 /opt/homebrew/Cellar/ffmpeg/...
✓
Sprawdź instalację
python3.12 --version && ffmpeg -version | head -1
Krok 3
Utwórz folder LektorFilm
mkdir -p ~/Downloads/LektorFilm
📁 ~/Downloads/ └── 📁 LektorFilm/ ← tutaj będzie wszystko ├── lektorfilm.py ← skrypt pipeline ├── 📁 venv/ ← środowisko Python └── 📁 output/ ← tu pojawią się playlist.json
💡
Jak szybko przejść do folderu w terminalu — dwa sposoby
Nie musisz wpisywać ścieżki ręcznie. Wybierz sposób który wolisz:
🖱 Sposób 1 — przeciągnij folder z Findera
1. W terminalu wpisz cd (ze spacją na końcu)
2. Otwórz Finder, znajdź folder LektorFilm
3. Przeciągnij folder i upuść go na okno terminala
4. Naciśnij Enter
Terminal
~$ cd /Users/TwójLogin/Downloads/LektorFilm ← ścieżka wklejona automatycznie
LektorFilm $ ← gotowe ✓
⌥ Sposób 2 — otwórz terminal bezpośrednio z Findera
1. W Finderze kliknij folder LektorFilm prawym przyciskiem myszy
2. Przytrzymaj klawisz ⌥ Option — pojawi się dodatkowa opcja
3. Kliknij „Otwórz Terminal w folderze"
Finder — menu kontekstowe
📁 LektorFilm [prawy przycisk + ⌥ Option]
Otwórz
Przenieś do kosza
Otwórz Terminal w folderze ← kliknij to
Uzyskaj informacje
💡 Oba sposoby działają niezależnie od tego gdzie folder jest na dysku — nie trzeba znać pełnej ścieżki.
Krok 4
Utwórz venv i zainstaluj biblioteki
# Upewnij się że jesteś w folderze LektorFilm cd ~/Downloads/LektorFilm # Utwórz środowisko wirtualne python3.12 -m venv venv # Aktywuj środowisko source venv/bin/activate # Zainstaluj biblioteki (jednorazowo, ~5-10 min) pip install yt-dlp openai-whisper anthropic
Terminal — po aktywacji venv
(venv) LektorFilm $ ← "(venv)" = środowisko aktywne ✓
Krok 5
Zapisz klucz Anthropic API
# Wstaw swój klucz (zaczyna się od sk-ant-...) echo 'sk-ant-TWÓJ_KLUCZ_TUTAJ' > ~/.anthropic_key
🔑 Klucz API pobierz z console.anthropic.com → API Keys → Create Key.
Krok 6
Pobierz lektorfilm.py
1
Pobierz i umieść w folderze LektorFilm
📁 Przenieś pobrany plik do: ~/Downloads/LektorFilm/lektorfilm.py
Krok 7
Uruchom pipeline
1
Przy każdym nowym oknie terminala — aktywuj venv
cd ~/Downloads/LektorFilm && source venv/bin/activate
2
Uruchom dla playlisty YouTube
python3 lektorfilm.py --playlist "https://youtube.com/playlist?list=TUTAJ_ID" --browser chrome
💡 Plik cookies.txt musi być w folderze LektorFilm — patrz Krok 6. Jeśli pipeline zgłosi błąd autoryzacji, wróć do Kroku 6 i wyeksportuj cookies ponownie.
3
Przydatne opcje
# Wznów po przerwaniu python3 lektorfilm.py --playlist "URL" --resume # Jeden film python3 lektorfilm.py --video "https://youtu.be/ID" # Dokładniejszy model python3 lektorfilm.py --playlist "URL" --model medium
Krok 8
Wgraj playlistę na stronę
1
Znajdź wygenerowany plik
Plik będzie w: ~/Downloads/LektorFilm/output/NazwaPlaylisty_playlist.json
2
Wgraj na lektorfilm.q64.pl
Wejdź na stronę, kliknij „+ Wgraj listę" i wybierz plik playlist.json.
🎉

Gotowe! Playlista działa z polskim lektorem.

Kliknij dowolny film — napisy będą czytane automatycznie głosem lektora.

⚡ Ściągawka — następnym razem
Za miesiąc chcesz wgrać nową playlistę. Oto cały proces od zera — bez stresu.
Krok po kroku
  • 1
    Przejdź do folderu LektorFilm — dwa sposoby: 🖱 Przeciągnij folder z Findera na okno terminala (po wpisaniu cd ze spacją) ⌥ Lub: kliknij folder prawym przyciskiem + przytrzymaj ⌥ Option → „Otwórz Terminal w folderze"
  • 2
    Aktywuj środowisko wirtualne source venv/bin/activate — pojawi się (venv) na początku linii
  • 3
    Upewnij się że jesteś zalogowany na YouTube w Chrome Otwórz youtube.com — powinna być widoczna ikona Twojego konta.
  • 4
    Uruchom pipeline python3 lektorfilm.py --playlist "URL_PLAYLISTY" --browser chrome
  • 5
    Poczekaj na zakończenie Przy 15 filmach po ~10 min każdy — ok. 25-60 minut. Możesz zostawić komputer.
  • 6
    Wejdź na lektorfilm.q64.pl → kliknij + Wgraj listę Plik jest w: ~/Downloads/LektorFilm/output/NazwaPlaylisty_playlist.json
Jeśli coś nie działa
  • !
    Błąd cookies / autoryzacji YouTube Zamknij Chrome całkowicie i uruchom pipeline ponownie. Albo użyj --browser safari jeśli jesteś zalogowany w Safari.
  • !
    Pipeline przerwał się w połowie Uruchom ponownie z --resume — pominie już przetworzone filmy.
  • !
    Napisy mają błędy Dodaj --model small lub --model medium dla lepszej jakości.
Spis kroków — Linux (Ubuntu/Debian)
  1. Zainstaluj Python i ffmpeg
  2. Utwórz folder LektorFilm
  3. Utwórz venv i zainstaluj biblioteki
  4. Zapisz klucz API
  5. Pobierz lektorfilm.py
  6. Uruchom pipeline
  7. Wgraj na stronę
Krok 1
Zainstaluj Python 3.12 i ffmpeg
sudo apt update sudo apt install python3.12 python3.12-venv ffmpeg -y python3.12 --version && ffmpeg -version | head -1
Krok 2
Utwórz folder LektorFilm
mkdir -p ~/Downloads/LektorFilm && cd ~/Downloads/LektorFilm
Krok 3
Utwórz venv i zainstaluj biblioteki
python3.12 -m venv venv source venv/bin/activate pip install yt-dlp openai-whisper anthropic
💡 Na Ubuntu 22.04+ może być potrzebne: sudo apt install python3.12-distutils
Krok 4
Zapisz klucz API
echo 'sk-ant-TWÓJ_KLUCZ' > ~/.anthropic_key
Krok 5
Pobierz lektorfilm.py
wget https://lektorfilm.q64.pl/lektorfilm.py
Krok 6
Uruchom pipeline
# Aktywuj venv (przy każdym nowym terminalu) cd ~/Downloads/LektorFilm && source venv/bin/activate # Uruchom python3 lektorfilm.py --playlist "URL" --browser chrome
🐧 Na Linux cookies Chrome pobierane są automatycznie. Upewnij się że jesteś zalogowany na YouTube w Chrome.
Krok 7
Wgraj na stronę
✓
Plik będzie w output/
Wejdź na lektorfilm.q64.pl, kliknij „+ Wgraj listę" i wybierz plik playlist.json z folderu ~/Downloads/LektorFilm/output/
🎉

Gotowe!

Playlista z polskim lektorem działa na stronie.

⚡ Ściągawka — następnym razem
Za miesiąc chcesz wgrać nową playlistę. Oto cały proces od zera — bez stresu.
Krok po kroku
  • 1
    Otwórz terminal i przejdź do folderu cd ~/Downloads/LektorFilm && source venv/bin/activate
  • 2
    Upewnij się że jesteś zalogowany na YouTube w Chrome Otwórz youtube.com — powinna być widoczna ikona Twojego konta.
  • 3
    Uruchom pipeline python3 lektorfilm.py --playlist "URL_PLAYLISTY" --browser chrome
  • 4
    Poczekaj na zakończenie i wgraj plik na stronę Plik: ~/Downloads/LektorFilm/output/NazwaPlaylisty_playlist.json
Jeśli coś nie działa
  • !
    Pipeline przerwał się w połowie Uruchom ponownie z --resume.
  • !
    Błąd cookies Upewnij się że Chrome jest otwarty i jesteś zalogowany na YouTube. Możesz też użyć metody z plikiem: eksportuj cookies.txt rozszerzeniem i uruchom z --cookies cookies.txt.