freeflix-cli 2.0.0__tar.gz → 2.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/.github/workflows/binaries.yml +37 -2
  2. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/.github/workflows/ci.yml +36 -6
  3. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/.github/workflows/release.yml +60 -1
  4. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/.gitignore +3 -0
  5. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/CHANGELOG.md +126 -0
  6. freeflix_cli-2.1.0/CONTRIBUTING.md +50 -0
  7. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/PKG-INFO +30 -7
  8. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/README.md +28 -5
  9. freeflix_cli-2.1.0/SECURITY.md +50 -0
  10. freeflix_cli-2.1.0/docs/ARCHITECTURE.md +72 -0
  11. freeflix_cli-2.1.0/docs/AUDIT-FREEFLIX-2.0-2026-11-04.md +440 -0
  12. freeflix_cli-2.1.0/docs/CORRECTIONS-2.1.0.md +77 -0
  13. freeflix_cli-2.1.0/docs/README.md +26 -0
  14. freeflix_cli-2.1.0/docs/RELEASE.md +83 -0
  15. freeflix_cli-2.1.0/docs/SCORECARD-2.1.0.md +47 -0
  16. freeflix_cli-2.1.0/docs/TROUBLESHOOTING.md +106 -0
  17. freeflix_cli-2.1.0/docs/USAGE.md +101 -0
  18. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/pyproject.toml +6 -2
  19. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/scripts/build-binary.sh +6 -1
  20. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/scripts/install-mac.sh +12 -7
  21. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/scripts/install.ps1 +15 -1
  22. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/scripts/install.py +23 -6
  23. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/scripts/install.sh +31 -23
  24. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/cli_utils.py +201 -822
  25. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/cloudflare.py +0 -2
  26. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/doctor.py +28 -8
  27. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/anime_sama.py +3 -0
  28. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/coflix.py +3 -0
  29. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/french_stream.py +3 -0
  30. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/goldenms.py +4 -4
  31. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/playback.py +26 -18
  32. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/history_ui.py +5 -0
  33. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/i18n.py +4 -0
  34. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/install_health.py +1 -1
  35. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/main.py +343 -327
  36. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/mpv_ipc.py +45 -7
  37. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/net_config.py +4 -4
  38. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/notifications.py +35 -14
  39. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/player_manager.py +97 -18
  40. freeflix_cli-2.1.0/src/freeflix_cli/preview_picker.py +738 -0
  41. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/progress.py +32 -10
  42. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/proxy.py +60 -6
  43. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/recent.py +10 -1
  44. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/config.py +8 -0
  45. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/french_stream.py +0 -2
  46. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/resilient.py +49 -0
  47. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/utils.py +20 -0
  48. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/setup_assistant.py +68 -18
  49. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/themes.py +8 -1
  50. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/tracker.py +25 -3
  51. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/ui.py +10 -5
  52. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/conftest.py +16 -1
  53. freeflix_cli-2.1.0/tests/test_audit_fixes.py +223 -0
  54. freeflix_cli-2.1.0/tests/test_core_units.py +191 -0
  55. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_download_integration.py +1 -1
  56. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_keyboard.py +30 -0
  57. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_managed_binaries.py +7 -3
  58. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_mouse.py +81 -57
  59. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_mpv_ipc.py +33 -2
  60. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_nerd_font.py +5 -8
  61. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_proxy_integration.py +14 -6
  62. freeflix_cli-2.1.0/tests/test_release_config.py +78 -0
  63. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_stream_analysis.py +3 -2
  64. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_system_deps_cache.py +5 -1
  65. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/uv.lock +7 -11
  66. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/LICENSE +0 -0
  67. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/assets/logo.png +0 -0
  68. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/config/freeflix_position.lua +0 -0
  69. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/config/input.conf +0 -0
  70. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/config/mpv.conf +0 -0
  71. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/data/selectors.jsonc +0 -0
  72. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/data/source_portal.jsonc +0 -0
  73. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/scripts/wrappers/mpv +0 -0
  74. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/__init__.py +0 -0
  75. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/__main__.py +0 -0
  76. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/anilist.py +0 -0
  77. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/cli.py +0 -0
  78. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/config_loader.py +0 -0
  79. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/defaults.py +0 -0
  80. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/__init__.py +0 -0
  81. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/anilist.py +0 -0
  82. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/french_manga.py +0 -0
  83. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/goldenanime.py +0 -0
  84. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/hianime.py +0 -0
  85. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/nyaa.py +0 -0
  86. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/papystreaming.py +0 -0
  87. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/handlers/yts.py +0 -0
  88. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/health.py +0 -0
  89. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/httpcache.py +0 -0
  90. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/icons.py +0 -0
  91. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/languages.py +0 -0
  92. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/logsetup.py +0 -0
  93. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/motion.py +0 -0
  94. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/neon.py +0 -0
  95. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/platform_android.py +0 -0
  96. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/providers_registry.py +0 -0
  97. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/__init__.py +0 -0
  98. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/anime_sama.py +0 -0
  99. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/anime_sama_planning.py +0 -0
  100. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/coflix.py +0 -0
  101. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/deobfuscate.py +0 -0
  102. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/eztv.py +0 -0
  103. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/french_manga.py +0 -0
  104. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/goldenanime.py +0 -0
  105. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/goldenms.py +0 -0
  106. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/nyaa.py +0 -0
  107. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/objects.py +0 -0
  108. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/papystreaming.py +0 -0
  109. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/player.py +0 -0
  110. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/subtitles.py +0 -0
  111. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/scraping/yts.py +0 -0
  112. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/splash.py +0 -0
  113. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/subtitles.py +0 -0
  114. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/terminal_image.py +0 -0
  115. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/src/freeflix_cli/update_checker.py +0 -0
  116. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_android_setup.py +0 -0
  117. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_anilist_errors.py +0 -0
  118. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_anilist_token_input.py +0 -0
  119. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_anime_sama_planning.py +0 -0
  120. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_batch_download.py +0 -0
  121. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_coflix_parse.py +0 -0
  122. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_cover_cache.py +0 -0
  123. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_decoy_stream.py +0 -0
  124. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_download_fixes.py +0 -0
  125. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_download_robustness.py +0 -0
  126. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_episode_parsing.py +0 -0
  127. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_fsvid_decode.py +0 -0
  128. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_health.py +0 -0
  129. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_httpcache.py +0 -0
  130. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_i18n_complete.py +0 -0
  131. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_navigation.py +0 -0
  132. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_nyaa.py +0 -0
  133. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_pack_a_polish.py +0 -0
  134. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_performance.py +0 -0
  135. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_platform_android.py +0 -0
  136. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_player_dash.py +0 -0
  137. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_polish.py +0 -0
  138. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_premium_players.py +0 -0
  139. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_providers_repair.py +0 -0
  140. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_proxy_endpoint.py +0 -0
  141. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_proxy_resilient.py +0 -0
  142. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_proxy_ssrf.py +0 -0
  143. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_recent_new_episodes.py +0 -0
  144. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_resilient.py +0 -0
  145. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_scraper_resilience.py +0 -0
  146. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_search_parity.py +0 -0
  147. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_sendvid.py +0 -0
  148. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_stream_integrity.py +0 -0
  149. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_terminal_image.py +0 -0
  150. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_update_prompt.py +0 -0
  151. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_v1105_improvements.py +0 -0
  152. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tests/test_v2_aesthetic.py +0 -0
  153. {freeflix_cli-2.0.0 → freeflix_cli-2.1.0}/tools/audit_providers.py +0 -0
@@ -1,11 +1,19 @@
1
1
  name: Binaries
2
2
 
3
3
  # Build a standalone executable (no Python needed) for Linux / Windows / macOS
4
- # and attach it to the GitHub Release. Runs after a release is published.
4
+ # and attach it to the matching GitHub Release.
5
+ #
6
+ # Triggered explicitly by release.yml (`gh workflow run binaries.yml -f tag=…`)
7
+ # because a `release: published` event created with GITHUB_TOKEN does not start
8
+ # another workflow. The `release` trigger is kept for manual/PAT releases.
5
9
  on:
10
+ workflow_dispatch:
11
+ inputs:
12
+ tag:
13
+ description: "Tag to build (e.g. v2.1.0)"
14
+ required: true
6
15
  release:
7
16
  types: [published]
8
- workflow_dispatch:
9
17
 
10
18
  permissions:
11
19
  contents: write
@@ -20,18 +28,27 @@ jobs:
20
28
  include:
21
29
  - os: ubuntu-latest
22
30
  name: linux-x86_64
31
+ sep: ":"
23
32
  - os: windows-latest
24
33
  name: windows-x86_64
34
+ sep: ";"
25
35
  - os: macos-latest
26
36
  name: macos-arm64
37
+ sep: ":"
27
38
  steps:
28
39
  - uses: actions/checkout@v4
40
+ with:
41
+ ref: ${{ inputs.tag || github.event.release.tag_name }}
29
42
  - uses: astral-sh/setup-uv@v3
30
43
  - uses: actions/setup-python@v5
31
44
  with:
32
45
  python-version: '3.12'
33
46
 
34
47
  - name: Build with PyInstaller
48
+ shell: bash
49
+ env:
50
+ # PyInstaller's --add-data separator is ";" on Windows, ":" elsewhere.
51
+ PYI_SEP: ${{ matrix.sep }}
35
52
  run: >
36
53
  uv run --with . --with pyinstaller --with lxml
37
54
  pyinstaller --onefile --name freeflix
@@ -41,6 +58,8 @@ jobs:
41
58
  --copy-metadata readchar
42
59
  --copy-metadata freeflix-cli
43
60
  --copy-metadata curl_cffi
61
+ --add-data "data/source_portal.jsonc${PYI_SEP}data"
62
+ --add-data "data/selectors.jsonc${PYI_SEP}data"
44
63
  src/freeflix_cli/__main__.py
45
64
 
46
65
  - name: Smoke-test the binary
@@ -48,6 +67,10 @@ jobs:
48
67
  run: |
49
68
  if [ -f dist/freeflix.exe ]; then BIN=dist/freeflix.exe; else BIN=dist/freeflix; fi
50
69
  "$BIN" --version
70
+ # --version short-circuits before importing rich/curl_cffi: also run
71
+ # --doctor so a bundle missing a real dependency fails here, not at
72
+ # the user's first launch.
73
+ "$BIN" --doctor > /dev/null
51
74
 
52
75
  - name: Name the artifact
53
76
  shell: bash
@@ -59,7 +82,19 @@ jobs:
59
82
  mv freeflix "freeflix-${{ matrix.name }}"
60
83
  fi
61
84
 
85
+ - name: Checksum the executable
86
+ shell: bash
87
+ run: |
88
+ cd dist
89
+ if command -v sha256sum >/dev/null 2>&1; then
90
+ sha256sum freeflix-${{ matrix.name }}* > freeflix-${{ matrix.name }}.sha256
91
+ else
92
+ # macOS has shasum, not sha256sum
93
+ shasum -a 256 freeflix-${{ matrix.name }}* > freeflix-${{ matrix.name }}.sha256
94
+ fi
95
+
62
96
  - name: Attach to the release
63
97
  uses: softprops/action-gh-release@v2
64
98
  with:
99
+ tag_name: ${{ inputs.tag || github.event.release.tag_name }}
65
100
  files: dist/freeflix-${{ matrix.name }}*
@@ -1,7 +1,7 @@
1
1
  name: CI
2
2
 
3
- # Lint + tests on every push and PR, on Linux AND Windows, so regressions
4
- # (e.g. the Windows arrow-key breakage) are caught before release.
3
+ # Lint + tests on every push and PR, on Linux, Windows AND macOS, so
4
+ # regressions (e.g. the Windows arrow-key breakage) are caught before release.
5
5
  on:
6
6
  push:
7
7
  branches: [main]
@@ -16,6 +16,7 @@ jobs:
16
16
  test:
17
17
  name: Lint + tests (${{ matrix.os }}, py${{ matrix.python-version }})
18
18
  runs-on: ${{ matrix.os }}
19
+ timeout-minutes: 30
19
20
  strategy:
20
21
  fail-fast: false
21
22
  matrix:
@@ -24,6 +25,13 @@ jobs:
24
25
  # Python so the compatibility job stays meaningful.
25
26
  os: [ubuntu-22.04, windows-latest]
26
27
  python-version: ['3.9', '3.12']
28
+ include:
29
+ - os: macos-latest
30
+ python-version: '3.12'
31
+ - os: ubuntu-22.04
32
+ python-version: '3.11'
33
+ - os: ubuntu-22.04
34
+ python-version: '3.13'
27
35
  steps:
28
36
  - name: Checkout
29
37
  uses: actions/checkout@v4
@@ -37,7 +45,7 @@ jobs:
37
45
  python-version: ${{ matrix.python-version }}
38
46
 
39
47
  - name: Ruff (real-bug checks)
40
- run: uvx ruff check --select E,W,F,B --ignore E501,E402 src/freeflix_cli/
48
+ run: uvx ruff==0.17.3 check --select E,W,F,B --ignore E501,E402 src/freeflix_cli/
41
49
 
42
50
  - name: Import every module
43
51
  run: >
@@ -46,11 +54,33 @@ jobs:
46
54
  pkgutil.walk_packages(freeflix_cli.__path__,'freeflix_cli.')];
47
55
  print('all modules import OK')"
48
56
 
57
+ - name: Shell syntax (Linux/macOS)
58
+ if: runner.os != 'Windows'
59
+ run: bash -n scripts/install.sh scripts/install-mac.sh scripts/build-binary.sh
60
+
61
+ - name: PowerShell syntax (Windows)
62
+ if: runner.os == 'Windows'
63
+ shell: pwsh
64
+ run: |
65
+ $null = [scriptblock]::Create((Get-Content -Raw scripts/install.ps1))
66
+ Write-Host "install.ps1 parses"
67
+
49
68
  - name: Pytest (+ coverage ratchet)
50
69
  # Coverage is a REGRESSION ratchet, not a quality gate: the floor is set
51
70
  # near today's level so a PR that drops coverage fails, while the (large,
52
71
  # hard-to-test TUI/scraper) untested surface doesn't block the build.
53
- # Raise --cov-fail-under over time as more tests land.
72
+ # The floor is now 40 (measured ~45); raise it again after adding tests.
54
73
  run: >
55
- uv run --with . --with pytest --with pytest-cov -m pytest -q
56
- --cov=freeflix_cli --cov-report=term-missing --cov-fail-under=15
74
+ uv run --with . --with pytest --with pytest-cov --with pytest-timeout
75
+ -m pytest -q --timeout=120
76
+ --cov=freeflix_cli --cov-report=term-missing --cov-fail-under=40
77
+
78
+ - name: Build the wheel and smoke-test it
79
+ # Packaging is a real product surface: the JSONC data files live in
80
+ # share/freeflix-cli and a broken wheel only shows up after install.
81
+ if: matrix.os == 'ubuntu-22.04' && matrix.python-version == '3.12'
82
+ run: |
83
+ uv build
84
+ python -m venv /tmp/freeflix-wheel
85
+ /tmp/freeflix-wheel/bin/pip install --quiet dist/*.whl
86
+ /tmp/freeflix-wheel/bin/freeflix --version
@@ -9,11 +9,47 @@ on:
9
9
  # Required by both Trusted Publisher (OIDC) and the release-creation step.
10
10
  permissions:
11
11
  id-token: write # PyPI Trusted Publisher (no token needed)
12
- contents: write # to create the GitHub Release
12
+ contents: write # create the GitHub Release
13
+ actions: write # dispatch the Binaries workflow
13
14
 
14
15
  jobs:
16
+ # Gate: never publish a tag that does not pass the suite or whose version
17
+ # does not match pyproject.toml (PyPI refuses a duplicate, irreversibly).
18
+ test:
19
+ name: Test the tagged commit
20
+ runs-on: ubuntu-latest
21
+ steps:
22
+ - name: Checkout
23
+ uses: actions/checkout@v4
24
+
25
+ - name: Install uv
26
+ uses: astral-sh/setup-uv@v3
27
+
28
+ - name: Set up Python
29
+ uses: actions/setup-python@v5
30
+ with:
31
+ python-version: '3.12'
32
+
33
+ - name: Ruff
34
+ run: uvx ruff==0.17.3 check --select E,W,F,B --ignore E501,E402 src/freeflix_cli/
35
+
36
+ - name: Version matches the tag
37
+ run: |
38
+ python - <<'EOF'
39
+ import os, tomllib
40
+ version = tomllib.load(open("pyproject.toml", "rb"))["project"]["version"]
41
+ tag = os.environ["GITHUB_REF_NAME"].lstrip("v")
42
+ if version != tag:
43
+ raise SystemExit(f"tag {tag!r} != pyproject version {version!r}")
44
+ print(f"version OK: {version}")
45
+ EOF
46
+
47
+ - name: Pytest
48
+ run: uv run --with . --with pytest --with pytest-cov --with pytest-timeout -m pytest -q --timeout=120
49
+
15
50
  build-and-publish:
16
51
  name: Build, publish to PyPI, create GitHub Release
52
+ needs: test
17
53
  runs-on: ubuntu-latest
18
54
  # `environment: pypi` is what the PyPI Trusted Publisher setup looks for.
19
55
  environment:
@@ -37,12 +73,20 @@ jobs:
37
73
  - name: Build sdist + wheel
38
74
  run: uv build
39
75
 
76
+ - name: Check the metadata
77
+ run: uvx twine check dist/*
78
+
40
79
  - name: Publish to PyPI (Trusted Publisher OIDC)
41
80
  uses: pypa/gh-action-pypi-publish@release/v1
42
81
  with:
43
82
  # No `password:` — OIDC handles auth automatically
44
83
  packages-dir: dist/
45
84
 
85
+ # AFTER PyPI: the publish action uploads every file in dist/, and a
86
+ # SHA256SUMS file there is rejected as an unknown distribution format.
87
+ - name: Write checksums
88
+ run: cd dist && sha256sum *.whl *.tar.gz > SHA256SUMS
89
+
46
90
  - name: Generate release notes from commits
47
91
  id: notes
48
92
  run: |
@@ -77,6 +121,12 @@ jobs:
77
121
  echo 'powershell -c "iwr -useb https://raw.githubusercontent.com/freedy237/freeflix-cli/main/scripts/install.ps1 | iex"'
78
122
  echo '```'
79
123
  echo ""
124
+ echo "## Checksums"
125
+ echo ""
126
+ echo "\`\`\`"
127
+ cat dist/SHA256SUMS 2>/dev/null || true
128
+ echo "\`\`\`"
129
+ echo ""
80
130
  echo "## Upgrade an existing install"
81
131
  echo ""
82
132
  echo '```bash'
@@ -101,5 +151,14 @@ jobs:
101
151
  files: |
102
152
  dist/*.whl
103
153
  dist/*.tar.gz
154
+ dist/SHA256SUMS
104
155
  draft: false
105
156
  prerelease: ${{ contains(github.ref_name, '-') }} # rc/beta/alpha → prerelease
157
+
158
+ # A `release: published` event created with GITHUB_TOKEN does NOT start
159
+ # another workflow, so binaries.yml never ran. Dispatch it explicitly:
160
+ # workflow_dispatch IS allowed with GITHUB_TOKEN (actions: write).
161
+ - name: Build standalone binaries
162
+ env:
163
+ GH_TOKEN: ${{ github.token }}
164
+ run: gh workflow run binaries.yml -f tag="${GITHUB_REF_NAME}"
@@ -32,3 +32,6 @@ Thumbs.db
32
32
  # Runtime data that shouldn't be committed
33
33
  *.log
34
34
  *.bak
35
+ .ruff_cache/
36
+ .freebuff/
37
+ .mypy_cache/
@@ -1,5 +1,131 @@
1
1
  # Changelog
2
2
 
3
+ ## 2.1.0 — Fiabilité, sécurité et cohérence
4
+
5
+ Version de consolidation : l'audit complet de la 2.0.0 a été appliqué de bout
6
+ en bout, sans changement de fonctionnalité visible.
7
+
8
+ ### Téléchargements
9
+
10
+ - **Reprise séquentielle réparée** : `_verify_download()` renvoie
11
+ `(ok, reason)` ; le retry le comparait à `"ok"` et jetait chaque fichier
12
+ valide. La reprise repart maintenant des fragments déjà téléchargés et
13
+ conserve le fichier en `.incomplete` après le dernier échec.
14
+ - **Téléchargement atomique** : `_download()` écrit en `.part` puis
15
+ `os.replace` ; un transfert coupé ne laisse plus un faux fichier complet.
16
+ - **Garde-fou** : plafond de 6 h sur un sous-processus non-TTY figé ;
17
+ `terminate()` escalade en `kill()` après 5 s ; l'annulation atteint aussi
18
+ la reprise séquentielle.
19
+ - **Métadonnées de reprise assainies** : `Cookie`, `Authorization`,
20
+ `Proxy-Authorization`, `X-Api-Key` et `X-Auth-Token` sont retirés du JSON
21
+ `.freeflix-resume.json`, écrit en `0600`.
22
+ - **Noms de fichiers Windows** : noms réservés (`CON`, `NUL`, `COM1…`),
23
+ points/espaces finaux et caracteres de contrôle neutralisés.
24
+ - **Sous-titres temporaires** : les `freeflix_sub_*` / `freeflix_os_*` de plus
25
+ de 24 h sont balayés au démarrage.
26
+
27
+ ### Sécurité
28
+
29
+ - **En-têtes du proxy opaques** : les cookies de gate (`vz_ok`, `fsv_pe`, …)
30
+ ne sont plus sérialisés en JSON dans les URLs des manifestes ; un jeton
31
+ local de 24 caractères les remplace (anciennes URLs toujours acceptées).
32
+ - **TLS DoH vérifié** : le repli DNS ne désactive plus la vérification du
33
+ certificat (MITM possible auparavant).
34
+ - **Toasts Windows** : le XML passe par un fichier temporaire au lieu d'être
35
+ interpolé entre quotes simples dans PowerShell (injection via un titre
36
+ piégé).
37
+ - **PATH Windows** : remplacement de `setx PATH … "%PATH%"` (littéral,
38
+ tronqué à 1024) par une écriture registre `REG_EXPAND_SZ` préservant les
39
+ variables.
40
+ - **URLs signées masquées** dans les messages (`?…`), plus de lien CDN
41
+ complet dans le terminal ou les logs.
42
+ - **Jeton de capacité du proxy** : chaque URL média porte `?k=<jeton>` propre
43
+ au processus ; un autre programme local ne peut plus utiliser le proxy comme
44
+ relais SSRF/en-têtes.
45
+ - **Checksums publiées** : `SHA256SUMS` pour le wheel/sdist et un `.sha256`
46
+ par binaire autonome.
47
+
48
+ ### Stabilité
49
+
50
+ - `progress.json` : validation de forme au chargement (une clé de type
51
+ inattendu ne bloque plus le démarrage) + tableau de bord protégé par
52
+ `try/except`.
53
+ - Sortie propre : `os._exit` remplacé par une restauration explicite du
54
+ terminal (souris, bracketed paste, curseur, écran alterné) puis
55
+ `SystemExit`.
56
+ - Souris Windows : activation de `ENABLE_VIRTUAL_TERMINAL_INPUT` sur stdin
57
+ (sans elle, `?1000h` était envoyé sans qu'aucun rapport n'arrive).
58
+ - Boucle infinie du fil d'Ariane corrigée sur terminal ≤ 8 colonnes ; EOF
59
+ sur stdin traité comme Esc (plus de boucle à 100 % CPU).
60
+ - `Esc` : les menus « Reprendre / Parcourir » ont maintenant une vraie ligne
61
+ « ← Retour », donc Esc ne déclenche plus l'action voisine.
62
+ - Registre des sources reconstruit au changement de langue : les noms de
63
+ sources sont traduits immédiatement, et les doublons de branches
64
+ HiAnime/GoldenAnime ont disparu.
65
+ - Déduplication des lecteurs : deux pistes de langue distinctes du même hôte
66
+ (« voe vostfr » / « voe vff ») ne sont plus fusionnées.
67
+ - Reprise de flux : plafond de 5 min sans octet (le buffering infini cachait
68
+ un CDN mort).
69
+ - Analyse des lecteurs : budget porté à 55 s (60 s pour le menu étendu) et
70
+ cache qualité ramené à 5 min pour ne pas servir un lien signé périmé.
71
+ - mpv IPC Windows : lecture du named pipe via thread + file d'attente, donc
72
+ `stop()` et les timeouts ne bloquent plus.
73
+ - macOS : chemins de socket AF_UNIX raccourcis (limite de 104 octets) avec
74
+ repli sur `/tmp` quand `TMPDIR` est long.
75
+
76
+ ### Installation / multi-OS
77
+
78
+ - `setup_done` n'est plus posé si les fichiers mpv ou les shaders ont échoué :
79
+ le wizard réessaie au lancement suivant.
80
+ - `--doctor` : ffmpeg est testé avec `-version` (plus de faux « BROKEN ») et
81
+ le dossier inspecté est bien `~/.config/freeflix/mpv`.
82
+ - macOS : `install-mac.sh` écrit dans le dossier FreeFlix (et non le mpv
83
+ global) ; builds mpv **arm64** natifs sur Apple Silicon et Windows ARM.
84
+ - Installeurs : paquets système installés un par un (un paquet optionnel
85
+ manquant n'annule plus tout), TLS 1.2/1.3 explicite et uv ARM64 sur
86
+ Windows, shaders S + VL installés comme le charge `mpv.conf`.
87
+ - `selectors.jsonc` embarqué est enfin lu au démarrage (il n'était que
88
+ téléchargé à distance) ; chemins PyInstaller ajoutés (`--add-data`).
89
+
90
+ ### UI / accessibilité
91
+
92
+ - `selection_text` retombe sur `black` (et non `white`) pour les thèmes
93
+ anciens ; le wordmark suit le thème actif au lieu de rester ambre.
94
+ - `skeleton()` respecte `reduce motion` (une seule image statique).
95
+ - Le tableau de bord n'écrit plus `progress.json` à chaque repaint.
96
+ - `--version` / `--help` / `--doctor` ne sont plus implémentés deux fois.
97
+ - `select_with_preview` (787 lignes) est extrait dans `preview_picker.py` :
98
+ `cli_utils.py` passe de 2 896 à 2 166 lignes, avec un ré-export paresseux
99
+ pour ne pas casser les imports existants.
100
+ - Le preview utilise désormais **le décodeur clavier partagé** (timeout
101
+ inclus) : le troisième décodeur, avec sa propre gestion du collage et de
102
+ l'ESC, a disparu.
103
+ - **Filtre protégé des rapports souris** : un rapport SGR coupé en fin de
104
+ lecture est conservé puis complété au lieu d'être tapé (`/ 4;10M…`) ; le
105
+ mode filtre coupe le suivi souris et le champ de recherche utilise un suivi
106
+ « clic seulement » (pas de flood de mouvement).
107
+ - Le menu **Réglages** (290 lignes) est extrait de `main()` : la boucle
108
+ d'accueil passe de 660 à 359 lignes.
109
+
110
+ ### CI / release / tests
111
+
112
+ - La release exige désormais la suite de tests, le lint, et
113
+ `pyproject.version == tag` ; `twine check` avant publication.
114
+ - Binaires : déclenchement explicite par `workflow_dispatch` depuis la
115
+ release (l'événement `release: published` créé par `GITHUB_TOKEN` ne
116
+ démarrait aucun workflow), `--add-data`, smoke test `--doctor`.
117
+ - CI étendue à macOS et Python 3.11/3.13 ; build du wheel et smoke test
118
+ d'installation.
119
+ - Tests : isolation du dossier de binaires gérés (plus de `rmtree` réel),
120
+ suite offline (plus de GET GitHub), 16 tests de non-régression pour cet
121
+ audit.
122
+ - Couverture mesurée ~45 %, plancher CI relevé de 15 à **40 %** ;
123
+ `pytest-timeout` (120 s) et `ruff==0.17.3` épinglé dans la CI.
124
+ - Tests dédiés `cli.py`, `doctor.py`, `providers_registry`, `config_loader`,
125
+ `install_health`, thèmes/UI, métadonnées de reprise, noms Windows, garde-fous
126
+ de release et IPC Windows.
127
+ - 585 tests au vert, ruff OK.
128
+
3
129
  ## 2.0.0 — Cinéma Noir
4
130
 
5
131
  - **Nouvelle identité visuelle** : **Cinema Noir** devient le thème par
@@ -0,0 +1,50 @@
1
+ # Contributing
2
+
3
+ FreeFlix is a fork of [autoflix-cli](https://github.com/PaulExplorer/autoflix-cli);
4
+ thank you to its author for the original scraping foundation.
5
+
6
+ ## Ground rules
7
+
8
+ - **French UI, English source.** Every user-facing string goes through
9
+ `t("English source")` and needs an entry in `_FR` (`src/freeflix_cli/i18n.py`).
10
+ `tests/test_i18n_complete.py` fails otherwise.
11
+ - **Icons, not emoji.** Use `icon("name")` / `iconify(text)`, never a decorative
12
+ emoji in a menu.
13
+ - **One Back = one level.** Handlers keep their own navigation state; Esc and
14
+ the last menu row must return exactly one screen up.
15
+ - **No hard-coded colour.** Use `themes.color(role)` or the `ui.py` primitives.
16
+ - **Never publish from a dirty tree.** Local mirror first, tests green, then
17
+ the release process in [docs/RELEASE.md](docs/RELEASE.md).
18
+
19
+ ## Development
20
+
21
+ ```bash
22
+ uv sync
23
+ uv run freeflix
24
+ uv run --with pytest --with pytest-cov -m pytest -q
25
+ uvx ruff check --select E,W,F,B --ignore E501,E402 src/freeflix_cli/
26
+ ```
27
+
28
+ - The suite is offline. Mock HTTP (`_get`, `requests.get`) and `subprocess`
29
+ instead of hitting the network.
30
+ - A site change is usually a selector: edit `DEFAULT_SELECTORS` in
31
+ `scraping/resilient.py`, and optionally `data/selectors.jsonc` for a
32
+ release-free hot patch.
33
+ - A new provider: add `handlers/<name>.py` + `scraping/<name>.py`, register it
34
+ in `main._register_providers()` with its `supported_languages`, and add a
35
+ parsing test with a saved HTML fixture.
36
+
37
+ ## Adding a fix
38
+
39
+ 1. Reproduce with a test (prefer a focused unit test over a network test).
40
+ 2. Fix the smallest surface.
41
+ 3. Run the full suite and ruff.
42
+ 4. Add the user-visible change to `CHANGELOG.md`.
43
+ 5. If the change touches one OS only, say so explicitly in the commit message:
44
+ Windows/macOS behaviour cannot be validated by the Linux CI job alone.
45
+
46
+ ## Reporting a broken source
47
+
48
+ Run `freeflix --doctor --sources` (live search + resolve for every source) and
49
+ include the failing source, the error line, and the date. Most breakages are
50
+ one selector or one rotated domain.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: freeflix-cli
3
- Version: 2.0.0
3
+ Version: 2.1.0
4
4
  Summary: Watch movies, series, and anime from your terminal — multi-language, multi-source, no browser required. A maintained fork of autoflix-cli.
5
5
  Project-URL: Homepage, https://github.com/freedy237/freeflix-cli
6
6
  Project-URL: Repository, https://github.com/freedy237/freeflix-cli.git
@@ -26,7 +26,7 @@ Requires-Dist: m3u8>=6.0.0
26
26
  Requires-Dist: platformdirs>=4.0.0
27
27
  Requires-Dist: pycryptodome>=3.23.0
28
28
  Requires-Dist: readchar>=4.2.1
29
- Requires-Dist: rich>=14.2.0
29
+ Requires-Dist: rich<15,>=14.2.0
30
30
  Provides-Extra: speed
31
31
  Description-Content-Type: text/markdown
32
32
 
@@ -38,6 +38,7 @@ Description-Content-Type: text/markdown
38
38
 
39
39
  <p align="center">
40
40
  <a href="https://pypi.org/project/freeflix-cli/"><img src="https://img.shields.io/pypi/v/freeflix-cli.svg?color=blue" alt="PyPI version"></a>
41
+ <a href="https://github.com/freedy237/freeflix-cli/actions/workflows/ci.yml"><img src="https://github.com/freedy237/freeflix-cli/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
41
42
  <a href="https://pypi.org/project/freeflix-cli/"><img src="https://img.shields.io/pypi/pyversions/freeflix-cli.svg" alt="Python"></a>
42
43
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-GPLv3-blue.svg" alt="License: GPL v3"></a>
43
44
  </p>
@@ -61,8 +62,11 @@ Description-Content-Type: text/markdown
61
62
 
62
63
  - **One command, everything works** — installs its own mpv/ffmpeg/yt-dlp and a
63
64
  Nerd Font; no browser, no ads, no accounts required.
64
- - **Everything, always up to date** — movies & series (TMDB-based) and anime
65
- (Anime-Sama), in **French (VF/VOSTFR)** or **VO**.
65
+ - **Everything, always up to date** — anime (Anime-Sama, HiAnime,
66
+ GoldenAnime), films & series (GoldenMS, Coflix, French-Stream, YTS/EZTV),
67
+ in **French (VF/VOSTFR)** or **VO**.
68
+ - **Live planning & Nouveautés** — the Anime-Sama weekly schedule, and a feed
69
+ of new episodes for the shows you follow.
66
70
  - **Actually nice to use** — poster previews in the terminal (chafa), breadcrumb
67
71
  navigation, `/` to filter, `Esc` to go back anywhere, `?` for help.
68
72
  - **Download & keep** — pick a quality, batch a whole season into its own folder,
@@ -83,7 +87,7 @@ Description-Content-Type: text/markdown
83
87
  - **Daily new-episode notifications** via systemd timer + libnotify ;
84
88
  - A **Nyaa torrent provider** (downloads via aria2 BitTorrent) ;
85
89
  - A **Local Downloads browser** in the home menu ;
86
- - **Anime4K Mode A_VL** shaders pre-bundled (toggle CTRL+1 / CTRL+0) ;
90
+ - **Anime4K** shaders pre-bundled (S by default, VL with CTRL+1, off with CTRL+0) ;
87
91
  - **French localisation** of the whole UI (auto-switched based on language pref) ;
88
92
  - Multi-mirror portal fallback + `website_origin` caching (24 h TTL) ;
89
93
  - 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.
@@ -104,12 +108,17 @@ Description-Content-Type: text/markdown
104
108
  | ⚡ | **Parallel downloads** (up to 4 concurrent episodes) |
105
109
  | 🔔 | **Daily notifications** when new episodes drop |
106
110
  | 🌊 | **Nyaa.si torrents** (high-quality anime releases) |
107
- | 🌐 | **6 streaming sources** : Anime-Sama, GoldenAnime, French-Manga, GoldenMS, French-Stream, Nyaa |
111
+ | 🌐 | **10 streaming sources** : Anime-Sama, French-Anime, HiAnime, GoldenAnime, GoldenMS, Papystreaming, French-Stream, Coflix, YTS/EZTV, Nyaa |
112
+ | 🗓 | **Anime-Sama planning** live (7 days, posters, follow a show without watching it) |
113
+ | 🆕 | **Nouveautés** : new episodes of the shows you follow, cleared once watched |
114
+ | 🖱 | **Full mouse control** : hover, click, wheel, right-click back, clickable pagination |
115
+ | 🎨 | **Cinema Noir** (2.0) design system, 12 themes, reduced-motion support |
108
116
  | 🎮 | **4 player backends** : mpv, VLC, browser, download-only |
109
117
  | 🇫🇷 | **French UI** : the whole CLI is in French when language is set to FR |
110
118
  | 🛡 | **Anti-crash mpv config** : ytdl-hook off, gpu renderer, no infinite reconnect |
111
119
  | 🎨 | **Anime4K** pre-bundled with runtime toggle CTRL+1 / CTRL+0 |
112
120
  | 🩺 | **`freeflix --doctor`** system diagnostic (check deps, config, network) |
121
+ | 🔄 | **Startup updater** : asks yes/no, upgrades with the same installer (uv/pipx/pip), reloads |
113
122
 
114
123
  ---
115
124
 
@@ -178,9 +187,23 @@ powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
178
187
  ```bash
179
188
  git clone https://github.com/freedy237/freeflix-cli.git
180
189
  cd freeflix-cli
181
- uv pip install -e .
190
+ uv sync # dev environment (Python 3.12 recommended)
191
+ uv run freeflix # launch from the checkout
182
192
  ```
183
193
 
194
+ Run the suite and the same lint as CI before touching a scraper:
195
+
196
+ ```bash
197
+ uv run --with pytest --with pytest-cov --with pytest-timeout -m pytest -q --timeout=120
198
+ uvx ruff check --select E,W,F,B --ignore E501,E402 src/freeflix_cli/
199
+ freeflix --doctor --sources # live audit of every source (needs network)
200
+ ```
201
+
202
+ The architecture, usage, troubleshooting and release process are documented
203
+ in [`docs/`](docs/README.md). Tests are offline by design; the only network
204
+ checks live in `tools/audit_providers.py` and `--doctor --sources`.
205
+ Security model and reporting: [`SECURITY.md`](SECURITY.md).
206
+
184
207
  ### Upgrading on Windows (read this first)
185
208
 
186
209
  On Windows there are two distribution channels — pick **one**:
@@ -6,6 +6,7 @@
6
6
 
7
7
  <p align="center">
8
8
  <a href="https://pypi.org/project/freeflix-cli/"><img src="https://img.shields.io/pypi/v/freeflix-cli.svg?color=blue" alt="PyPI version"></a>
9
+ <a href="https://github.com/freedy237/freeflix-cli/actions/workflows/ci.yml"><img src="https://github.com/freedy237/freeflix-cli/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
9
10
  <a href="https://pypi.org/project/freeflix-cli/"><img src="https://img.shields.io/pypi/pyversions/freeflix-cli.svg" alt="Python"></a>
10
11
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-GPLv3-blue.svg" alt="License: GPL v3"></a>
11
12
  </p>
@@ -29,8 +30,11 @@
29
30
 
30
31
  - **One command, everything works** — installs its own mpv/ffmpeg/yt-dlp and a
31
32
  Nerd Font; no browser, no ads, no accounts required.
32
- - **Everything, always up to date** — movies & series (TMDB-based) and anime
33
- (Anime-Sama), in **French (VF/VOSTFR)** or **VO**.
33
+ - **Everything, always up to date** — anime (Anime-Sama, HiAnime,
34
+ GoldenAnime), films & series (GoldenMS, Coflix, French-Stream, YTS/EZTV),
35
+ in **French (VF/VOSTFR)** or **VO**.
36
+ - **Live planning & Nouveautés** — the Anime-Sama weekly schedule, and a feed
37
+ of new episodes for the shows you follow.
34
38
  - **Actually nice to use** — poster previews in the terminal (chafa), breadcrumb
35
39
  navigation, `/` to filter, `Esc` to go back anywhere, `?` for help.
36
40
  - **Download & keep** — pick a quality, batch a whole season into its own folder,
@@ -51,7 +55,7 @@
51
55
  - **Daily new-episode notifications** via systemd timer + libnotify ;
52
56
  - A **Nyaa torrent provider** (downloads via aria2 BitTorrent) ;
53
57
  - A **Local Downloads browser** in the home menu ;
54
- - **Anime4K Mode A_VL** shaders pre-bundled (toggle CTRL+1 / CTRL+0) ;
58
+ - **Anime4K** shaders pre-bundled (S by default, VL with CTRL+1, off with CTRL+0) ;
55
59
  - **French localisation** of the whole UI (auto-switched based on language pref) ;
56
60
  - Multi-mirror portal fallback + `website_origin` caching (24 h TTL) ;
57
61
  - 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.
@@ -72,12 +76,17 @@
72
76
  | ⚡ | **Parallel downloads** (up to 4 concurrent episodes) |
73
77
  | 🔔 | **Daily notifications** when new episodes drop |
74
78
  | 🌊 | **Nyaa.si torrents** (high-quality anime releases) |
75
- | 🌐 | **6 streaming sources** : Anime-Sama, GoldenAnime, French-Manga, GoldenMS, French-Stream, Nyaa |
79
+ | 🌐 | **10 streaming sources** : Anime-Sama, French-Anime, HiAnime, GoldenAnime, GoldenMS, Papystreaming, French-Stream, Coflix, YTS/EZTV, Nyaa |
80
+ | 🗓 | **Anime-Sama planning** live (7 days, posters, follow a show without watching it) |
81
+ | 🆕 | **Nouveautés** : new episodes of the shows you follow, cleared once watched |
82
+ | 🖱 | **Full mouse control** : hover, click, wheel, right-click back, clickable pagination |
83
+ | 🎨 | **Cinema Noir** (2.0) design system, 12 themes, reduced-motion support |
76
84
  | 🎮 | **4 player backends** : mpv, VLC, browser, download-only |
77
85
  | 🇫🇷 | **French UI** : the whole CLI is in French when language is set to FR |
78
86
  | 🛡 | **Anti-crash mpv config** : ytdl-hook off, gpu renderer, no infinite reconnect |
79
87
  | 🎨 | **Anime4K** pre-bundled with runtime toggle CTRL+1 / CTRL+0 |
80
88
  | 🩺 | **`freeflix --doctor`** system diagnostic (check deps, config, network) |
89
+ | 🔄 | **Startup updater** : asks yes/no, upgrades with the same installer (uv/pipx/pip), reloads |
81
90
 
82
91
  ---
83
92
 
@@ -146,9 +155,23 @@ powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
146
155
  ```bash
147
156
  git clone https://github.com/freedy237/freeflix-cli.git
148
157
  cd freeflix-cli
149
- uv pip install -e .
158
+ uv sync # dev environment (Python 3.12 recommended)
159
+ uv run freeflix # launch from the checkout
150
160
  ```
151
161
 
162
+ Run the suite and the same lint as CI before touching a scraper:
163
+
164
+ ```bash
165
+ uv run --with pytest --with pytest-cov --with pytest-timeout -m pytest -q --timeout=120
166
+ uvx ruff check --select E,W,F,B --ignore E501,E402 src/freeflix_cli/
167
+ freeflix --doctor --sources # live audit of every source (needs network)
168
+ ```
169
+
170
+ The architecture, usage, troubleshooting and release process are documented
171
+ in [`docs/`](docs/README.md). Tests are offline by design; the only network
172
+ checks live in `tools/audit_providers.py` and `--doctor --sources`.
173
+ Security model and reporting: [`SECURITY.md`](SECURITY.md).
174
+
152
175
  ### Upgrading on Windows (read this first)
153
176
 
154
177
  On Windows there are two distribution channels — pick **one**: