Dokumentacja
Instrukcja uruchomienia i konfiguracji odtwarzacza Beaver — lekkiego, akcelerowanego sprzętowo odtwarzacza wideo dla Windows i Linux.
Pakiet prebuilt zawiera wszystkie biblioteki natywne — potrzebujesz tylko środowiska uruchomieniowego .NET i narzędzia zenity (Linux).
sudo apt update sudo apt install dotnet-sdk-8.0 ffmpeg zenity
sudo dnf install dotnet-sdk-8.0 ffmpeg-devel SDL2-devel SDL2_ttf-devel zenity
sudo pacman -S dotnet-sdk ffmpeg sdl2 sdl2_ttf zenity
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
lib/ — wymagany jest tylko .NET SDK i zenity.Sześć prostych kroków od pobrania do uruchomienia.
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
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
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
chmod +x filmancc-player
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.
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
Rozpakuj i uruchom — żadnych instalatorów nie jest wymagane.
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
Expand-Archive filmancc.zip -DestinationPath filmancc
Albo kliknij prawym na plik .zip → „Wyodrębnij wszystkie".
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.
Aby mieć skróty w Menu Start i na Pulpicie, użyj instalatora:
.\install.ps1 # Instalacja systemowa (wymaga administratora) .\install.ps1 -System
Skrypty instalacyjne tworzą skróty, wpis w menu i skojarzenia plików.
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
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łącz odtwarzacz z serwerem forfilman.cc, aby odblokować rekomendacje, historię i zdalne playlisty.
./filmancc-player --server https://serwer.forfilman.cc --api-key TWOJ_KLUCZ
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.
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
}
%APPDATA%\filmancc, Linux ~/.config/filmancc.Pełna lista skrótów sterujących odtwarzaczem.
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.
| Biblioteka | Linux (.so) | Windows (.dll) |
|---|---|---|
| libavcodec / avcodec | 62.11.100 | avcodec-62.dll |
| libavformat / avformat | 62.3.100 | avformat-62.dll |
| libavutil / avutil | 60.8.100 | avutil-60.dll |
| libswscale / swscale | 9.1.100 | swscale-9.dll |
| libswresample / swresample | 6.1.100 | swresample-6.dll |
| SDL2 | 2.32.10 | SDL2.dll |
| SDL2_ttf | 2.22.0 | SDL2_ttf.dll |
./filmancc-player video.mp4 -gpu /ścieżka/do/lib.Pobierz najnowszą wersję odtwarzacza Beaver.