fetchforge 2.0.0__tar.gz → 2.3.1__tar.gz

{fetchforge-2.0.0 → fetchforge-2.3.1}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Petur Bjarnason
+Copyright (c) 2026 prekabreki
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{fetchforge-2.0.0 → fetchforge-2.3.1}/MANIFEST.in

@@ -1,3 +1,5 @@
 include fetchforge/index.html
+include fetchforge/app.css
+include fetchforge/app.js
 include LICENSE
 include README.md

{fetchforge-2.0.0 → fetchforge-2.3.1}/PKG-INFO

@@ -1,17 +1,23 @@
 Metadata-Version: 2.4
 Name: fetchforge
-Version: 2.0.0
+Version: 2.3.1
 Summary: Download YouTube videos and transcode to H.265/HEVC with NVIDIA NVENC — a localhost web app.
-Author: Petur Bjarnason
+Author-email: prekabreki <prekabreki@users.noreply.github.com>
 License: MIT
-Project-URL: Homepage, https://github.com/prekabreki/fetchforge
+Project-URL: Homepage, https://github.com/prekabreki/FetchForge
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: fastapi
-Requires-Dist: uvicorn
-Requires-Dist: python-multipart
+Requires-Dist: fastapi>=0.143
+Requires-Dist: uvicorn>=0.54
+Requires-Dist: python-multipart>=0.0.32
 Requires-Dist: yt-dlp[default]
+Provides-Extra: test
+Requires-Dist: httpx; extra == "test"
+Requires-Dist: ruff; extra == "test"
+Requires-Dist: build; extra == "test"
+Requires-Dist: setuptools>=68; extra == "test"
+Requires-Dist: wheel; extra == "test"
 Dynamic: license-file
 
 # FetchForge
@@ -35,7 +41,8 @@ pip install fetchforge
 fetchforge
 ```
 
-The browser opens automatically at `http://localhost:8765`. On Windows, if an
+The browser opens automatically at `http://localhost:8765` (or the next free
+port, if another program already holds that one). On Windows, if an
 NVENC-capable ffmpeg isn't already present, FetchForge downloads one on first
 run. On Linux, install ffmpeg from your package manager first
 (`sudo dnf install ffmpeg` / `sudo apt install ffmpeg`) and make sure the NVIDIA
@@ -54,8 +61,20 @@ cd fetchforge
 ./launch.sh        # Windows: launch.bat
 ```
 
-> "Update yt-dlp" in the UI is a no-op for pip installs — update with
-> `pip install -U fetchforge` (or `pip install -U "yt-dlp[default]"`).
+> On Windows, `launch.bat` creates the `.venv` with `%PYTHON%` if you set it,
+> otherwise with `python` from `PATH`, falling back to the `py -3` launcher when
+> that one is older than 3.12 (apps that bundle their own Python tend to put it
+> first on `PATH`). If the interpreter it picks is the Microsoft
+> Store build of Python, the venv inherits its `%LOCALAPPDATA%` filesystem
+> virtualization — relevant because the NVENC-ffmpeg auto-provision cache also
+> lives under `%LOCALAPPDATA%\FetchForge\ffmpeg`. Prefer a python.org install
+> (or set `PYTHON` to one) if you hit path-resolution oddities.
+
+> The **Update yt-dlp** button adapts to how yt-dlp was installed: it runs
+> `pip install -U "yt-dlp[default]"` when yt-dlp lives in the app's own
+> environment (the normal pip/venv install), self-updates the bundled
+> `yt-dlp.exe` on Windows, and otherwise points you at your system package
+> manager. FetchForge itself updates with `pip install -U fetchforge`.
 
 ## Stack
 
@@ -94,27 +113,50 @@ cwd — the normal pip install path never needs them.
 
 Working from a clone instead: run `./launch.sh` (or `launch.bat` on Windows) — it sets up a `.venv`, installs the package in editable mode, and starts the server the same way.
 
+### Playing the output
+
+Converted videos are H.265/HEVC in MP4, which Windows' built-in players refuse to play unless you've bought Microsoft's HEVC Video Extensions from the Store.
+VLC and mpv play them with nothing extra installed.
+Apple players (QuickTime, Safari, iOS) accept them too, since the files are tagged `hvc1`.
+Audio-extract output (WAV/MP3) plays anywhere.
+
 ## Cookies
 
 Public videos need no cookies. Cookies are only necessary for age-restricted,
 private, or members-only videos, which require a logged-in YouTube session.
 
-To get a `cookies.txt`:
-
-1. Install a cookies-export browser extension — **Get cookies.txt LOCALLY**
-   for Chrome/Edge, or **cookies.txt** for Firefox.
-2. Log in to YouTube in that browser.
-3. Open the extension on a `youtube.com` tab and export in **Netscape**
-   format — that's your `cookies.txt`.
-4. Upload the file via the **Authentication** card in the FetchForge UI.
-
-The file grants access to your YouTube account, so treat it as a secret: it's
-gitignored and stays on your machine — don't share or commit it. Re-export it
-if it stops working; YouTube rotates cookies periodically.
+The **Authentication** card (#01) gives you three ways to load them:
+
+- **Attempt to fetch cookies** — one click; FetchForge reads cookies straight
+  from your installed browsers (Brave, Chrome, Chromium, Edge, Vivaldi, Opera,
+  Firefox) and *all* their profiles, picks the one with the most YouTube
+  cookies, and loads it. If more than one profile has cookies, it lists them so
+  you can switch. Best-effort — a locked keyring or missing browser is reported,
+  not fatal.
+- **Load cookies.txt** — upload a Netscape-format file exported by a browser
+  extension (**Get cookies.txt LOCALLY** for Chrome/Edge, **cookies.txt** for
+  Firefox: log in to YouTube, open the extension on a `youtube.com` tab, export).
+- **Paste cookies** — paste the Netscape text directly; it's masked, never
+  displayed, and saved server-side.
+
+A **Clear cookies** button removes them for a cookie-free run. If YouTube rotates
+your cookies mid-download (a common failure — see below), FetchForge notices,
+drops them automatically for the rest of that run, and warns you, so one stale
+jar doesn't sink a whole playlist.
+
+The cookie file grants access to your YouTube account, so treat it as a secret:
+it's gitignored and stays on your machine — don't share or commit it.
+
+> **Cookie rotation:** cookies exported (or read) from a *running* browser can be
+> invalidated by YouTube as a security measure, and stale cookies are worse than
+> none. For durable auth, log in via a fresh private window and close it before
+> loading, and re-fetch if downloads start failing.
 
 ## Features
 
 - **Sequential or pipelined playlist processing** — pipeline mode runs download and encode concurrently with a `maxsize=1` queue (downloader stays at most one video ahead of the encoder)
+- **Per-video playlist selection** — a resolved playlist shows a checklist (all checked by default) with select all / none / invert, so you can grab just the parts you want
+- **Robust playlist formats** — playlists take the highest-available stream per video (handles mixed 720p/1080p lists), and one video that can't be fetched is skipped so the rest of the playlist still completes
 - **Smart pre-download skip** — checks for existing `<title>_h265.mp4` before downloading, skips if ≥85% of expected size
 - **Two encode tunes** — `uhq` (Smart Auto, archival quality) and `hq` (NLE-friendly, ~4–6× speed, capped at source bitrate)
 - **HDR / 10-bit passthrough** — auto-detected; outputs `yuv420p10le` + `main10`

fetchforge-2.0.0/fetchforge.egg-info/PKG-INFO → fetchforge-2.3.1/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: fetchforge
-Version: 2.0.0
-Summary: Download YouTube videos and transcode to H.265/HEVC with NVIDIA NVENC — a localhost web app.
-Author: Petur Bjarnason
-License: MIT
-Project-URL: Homepage, https://github.com/prekabreki/fetchforge
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: fastapi
-Requires-Dist: uvicorn
-Requires-Dist: python-multipart
-Requires-Dist: yt-dlp[default]
-Dynamic: license-file
-
 # FetchForge
 
 > **Requires an NVIDIA GPU with NVENC.** The H.265 transcode uses hardware
@@ -35,7 +19,8 @@ pip install fetchforge
 fetchforge
 ```
 
-The browser opens automatically at `http://localhost:8765`. On Windows, if an
+The browser opens automatically at `http://localhost:8765` (or the next free
+port, if another program already holds that one). On Windows, if an
 NVENC-capable ffmpeg isn't already present, FetchForge downloads one on first
 run. On Linux, install ffmpeg from your package manager first
 (`sudo dnf install ffmpeg` / `sudo apt install ffmpeg`) and make sure the NVIDIA
@@ -54,8 +39,20 @@ cd fetchforge
 ./launch.sh        # Windows: launch.bat
 ```
 
-> "Update yt-dlp" in the UI is a no-op for pip installs — update with
-> `pip install -U fetchforge` (or `pip install -U "yt-dlp[default]"`).
+> On Windows, `launch.bat` creates the `.venv` with `%PYTHON%` if you set it,
+> otherwise with `python` from `PATH`, falling back to the `py -3` launcher when
+> that one is older than 3.12 (apps that bundle their own Python tend to put it
+> first on `PATH`). If the interpreter it picks is the Microsoft
+> Store build of Python, the venv inherits its `%LOCALAPPDATA%` filesystem
+> virtualization — relevant because the NVENC-ffmpeg auto-provision cache also
+> lives under `%LOCALAPPDATA%\FetchForge\ffmpeg`. Prefer a python.org install
+> (or set `PYTHON` to one) if you hit path-resolution oddities.
+
+> The **Update yt-dlp** button adapts to how yt-dlp was installed: it runs
+> `pip install -U "yt-dlp[default]"` when yt-dlp lives in the app's own
+> environment (the normal pip/venv install), self-updates the bundled
+> `yt-dlp.exe` on Windows, and otherwise points you at your system package
+> manager. FetchForge itself updates with `pip install -U fetchforge`.
 
 ## Stack
 
@@ -94,27 +91,50 @@ cwd — the normal pip install path never needs them.
 
 Working from a clone instead: run `./launch.sh` (or `launch.bat` on Windows) — it sets up a `.venv`, installs the package in editable mode, and starts the server the same way.
 
+### Playing the output
+
+Converted videos are H.265/HEVC in MP4, which Windows' built-in players refuse to play unless you've bought Microsoft's HEVC Video Extensions from the Store.
+VLC and mpv play them with nothing extra installed.
+Apple players (QuickTime, Safari, iOS) accept them too, since the files are tagged `hvc1`.
+Audio-extract output (WAV/MP3) plays anywhere.
+
 ## Cookies
 
 Public videos need no cookies. Cookies are only necessary for age-restricted,
 private, or members-only videos, which require a logged-in YouTube session.
 
-To get a `cookies.txt`:
-
-1. Install a cookies-export browser extension — **Get cookies.txt LOCALLY**
-   for Chrome/Edge, or **cookies.txt** for Firefox.
-2. Log in to YouTube in that browser.
-3. Open the extension on a `youtube.com` tab and export in **Netscape**
-   format — that's your `cookies.txt`.
-4. Upload the file via the **Authentication** card in the FetchForge UI.
-
-The file grants access to your YouTube account, so treat it as a secret: it's
-gitignored and stays on your machine — don't share or commit it. Re-export it
-if it stops working; YouTube rotates cookies periodically.
+The **Authentication** card (#01) gives you three ways to load them:
+
+- **Attempt to fetch cookies** — one click; FetchForge reads cookies straight
+  from your installed browsers (Brave, Chrome, Chromium, Edge, Vivaldi, Opera,
+  Firefox) and *all* their profiles, picks the one with the most YouTube
+  cookies, and loads it. If more than one profile has cookies, it lists them so
+  you can switch. Best-effort — a locked keyring or missing browser is reported,
+  not fatal.
+- **Load cookies.txt** — upload a Netscape-format file exported by a browser
+  extension (**Get cookies.txt LOCALLY** for Chrome/Edge, **cookies.txt** for
+  Firefox: log in to YouTube, open the extension on a `youtube.com` tab, export).
+- **Paste cookies** — paste the Netscape text directly; it's masked, never
+  displayed, and saved server-side.
+
+A **Clear cookies** button removes them for a cookie-free run. If YouTube rotates
+your cookies mid-download (a common failure — see below), FetchForge notices,
+drops them automatically for the rest of that run, and warns you, so one stale
+jar doesn't sink a whole playlist.
+
+The cookie file grants access to your YouTube account, so treat it as a secret:
+it's gitignored and stays on your machine — don't share or commit it.
+
+> **Cookie rotation:** cookies exported (or read) from a *running* browser can be
+> invalidated by YouTube as a security measure, and stale cookies are worse than
+> none. For durable auth, log in via a fresh private window and close it before
+> loading, and re-fetch if downloads start failing.
 
 ## Features
 
 - **Sequential or pipelined playlist processing** — pipeline mode runs download and encode concurrently with a `maxsize=1` queue (downloader stays at most one video ahead of the encoder)
+- **Per-video playlist selection** — a resolved playlist shows a checklist (all checked by default) with select all / none / invert, so you can grab just the parts you want
+- **Robust playlist formats** — playlists take the highest-available stream per video (handles mixed 720p/1080p lists), and one video that can't be fetched is skipped so the rest of the playlist still completes
 - **Smart pre-download skip** — checks for existing `<title>_h265.mp4` before downloading, skips if ≥85% of expected size
 - **Two encode tunes** — `uhq` (Smart Auto, archival quality) and `hq` (NLE-friendly, ~4–6× speed, capped at source bitrate)
 - **HDR / 10-bit passthrough** — auto-detected; outputs `yuv420p10le` + `main10`

{fetchforge-2.0.0 → fetchforge-2.3.1}/fetchforge/__init__.py

@@ -1,3 +1,3 @@
 """FetchForge — download YouTube videos and transcode to H.265/HEVC with NVIDIA NVENC."""
 
-__version__ = "2.0.0"
+__version__ = "2.3.1"