Dokumentacja

Konfiguracja

Instrukcja uruchomienia i konfiguracji odtwarzacza Beaver — lekkiego, akcelerowanego sprzętowo odtwarzacza wideo dla Windows i Linux.

Wymagania systemowe

Pakiet prebuilt zawiera wszystkie biblioteki natywne — potrzebujesz tylko środowiska uruchomieniowego .NET i narzędzia zenity (Linux).

🐧 Linux — pakiety systemowe

Debian / Ubuntu

sudo apt update
sudo apt install dotnet-sdk-8.0 ffmpeg zenity

Fedora

sudo dnf install dotnet-sdk-8.0 ffmpeg-devel SDL2-devel SDL2_ttf-devel zenity

Arch Linux

sudo pacman -S dotnet-sdk ffmpeg sdl2 sdl2_ttf zenity

🪟 Windows

Zainstaluj .NET 8.0 Desktop Runtime ze strony Microsoft. Biblioteki FFmpeg i SDL2 są dołączone do pakietu w katalogu lib\win-x64\ — nie wymagają instalacji.

Pobierz archiwum .zip ze strony pobierania lub z PowerShell:

Invoke-WebRequest https://github.com/softbery-org/filmancc/releases/download/v1.0.0/filmancc-v1.0.0-win-x64.zip
Wskazówka: pakiet prebuilt (Linux) też zawiera wszystko w katalogu lib/ — wymagany jest tylko .NET SDK i zenity.

Instalacja — Linux

Sześć prostych kroków od pobrania do uruchomienia.

1

Pobierz odtwarzacz

Pobierz najnowsze wydanie ze strony pobierania lub bezpośrednio z GitHub:

wget https://github.com/softbery-org/filmancc/releases/download/v1.0.0/filmancc-v1.0.0-linux-x64.tar.gz
2

Rozpakuj archiwum

Rozpakuj pobrane archiwum .tar.gz do wybranego katalogu:

tar xzf filmancc-v1.0.0-linux-x64.tar.gz
cd filmancc-v1.0.0-linux-x64
3

Sprawdź zależności

Pakiet prebuilt zawiera wszystkie biblioteki natywne (FFmpeg, SDL2, SDL2_ttf) w katalogu lib/. Wymagane jest tylko zenity (okna dialogowe):

# Debian/Ubuntu
sudo apt install zenity
# Fedora
sudo dnf install zenity
# Arch Linux
sudo pacman -S zenity
4

Nadaj uprawnienia wykonywania

chmod +x filmancc-player
5

Uruchom odtwarzacz

Uruchom odtwarzacz z plikiem wideo i akceleracją GPU:

./filmancc-player video.mp4 -gpu

Bez argumentów — przywróci ostatnią sesję lub otworzy okno wyboru pliku.

6

(Opcjonalnie) Zainstaluj w systemie

Aby uruchamiać odtwarzacz z dowolnego miejsca, dodaj go do PATH lub użyj instalatora (sekcja poniżej):

sudo cp filmancc-player /usr/local/bin/
sudo cp -r lib /usr/local/lib/filmancc

Instalacja — Windows

Rozpakuj i uruchom — żadnych instalatorów nie jest wymagane.

1

Pobierz archiwum

Pobierz archiwum .zip ze strony pobierania lub z PowerShell:

Invoke-WebRequest https://github.com/softbery-org/filmancc/releases/download/v1.0.0/filmancc-v1.0.0-win-x64.zip
2

Rozpakuj plik .zip

Expand-Archive filmancc.zip -DestinationPath filmancc

Albo kliknij prawym na plik .zip → „Wyodrębnij wszystkie".

3

Uruchom odtwarzacz

Dwukliknij filmancc-player.exe w Explorerze lub uruchom z PowerShell:

cd filmancc
.\filmancc-player.exe video.mp4 -gpu

Bez argumentów — przywróci ostatnią sesję lub otworzy okno wyboru pliku.

4

(Opcjonalnie) Zainstaluj w systemie

Aby mieć skróty w Menu Start i na Pulpicie, użyj instalatora:

.\install.ps1
# Instalacja systemowa (wymaga administratora)
.\install.ps1 -System

Instalator

Skrypty instalacyjne tworzą skróty, wpis w menu i skojarzenia plików.

🐧 Linux — install.sh / uninstall.sh

Szybka instalacja dla bieżącego użytkownika:

chmod +x install.sh uninstall.sh
# Instalacja do ~/.local/share
./install.sh
# Instalacja systemowa (do /opt + /usr/share)
./install.sh --system

Odinstalowanie:

# Odinstalowanie użytkownika
./uninstall.sh
# Odinstalowanie systemowe
./uninstall.sh --system
# Dodatkowo usuń konfigurację
./uninstall.sh --purge

🪟 Windows — install.ps1 / uninstall.ps1

Instalacja użytkownika lub systemowa:

# Instalacja użytkownika (%LOCALAPPDATA%\Programs\FilmanCC)
.\install.ps1
# Instalacja systemowa (Program Files)
.\install.ps1 -System

Odinstalowanie:

# Z PowerShell w katalogu instalacji
.\uninstall.ps1
# Albo: Ustawienia → Aplikacje → Filman.cc Player → Odinstaluj

Połączenie z serwerem

Połącz odtwarzacz z serwerem forfilman.cc, aby odblokować rekomendacje, historię i zdalne playlisty.

Z wiersza poleceń

./filmancc-player --server https://serwer.forfilman.cc --api-key TWOJ_KLUCZ

Przez interfejs

1. Uruchom odtwarzacz i otwórz panel ustawień klawiszem S.
2. Kliknij przycisk Adres serwera na górze panelu.
3. Wpisz adres serwera (https://serwer.forfilman.cc), nazwę użytkownika i hasło (lub klucz API).
4. Kliknij Zaloguj.

Po zalogowaniu odtwarzacz pobierze i wyświetli zdalne playlisty oraz odcinki.

settings.json — ustawienia aplikacji

Plik konfiguracyjny przechowuje preferencje odtwarzacza. Edytuj ręcznie lub przez interfejs.

{
  "autoPlayNext": true,
  "resumeOnStart": true,
  "hardwareAccel": true,
  "connectToServerOnStart": true,
  "playlistRefreshIntervalMinutes": 5,
  "showFps": false,
  "timeDisplayMode": "remaining",
  "skipEndCredits": false,
  "language": "pl",
  "playlistPanelRight": true,
  "playlistPanelWidth": 340,
  "playlistViewMode": "list",
  "showRecommendations": true,
  "backgroundPlayback": false,
  "fontName": null
}
Lokalizacja pliku: Windows %APPDATA%\filmancc, Linux ~/.config/filmancc.

Skróty klawiszowe

Pełna lista skrótów sterujących odtwarzaczem.

Odtwórz / PauzaSpacja
Przewiń −10 s / +10 s← / →
Następny utwórN
Poprzedni utwórP
Pełny ekranF
Wyjdź z pełnego ekranu / overlayEsc
Zawsze na wierzchuT
Zapisz sesję i wyjdźQ
Przełącz panel playlistyTab
Wyszukiwanie w playliście/
Nawigacja w playliście↑ / ↓
Usuń zaznaczony elementDel
Cofnij / usuń znakBackspace
Odtwórz zaznaczony elementEnter
Głośność / przewijanie playlistyKółko myszy
Pełny ekranDwuklik

Biblioteki natywne

Projekt zawiera biblioteki natywne w katalogu lib/: pliki .so dla Linuksa oraz .dll dla Windows w lib\win-x64\. Jeśli bundlowane biblioteki są niekompatybilne, odtwarzacz automatycznie użyje wersji zainstalowanych w systemie.

BibliotekaLinux (.so)Windows (.dll)
libavcodec / avcodec62.11.100avcodec-62.dll
libavformat / avformat62.3.100avformat-62.dll
libavutil / avutil60.8.100avutil-60.dll
libswscale / swscale9.1.100swscale-9.dll
libswresample / swresample6.1.100swresample-6.dll
SDL22.32.10SDL2.dll
SDL2_ttf2.22.0SDL2_ttf.dll
Aby wskazać niestandardową ścieżkę bibliotek, podaj ją jako ostatni argument: ./filmancc-player video.mp4 -gpu /ścieżka/do/lib.

Wszystko gotowe?

Pobierz najnowszą wersję odtwarzacza Beaver.

Pobierz odtwarzacz →