jellyfetch 0.1.1__tar.gz

jellyfetch-0.1.1/LICENSE

@@ -0,0 +1,42 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>
+
+----------------------------------------------------------------------
+THIRD-PARTY LICENSES & DEPENDENCIES
+----------------------------------------------------------------------
+While the core JellyFetch wrapper is licensed under the Unlicense, this 
+project relies on heavily bundled third-party dependencies that carry 
+their own licensing terms:
+
+1. yt-dlp: The core extraction engine is licensed under the Unlicense, 
+   but contains components licensed under MIT and ISC[cite: 5].
+2. FFmpeg: The media post-processing and merging toolkit is licensed 
+   under the GPLv3+ depending on the build[cite: 5].
+3. yt-dlp-ejs / Deno: JavaScript evaluation runtimes utilizing MIT 
+   and ISC components[cite: 5].
+
+Users redistributing compiled Docker images or binaries of JellyFetch 
+must ensure compliance with the inherited GPLv3+ and MIT terms of these 
+underlying dependencies.

jellyfetch-0.1.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: jellyfetch
+Version: 0.1.1
+Summary: A feature-rich command-line media downloader and web dashboard
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp
+Requires-Dist: flask
+Requires-Dist: python-dotenv
+Requires-Dist: yt-dlp-ejs
+Dynamic: license-file
+
+### JellyFetch 0.1.0
+A feature-rich command-line media downloader and web dashboard
+`docker compose up -d` Copy Docker instructions
+
+* [Description](#description)
+* [Dependencies](#dependencies)
+* [Installation](#installation)
+* [Usage and Dashboard](#usage-and-dashboard)
+* [Configuration](#configuration)
+* [Extracted Metadata](#extracted-metadata)
+* [Examples](#examples)
+* [Maintenance and Cache](#maintenance-and-cache)
+
+Official repository: https://github.com/fbellegarde/jellyfetch
+
+JellyFetch is a feature-rich, full-stack media acquisition platform. Built as a custom wrapper around yt-dlp—a feature-rich command-line audio/video downloader with support for thousands of sites—it provides a highly robust terminal CLI alongside a premium, single-page web dashboard. It automatically routes downloaded media (Movies, TV, Music, Social Clips) into your host file system and triggers library syncs across Jellyfin and Navidrome.
+
+**Important**: Any user experiencing an issue with downloads or signature extraction should flush the system cache via the Web UI before submitting a bug report.
+
+---
+
+### DEPENDENCIES
+Python versions 3.10+ (CPython) are supported. While some dependencies are optional for basic yt-dlp usage, the following are heavily utilized by the JellyFetch Docker container:
+
+#### Strongly recommended
+* **ffmpeg and ffprobe** - Required for merging separate video and audio files, as well as for various post-processing tasks.
+* **yt-dlp-ejs** - Required for full YouTube support. Licensed under Unlicense, bundles MIT and ISC components.
+* **deno** - A JavaScript runtime/engine recommended to run yt-dlp-ejs.
+
+---
+
+### INSTALLATION
+
+**Docker Deployment (Recommended)**
+JellyFetch is designed to run in an isolated container while securely mounting your host media drives.
+```bash
+git clone [https://github.com/fbellegarde/jellyfetch.git](https://github.com/fbellegarde/jellyfetch.git) && cd jellyfetch
+cp web/.env.example web/.env
+docker compose up --build -d
+Local Development (WSL/Linux)Bashsource venv/bin/activate
+pip install -e .
+python web/server.py
+USAGE AND DASHBOARDWeb Interface OptionsThe JellyFetch web dashboard is accessible by default at http://127.0.0.1:5547 and operates as a fully dynamic Single Page Application (SPA).Universal Drag-and-Drop: Drag any URL from your browser directly onto the UI window to instantly trigger the Metadata Inspector.Metadata Inspector: Previews the thumbnail, uploader, exact duration, and description parsed from the internal extraction dictionary before downloading.Hardware Audio Visualizer: The media player features a real-time HTML5 Canvas waveform visualizer that reacts to streaming media frequencies.Play Queue & Multi-Select: Add media to your queue for automatic transitions, or use Shift+Click in Table View for bulk queueing and deletion.Picture-in-Picture (PiP): Float the video player on top of your OS desktop using the native browser PiP API.CLI OptionsJellyFetch exposes the download command globally to your terminal, allowing you to pass explicit formats.Plaintext-h, --help                      Print this help text and exit
+auto                            (Default) Analyzes the URL and metadata to automatically 
+                                route files to the correct host directory.
+mp3                             Convert video files to audio-only files[cite: 5].
+                                Forces 192kbps audio extraction.
+mkv                             Remux the video into another container[cite: 5].
+                                Forces merging the best video and audio into an MKV container.
+all                             Archives all available formats.
+CONFIGURATIONConfigure JellyFetch by modifying the .env file in the /web directory. If you alter your configuration or core files, run docker compose up --build -d to rebuild the container.VariableCategoryDefault ValueDescriptionHOSTServer0.0.0.0The binding address.PORTServer5547The port the Flask API and Web UI run on.FLASK_DEBUGServerFalseSet to True for hot-reloading during development.APP_NAMEBrandingJellyFetchAlters the text in the top-left sidebar.THEME_PRIMARYBranding#a855f7Hex code for the primary accent color.MAX_GRID_ITEMSBranding500Limits the maximum files parsed per directory to prevent DOM lag.PATH_MOVIESMounts/mnt/e/.../MoviesThe internal path where your host movie drive is mounted.PATH_TVMounts/mnt/e/.../TV ShowsThe internal path where your host TV drive is mounted.PATH_MUSICMounts/mnt/e/.../MusicThe internal path where your host music drive is mounted.PATH_SOCIALMounts/mnt/e/.../ClipsThe internal path where your host social clips drive is mounted.JELLYFIN_URLIntegrationshttp://...Your local Jellyfin instance address.JELLYFIN_API_KEYIntegrationsNoneGenerate this in Jellyfin to sync via the Web UI.NAVIDROME_URLIntegrationshttp://...Your local Navidrome instance address.EXTRACTED METADATAJellyFetch extracts metadata and saves it as .info.json files. The UI parses these files to display detailed information. The following fields are actively extracted and utilized:is_live (boolean): Whether this video is a live stream or a fixed-length video[cite: 5].duration (numeric): Length of the video[cite: 5].extractor (string): Name of the extractor[cite: 5].playlist_id (string): Identifier of the playlist that contains the video[cite: 5].playlist_title (string): Name of the playlist that contains the video[cite: 5].playlist_count (numeric): Total number of items in the playlist. May not be known if entire playlist is not extracted[cite: 5].EXAMPLESBash# Boot the isolated JellyFetch container in detached mode
+$ docker compose up --build -d
+
+# Download and route a standard video via CLI
+$ download [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+
+# Download the best format that contains video,
+# and if it doesn't already have an audio stream, merge it with best audio-only format[cite: 5].
+$ download mkv [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+
+# Download best video available via direct link over HTTP/HTTPS protocol,
+# or the best video available via any protocol if there is no such video[cite: 5].
+$ download auto [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+MAINTENANCE AND CACHERebuilding: If you modify server.py, index.html, or alter your .env configuration, you must rebuild the Docker container (docker compose up --build -d) to apply the changes.System Cache: To maintain optimal extraction speeds and bypass stale signatures, yt-dlp utilizes a local cache. If downloads fail due to signature errors, navigate to the System Settings tab in the Web UI and click Flush Cache to instantly clear the internal cache safely without restarting the container.

jellyfetch-0.1.1/README.md

@@ -0,0 +1,64 @@
+### JellyFetch 0.1.0
+A feature-rich command-line media downloader and web dashboard
+`docker compose up -d` Copy Docker instructions
+
+* [Description](#description)
+* [Dependencies](#dependencies)
+* [Installation](#installation)
+* [Usage and Dashboard](#usage-and-dashboard)
+* [Configuration](#configuration)
+* [Extracted Metadata](#extracted-metadata)
+* [Examples](#examples)
+* [Maintenance and Cache](#maintenance-and-cache)
+
+Official repository: https://github.com/fbellegarde/jellyfetch
+
+JellyFetch is a feature-rich, full-stack media acquisition platform. Built as a custom wrapper around yt-dlp—a feature-rich command-line audio/video downloader with support for thousands of sites—it provides a highly robust terminal CLI alongside a premium, single-page web dashboard. It automatically routes downloaded media (Movies, TV, Music, Social Clips) into your host file system and triggers library syncs across Jellyfin and Navidrome.
+
+**Important**: Any user experiencing an issue with downloads or signature extraction should flush the system cache via the Web UI before submitting a bug report.
+
+---
+
+### DEPENDENCIES
+Python versions 3.10+ (CPython) are supported. While some dependencies are optional for basic yt-dlp usage, the following are heavily utilized by the JellyFetch Docker container:
+
+#### Strongly recommended
+* **ffmpeg and ffprobe** - Required for merging separate video and audio files, as well as for various post-processing tasks.
+* **yt-dlp-ejs** - Required for full YouTube support. Licensed under Unlicense, bundles MIT and ISC components.
+* **deno** - A JavaScript runtime/engine recommended to run yt-dlp-ejs.
+
+---
+
+### INSTALLATION
+
+**Docker Deployment (Recommended)**
+JellyFetch is designed to run in an isolated container while securely mounting your host media drives.
+```bash
+git clone [https://github.com/fbellegarde/jellyfetch.git](https://github.com/fbellegarde/jellyfetch.git) && cd jellyfetch
+cp web/.env.example web/.env
+docker compose up --build -d
+Local Development (WSL/Linux)Bashsource venv/bin/activate
+pip install -e .
+python web/server.py
+USAGE AND DASHBOARDWeb Interface OptionsThe JellyFetch web dashboard is accessible by default at http://127.0.0.1:5547 and operates as a fully dynamic Single Page Application (SPA).Universal Drag-and-Drop: Drag any URL from your browser directly onto the UI window to instantly trigger the Metadata Inspector.Metadata Inspector: Previews the thumbnail, uploader, exact duration, and description parsed from the internal extraction dictionary before downloading.Hardware Audio Visualizer: The media player features a real-time HTML5 Canvas waveform visualizer that reacts to streaming media frequencies.Play Queue & Multi-Select: Add media to your queue for automatic transitions, or use Shift+Click in Table View for bulk queueing and deletion.Picture-in-Picture (PiP): Float the video player on top of your OS desktop using the native browser PiP API.CLI OptionsJellyFetch exposes the download command globally to your terminal, allowing you to pass explicit formats.Plaintext-h, --help                      Print this help text and exit
+auto                            (Default) Analyzes the URL and metadata to automatically 
+                                route files to the correct host directory.
+mp3                             Convert video files to audio-only files[cite: 5].
+                                Forces 192kbps audio extraction.
+mkv                             Remux the video into another container[cite: 5].
+                                Forces merging the best video and audio into an MKV container.
+all                             Archives all available formats.
+CONFIGURATIONConfigure JellyFetch by modifying the .env file in the /web directory. If you alter your configuration or core files, run docker compose up --build -d to rebuild the container.VariableCategoryDefault ValueDescriptionHOSTServer0.0.0.0The binding address.PORTServer5547The port the Flask API and Web UI run on.FLASK_DEBUGServerFalseSet to True for hot-reloading during development.APP_NAMEBrandingJellyFetchAlters the text in the top-left sidebar.THEME_PRIMARYBranding#a855f7Hex code for the primary accent color.MAX_GRID_ITEMSBranding500Limits the maximum files parsed per directory to prevent DOM lag.PATH_MOVIESMounts/mnt/e/.../MoviesThe internal path where your host movie drive is mounted.PATH_TVMounts/mnt/e/.../TV ShowsThe internal path where your host TV drive is mounted.PATH_MUSICMounts/mnt/e/.../MusicThe internal path where your host music drive is mounted.PATH_SOCIALMounts/mnt/e/.../ClipsThe internal path where your host social clips drive is mounted.JELLYFIN_URLIntegrationshttp://...Your local Jellyfin instance address.JELLYFIN_API_KEYIntegrationsNoneGenerate this in Jellyfin to sync via the Web UI.NAVIDROME_URLIntegrationshttp://...Your local Navidrome instance address.EXTRACTED METADATAJellyFetch extracts metadata and saves it as .info.json files. The UI parses these files to display detailed information. The following fields are actively extracted and utilized:is_live (boolean): Whether this video is a live stream or a fixed-length video[cite: 5].duration (numeric): Length of the video[cite: 5].extractor (string): Name of the extractor[cite: 5].playlist_id (string): Identifier of the playlist that contains the video[cite: 5].playlist_title (string): Name of the playlist that contains the video[cite: 5].playlist_count (numeric): Total number of items in the playlist. May not be known if entire playlist is not extracted[cite: 5].EXAMPLESBash# Boot the isolated JellyFetch container in detached mode
+$ docker compose up --build -d
+
+# Download and route a standard video via CLI
+$ download [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+
+# Download the best format that contains video,
+# and if it doesn't already have an audio stream, merge it with best audio-only format[cite: 5].
+$ download mkv [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+
+# Download best video available via direct link over HTTP/HTTPS protocol,
+# or the best video available via any protocol if there is no such video[cite: 5].
+$ download auto [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+MAINTENANCE AND CACHERebuilding: If you modify server.py, index.html, or alter your .env configuration, you must rebuild the Docker container (docker compose up --build -d) to apply the changes.System Cache: To maintain optimal extraction speeds and bypass stale signatures, yt-dlp utilizes a local cache. If downloads fail due to signature errors, navigate to the System Settings tab in the Web UI and click Flush Cache to instantly clear the internal cache safely without restarting the container.

jellyfetch-0.1.1/jellyfetch/fetcher.py

@@ -0,0 +1,89 @@
+import os
+import argparse
+from yt_dlp import YoutubeDL
+
+def determine_save_path(url, info):
+    """Dynamically routes downloads based on metadata and environment variables."""
+    movies_dir = os.getenv("PATH_MOVIES", "/mnt/e/Media/Jellyfin/Movies")
+    tv_dir = os.getenv("PATH_TV", "/mnt/e/Media/Jellyfin/TV Shows")
+    music_dir = os.getenv("PATH_MUSIC", "/mnt/e/Media/Music")
+    social_dir = os.getenv("PATH_SOCIAL", "/mnt/e/Media/Jellyfin/YouTubeClips")
+    
+    url_lower = url.lower()
+    
+    # 1. Music Routing
+    if "music.youtube.com" in url_lower or "soundcloud.com" in url_lower or info.get('artist'):
+        return music_dir
+    # 2. TV Series / Playlist Routing
+    if info.get('series') or info.get('playlist'):
+        return tv_dir
+    # 3. Social Media & Clips
+    if any(domain in url_lower for domain in ["tiktok.com", "twitter.com", "x.com", "instagram.com", "youtube.com", "youtu.be"]):
+        return social_dir
+    # 4. Movies Default Fallback
+    return movies_dir
+
+def get_media(url, requested_format="auto"):
+    print(f"[JellyFetch] Inspecting metadata for {url}...")
+    with YoutubeDL({'quiet': True}) as ydl:
+        info = ydl.extract_info(url, download=False)
+        
+    target_dir = determine_save_path(url, info)
+    print(f"[JellyFetch] Routing to: {target_dir}")
+    
+    ydl_opts = {
+        'paths': {'home': target_dir},
+        'postprocessors': [{'key': 'FFmpegMetadata'}, {'key': 'EmbedThumbnail'}],
+        'writethumbnail': True,
+        'writeinfojson': True,
+        'clean_infojson': True,
+    }
+    
+    if requested_format in ['mp3', 'flac', 'wav', 'm4a', 'opus', 'aac']:
+        ydl_opts['format'] = 'bestaudio/best'
+        ydl_opts['postprocessors'].insert(0, {'key': 'FFmpegExtractAudio', 'preferredcodec': requested_format})
+        if "Music" in target_dir or target_dir == os.getenv("PATH_MUSIC"):
+            ydl_opts['outtmpl'] = '%(artist|Unknown Artist)s/%(album|Unknown Album)s/%(title)s [%(id)s].%(ext)s'
+        else:
+            ydl_opts['outtmpl'] = '%(title)s [%(id)s].%(ext)s'
+            
+    elif requested_format in ['mp4', 'mkv', 'webm', 'mov']:
+        ydl_opts['format'] = 'bestvideo+bestaudio/best'
+        ydl_opts['merge_output_format'] = requested_format
+        ydl_opts['outtmpl'] = '%(title)s [%(id)s].%(ext)s'
+        
+    elif requested_format == "all":
+        ydl_opts['format'] = 'all'
+        ydl_opts['outtmpl'] = '%(title)s.f%(format_id)s.%(ext)s'
+        
+    else:
+        if "Music" in target_dir or target_dir == os.getenv("PATH_MUSIC"):
+            ydl_opts['format'] = 'bestaudio/best'
+            ydl_opts['postprocessors'].insert(0, {'key': 'FFmpegExtractAudio', 'preferredcodec': 'mp3', 'preferredquality': '192'})
+            ydl_opts['outtmpl'] = '%(artist|Unknown Artist)s/%(album|Unknown Album)s/%(title)s [%(id)s].%(ext)s'
+        else:
+            ydl_opts['format'] = 'bestvideo+bestaudio/best'
+            ydl_opts['outtmpl'] = '%(title)s [%(id)s].%(ext)s'
+
+    with YoutubeDL(ydl_opts) as ydl:
+        ydl.download([url])
+
+def main():
+    parser = argparse.ArgumentParser(description="JellyFetch Media Downloader")
+    parser.add_argument("args", nargs="+", help="[format] URL or just URL")
+    args = parser.parse_args().args
+    
+    if len(args) == 2:
+        req_fmt = args[0].lower()
+        url = args[1]
+    elif len(args) == 1:
+        req_fmt = "auto"
+        url = args[0]
+    else:
+        print("Usage: download [format] <url>")
+        return
+        
+    get_media(url, req_fmt)
+
+if __name__ == "__main__":
+    main()

jellyfetch-0.1.1/jellyfetch.egg-info/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: jellyfetch
+Version: 0.1.1
+Summary: A feature-rich command-line media downloader and web dashboard
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp
+Requires-Dist: flask
+Requires-Dist: python-dotenv
+Requires-Dist: yt-dlp-ejs
+Dynamic: license-file
+
+### JellyFetch 0.1.0
+A feature-rich command-line media downloader and web dashboard
+`docker compose up -d` Copy Docker instructions
+
+* [Description](#description)
+* [Dependencies](#dependencies)
+* [Installation](#installation)
+* [Usage and Dashboard](#usage-and-dashboard)
+* [Configuration](#configuration)
+* [Extracted Metadata](#extracted-metadata)
+* [Examples](#examples)
+* [Maintenance and Cache](#maintenance-and-cache)
+
+Official repository: https://github.com/fbellegarde/jellyfetch
+
+JellyFetch is a feature-rich, full-stack media acquisition platform. Built as a custom wrapper around yt-dlp—a feature-rich command-line audio/video downloader with support for thousands of sites—it provides a highly robust terminal CLI alongside a premium, single-page web dashboard. It automatically routes downloaded media (Movies, TV, Music, Social Clips) into your host file system and triggers library syncs across Jellyfin and Navidrome.
+
+**Important**: Any user experiencing an issue with downloads or signature extraction should flush the system cache via the Web UI before submitting a bug report.
+
+---
+
+### DEPENDENCIES
+Python versions 3.10+ (CPython) are supported. While some dependencies are optional for basic yt-dlp usage, the following are heavily utilized by the JellyFetch Docker container:
+
+#### Strongly recommended
+* **ffmpeg and ffprobe** - Required for merging separate video and audio files, as well as for various post-processing tasks.
+* **yt-dlp-ejs** - Required for full YouTube support. Licensed under Unlicense, bundles MIT and ISC components.
+* **deno** - A JavaScript runtime/engine recommended to run yt-dlp-ejs.
+
+---
+
+### INSTALLATION
+
+**Docker Deployment (Recommended)**
+JellyFetch is designed to run in an isolated container while securely mounting your host media drives.
+```bash
+git clone [https://github.com/fbellegarde/jellyfetch.git](https://github.com/fbellegarde/jellyfetch.git) && cd jellyfetch
+cp web/.env.example web/.env
+docker compose up --build -d
+Local Development (WSL/Linux)Bashsource venv/bin/activate
+pip install -e .
+python web/server.py
+USAGE AND DASHBOARDWeb Interface OptionsThe JellyFetch web dashboard is accessible by default at http://127.0.0.1:5547 and operates as a fully dynamic Single Page Application (SPA).Universal Drag-and-Drop: Drag any URL from your browser directly onto the UI window to instantly trigger the Metadata Inspector.Metadata Inspector: Previews the thumbnail, uploader, exact duration, and description parsed from the internal extraction dictionary before downloading.Hardware Audio Visualizer: The media player features a real-time HTML5 Canvas waveform visualizer that reacts to streaming media frequencies.Play Queue & Multi-Select: Add media to your queue for automatic transitions, or use Shift+Click in Table View for bulk queueing and deletion.Picture-in-Picture (PiP): Float the video player on top of your OS desktop using the native browser PiP API.CLI OptionsJellyFetch exposes the download command globally to your terminal, allowing you to pass explicit formats.Plaintext-h, --help                      Print this help text and exit
+auto                            (Default) Analyzes the URL and metadata to automatically 
+                                route files to the correct host directory.
+mp3                             Convert video files to audio-only files[cite: 5].
+                                Forces 192kbps audio extraction.
+mkv                             Remux the video into another container[cite: 5].
+                                Forces merging the best video and audio into an MKV container.
+all                             Archives all available formats.
+CONFIGURATIONConfigure JellyFetch by modifying the .env file in the /web directory. If you alter your configuration or core files, run docker compose up --build -d to rebuild the container.VariableCategoryDefault ValueDescriptionHOSTServer0.0.0.0The binding address.PORTServer5547The port the Flask API and Web UI run on.FLASK_DEBUGServerFalseSet to True for hot-reloading during development.APP_NAMEBrandingJellyFetchAlters the text in the top-left sidebar.THEME_PRIMARYBranding#a855f7Hex code for the primary accent color.MAX_GRID_ITEMSBranding500Limits the maximum files parsed per directory to prevent DOM lag.PATH_MOVIESMounts/mnt/e/.../MoviesThe internal path where your host movie drive is mounted.PATH_TVMounts/mnt/e/.../TV ShowsThe internal path where your host TV drive is mounted.PATH_MUSICMounts/mnt/e/.../MusicThe internal path where your host music drive is mounted.PATH_SOCIALMounts/mnt/e/.../ClipsThe internal path where your host social clips drive is mounted.JELLYFIN_URLIntegrationshttp://...Your local Jellyfin instance address.JELLYFIN_API_KEYIntegrationsNoneGenerate this in Jellyfin to sync via the Web UI.NAVIDROME_URLIntegrationshttp://...Your local Navidrome instance address.EXTRACTED METADATAJellyFetch extracts metadata and saves it as .info.json files. The UI parses these files to display detailed information. The following fields are actively extracted and utilized:is_live (boolean): Whether this video is a live stream or a fixed-length video[cite: 5].duration (numeric): Length of the video[cite: 5].extractor (string): Name of the extractor[cite: 5].playlist_id (string): Identifier of the playlist that contains the video[cite: 5].playlist_title (string): Name of the playlist that contains the video[cite: 5].playlist_count (numeric): Total number of items in the playlist. May not be known if entire playlist is not extracted[cite: 5].EXAMPLESBash# Boot the isolated JellyFetch container in detached mode
+$ docker compose up --build -d
+
+# Download and route a standard video via CLI
+$ download [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+
+# Download the best format that contains video,
+# and if it doesn't already have an audio stream, merge it with best audio-only format[cite: 5].
+$ download mkv [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+
+# Download best video available via direct link over HTTP/HTTPS protocol,
+# or the best video available via any protocol if there is no such video[cite: 5].
+$ download auto [https://www.youtube.com/watch?v=](https://www.youtube.com/watch?v=)...
+MAINTENANCE AND CACHERebuilding: If you modify server.py, index.html, or alter your .env configuration, you must rebuild the Docker container (docker compose up --build -d) to apply the changes.System Cache: To maintain optimal extraction speeds and bypass stale signatures, yt-dlp utilizes a local cache. If downloads fail due to signature errors, navigate to the System Settings tab in the Web UI and click Flush Cache to instantly clear the internal cache safely without restarting the container.

jellyfetch-0.1.1/jellyfetch.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+jellyfetch/__init__.py
+jellyfetch/fetcher.py
+jellyfetch.egg-info/PKG-INFO
+jellyfetch.egg-info/SOURCES.txt
+jellyfetch.egg-info/dependency_links.txt
+jellyfetch.egg-info/entry_points.txt
+jellyfetch.egg-info/requires.txt
+jellyfetch.egg-info/top_level.txt

jellyfetch-0.1.1/jellyfetch.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jellyfetch-0.1.1/jellyfetch.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+download = jellyfetch.fetcher:main

jellyfetch-0.1.1/jellyfetch.egg-info/requires.txt

@@ -0,0 +1,4 @@
+yt-dlp
+flask
+python-dotenv
+yt-dlp-ejs

jellyfetch-0.1.1/jellyfetch.egg-info/top_level.txt

@@ -0,0 +1 @@
+jellyfetch

jellyfetch-0.1.1/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "jellyfetch"
+version = "0.1.1"
+description = "A feature-rich command-line media downloader and web dashboard"
+readme = "README.md"
+dependencies = ["yt-dlp", "flask", "python-dotenv", "yt-dlp-ejs"]
+
+[project.scripts]
+download = "jellyfetch.fetcher:main"
+
+[tool.setuptools]
+packages = ["jellyfetch"]

jellyfetch-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+