FreeFlix CLI 🍿
Watch movies, series and anime from your terminal — multi-language, multi-source, no browser, no ads.
🎬 Movies · 📺 Series · 🍿 Anime (VF / VOSTFR / VO)
mpv-powered · Anime4K upscaling · downloads · resume · AniList sync
uv tool install freeflix-cli · then run freeflix
⚡ Why FreeFlix
- One command, everything works — installs its own mpv/ffmpeg/yt-dlp and a Nerd Font; no browser, no ads, no accounts required.
- Everything, always up to date — movies & series (TMDB-based) and anime (Anime-Sama), in French (VF/VOSTFR) or VO.
- Actually nice to use — poster previews in the terminal (chafa), breadcrumb
navigation,
/to filter,Escto go back anywhere,?for help. - Download & keep — pick a quality, batch a whole season into its own folder, resume interrupted downloads, see ✓ watched / ▸ resume / ⬇ downloaded badges.
- Crisp picture — Anime4K GPU upscaling pre-tuned, one keypress to toggle.
- Optional AniList sync — your progress updates automatically as you watch.
FreeFlix is a hardened, feature-extended fork of autoflix-cli by PaulExplorer. All upstream functionality is preserved ; on top of that, FreeFlix ships :
- A complete download backend (yt-dlp for HLS, aria2c for direct mp4, with quality selection 480p/720p/1080p) ;
- Batch "download whole season" ;
- Position-in-episode resume (mpv lua hook + tracker) ;
- AniList sync on watch / mark-as-watched ;
- OpenSubtitles fallback when a source has no subtitle ;
- Parallel multi-episode downloads (1–4 workers) ;
- Daily new-episode notifications via systemd timer + libnotify ;
- A Nyaa torrent provider (downloads via aria2 BitTorrent) ;
- A Local Downloads browser in the home menu ;
- Anime4K Mode A_VL shaders pre-bundled (toggle CTRL+1 / CTRL+0) ;
- French localisation of the whole UI (auto-switched based on language pref) ;
- Multi-mirror portal fallback +
website_origincaching (24 h TTL) ; - Multiple bug fixes : 403 on
/catalogue/?search=(animes-sama.fr refactor), double-slash legacy URLs in history, settings-menu exit loop, ffmpeg infinite-reconnect at byte 1506, Videasy/Vidlink Referer not propagated, history resume silent-failure, and more.
⚠️ FreeFlix is a community fork. The original project is autoflix-cli by PaulExplorer ; all credit goes to him for the underlying scraping work and architecture. FreeFlix exists only to consolidate the fixes and features I personally needed.
✨ What FreeFlix gives you
| Feature | |
|---|---|
| 🎬 | Stream movies, series and anime in VF / VOSTFR / VA / VJ / VKR / VCN |
| 📥 | Download single episodes or entire seasons to ~/Downloads/FreeFlix/ |
| ▶️ | Resume at the exact second you left off (mpv only) |
| 🔄 | AniList sync : mark-as-watched on AniList automatically |
| 📝 | OpenSubtitles fallback when a source has no subs |
| ⚡ | Parallel downloads (up to 4 concurrent episodes) |
| 🔔 | Daily notifications when new episodes drop |
| 🌊 | Nyaa.si torrents (high-quality anime releases) |
| 🌐 | 6 streaming sources : Anime-Sama, GoldenAnime, French-Manga, GoldenMS, French-Stream, Nyaa |
| 🎮 | 4 player backends : mpv, VLC, browser, download-only |
| 🇫🇷 | French UI : the whole CLI is in French when language is set to FR |
| 🛡 | Anti-crash mpv config : ytdl-hook off, gpu renderer, no infinite reconnect |
| 🎨 | Anime4K pre-bundled with runtime toggle CTRL+1 / CTRL+0 |
| 🩺 | freeflix --doctor system diagnostic (check deps, config, network) |
📦 Installation
🚀 One-liner (anything with Python ≥ 3.9)
No git, no package manager, no sudo needed. Just Python (or PowerShell on Windows).
# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.py | python3
# Windows (PowerShell)
powershell -c "iwr -useb https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.ps1 | iex"
This installs uv if missing, then freeflix-cli.
From PyPI (if you already have the system deps)
If mpv, yt-dlp, ffmpeg, aria2 and libnotify are installed :
uv tool install freeflix-cli # recommended
# or
pipx install freeflix-cli
# or
pip install --user freeflix-cli
Then :
freeflix
Linux (install script — system deps + Anime4K shaders)
git clone https://github.com/freedy237/freeflix-cli.git
cd freeflix-cli
chmod +x scripts/install.sh
./scripts/install.sh
macOS (install script — system deps + Anime4K shaders)
git clone https://github.com/freedy237/freeflix-cli.git
cd freeflix-cli
chmod +x scripts/install-mac.sh
./scripts/install-mac.sh
Windows (install script — system deps + Anime4K shaders)
git clone https://github.com/freedy237/freeflix-cli.git
cd freeflix-cli
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
From source (developer mode)
git clone https://github.com/freedy237/freeflix-cli.git
cd freeflix-cli
uv pip install -e .
Upgrading on Windows (read this first)
On Windows there are two distribution channels — pick one:
uv toolinstall → upgrade withuv tool upgrade freeflix-cli(close FreeFlix first, locked files break the upgrade)- standalone
freeflix-windows-x86_64.exe→ re-download it from GitHub Releases (no package command can update the .exe)
If the version looks new but players/search behave like the old one
(mixed install — a second install shadowing PATH or a partial upgrade),
run freeflix --doctor and check the INSTALL section, then clean up:
where.exe freeflix
uv tool uninstall freeflix-cli
uv tool install freeflix-cli
🚀 Usage
freeflix
That's it. The menu walks you through everything.
Common keyboard shortcuts in mpv
| Key | Action |
|---|---|
| CTRL + 1 | Enable Anime4K Mode A_VL |
| CTRL + 0 | Disable Anime4K |
# |
Cycle audio track |
j |
Cycle subtitle track |
_ (Shift + -) |
Cycle video track |
| ALT + V | Cycle video track (alias) |
| ALT + 1 / 2 / 3 | Force video track #1 / #2 / #3 |
| ALT + T | Show track diagnostics |
i |
Toggle mpv stats overlay |
Hybrid laptops (Intel/AMD iGPU + Nvidia dGPU)
If you're on a Linux Optimus laptop, FreeFlix detects the dGPU (Nvidia via nvidia-smi, AMD via lspci) and routes mpv onto it automatically (no FPS drop with Anime4K). To also have this when launching mpv standalone (outside FreeFlix), copy the wrapper :
cp scripts/wrappers/mpv ~/.local/bin/mpv
chmod +x ~/.local/bin/mpv
(Make sure ~/.local/bin is in your $PATH before /usr/bin.)
The Linux install.sh does this for you when it detects an Nvidia card.
Settings menu
freeflix → ⚙ Settings (AniList) exposes :
- AniList Token — paste the OAuth token from anilist.co to enable sync ;
- Language — switches the UI (FR / EN) and default subtitle language ;
- Default Player — mpv / vlc / browser / download / manual ;
- Download Quality — auto / 1080 / 720 / 480 ;
- OpenSubtitles API Key — register free at opensubtitles.com/en/consumers ;
- Parallel Downloads — number of concurrent batch workers (1–4) ;
- Daily New-Episode Notifications — enables a
systemd --usertimer that scans Anime-Sama history once a day.
🤝 Credits
- Original project : autoflix-cli by PaulExplorer — all the heavy scraping lift comes from there.
- Anime4K shaders : bloc97/Anime4K.
- mpv : their respective authors.
- GitHub: @freedy237 — fork maintainer.
⚠️ Disclaimer
This notice is to inform you that FreeFlix functions strictly as an automated search tool and specialized browser. It fetches video file metadata and links from the internet in a manner similar to any standard web browser.
- No Hosting: FreeFlix does not host, store, or distribute any media files or copyrighted content. All content accessed through this tool is hosted by independent third-party websites.
- DMCA Compliance: This software does not violate the provisions of the Digital Millennium Copyright Act (DMCA) as it only provides access to publicly available links and does not store copies of any content on its own servers.
- User Responsibility: The use of this software and the legality of streaming content are the sole responsibility of the user, based on their respective country's or state's laws.
- Copyright Holders: If you believe any content accessed through this tool violates your intellectual property, please contact the actual file hosts or the websites providing the streams, as the developers of this repository have no control over or access to the hosted content.
This project is for educational purposes only.
📜 License
GNU General Public License v3.0 — same as upstream. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for freeflix-cli 1.11.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| freeflix_cli-1.11.6.tar.gz | 1.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| freeflix_cli-1.11.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / freeflix_cli-1.11.6.tar.gz
| Download URL | freeflix_cli-1.11.6.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6ba5ba6e4158209919cfbdd4812ad8b75622b3722b6203077fca85bd9ff8fc14
|
|
BLAKE2b-256 checksum How to use checksums |
08ef7bcf716f6e969da73a708610b98d3d278d3f26b4561b37d2d34cb6cbecc8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency logRelease files / freeflix_cli-1.11.6-py3-none-any.whl
| Download URL | freeflix_cli-1.11.6-py3-none-any.whl |
|---|---|
| Size | 269.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bf447f4dd15e49175ec98a2179abcb733eed2f4c8df8ecf49e89632c4863ee00
|
|
BLAKE2b-256 checksum How to use checksums |
720a4b3223d2d278ae412f48e085b4f2be3ab96ab040a1843571f3c2ad9c992e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 6, 2026.
Transparency log
