mirror of
https://github.com/hyzendust/Sharepoint-Downloader.git
synced 2026-07-01 04:42:20 +02:00
100 lines
4.5 KiB
Markdown
100 lines
4.5 KiB
Markdown
# MTH Video Manifest Capture
|
|
|
|
A Chrome extension that captures video manifest URLs (e.g., HLS `.m3u8`, MPEG-DASH `.mpd`, and SharePoint DASH manifests) from web pages, processes them, and generates FFmpeg and yt-dlp commands for downloading. It also includes a simple UI for customization and a button to download or open the manifest URL directly.
|
|
|
|
## Overview
|
|
|
|
**MTH Video Manifest Capture** is designed to assist users in capturing and processing video streaming manifests, particularly for SharePoint, HLS, and DASH formats. The extension provides a user-friendly popup interface to view cleaned manifest URLs, select quality and format options, set custom filenames, and copy commands for FFmpeg and yt-dlp to download the video content. It also includes a **"Download Manifest"** button to open the cleaned manifest URL in a new tab or initiate a basic download.
|
|
|
|
This extension is built using Chrome's **Manifest V3**, ensuring modern security and performance standards.
|
|
|
|
## Features
|
|
|
|
- **Captures video manifest URLs** (`.m3u8`, `.mpd`, and SharePoint `/transform/videomanifest` with `format=dash`).
|
|
- **Cleans URLs** by removing unnecessary parameters (e.g., after `format=dash`).
|
|
- **Generates customizable FFmpeg and yt-dlp commands** with options for quality (Best, 1080p, 720p, 480p) and format (MP4, MKV, TS).
|
|
- **Allows custom output filenames** or uses a timestamp-based default (e.g., `video_YYYYMMDD_HHMMSS`).
|
|
- **"Download Manifest" button** to open the cleaned manifest URL in a new tab or initiate a basic download of the manifest file.
|
|
- **Toggle buttons** to expand/collapse long URLs and commands for better readability.
|
|
- **Copy buttons** for FFmpeg and yt-dlp commands to easily paste into a terminal.
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
- Google Chrome or Chromium browser (**Manifest V3 compatible, version 88 or later**).
|
|
- FFmpeg and yt-dlp installed on your system (**optional, for running the generated commands**).
|
|
|
|
### Steps
|
|
|
|
1. **Clone or Download the Repository**
|
|
```bash
|
|
git clone https://github.com/MiniduTH/Sharepoint-Downloader.git
|
|
```
|
|
Or download the ZIP file and extract it.
|
|
|
|
2. **Load the Extension in Chrome**
|
|
- Open Chrome and navigate to `chrome://extensions/`.
|
|
- Enable **"Developer mode"** in the top-right corner.
|
|
- Click **"Load unpacked"** and select the `Sharepoint-Downloader` folder.
|
|
|
|
3. **Install Dependencies** *(optional, for using generated commands)*
|
|
- **FFmpeg:** Install via your package manager (e.g., `sudo apt install ffmpeg` on Ubuntu) or download from [ffmpeg.org](https://ffmpeg.org/).
|
|
- **yt-dlp:** Install via `pip install yt-dlp` or download from [yt-dlp.org](https://yt-dlp.org/).
|
|
|
|
## Usage
|
|
|
|
1. **Open a Web Page with Video Manifests**
|
|
- Visit a website streaming video content (e.g., SharePoint, HLS, or DASH streams).
|
|
|
|
2. **Activate the Extension**
|
|
- Click the **"MTH Video Manifest Capture"** icon in the Chrome toolbar.
|
|
|
|
3. **Capture Manifests**
|
|
- The extension automatically detects and captures video manifest URLs (`.m3u8`, `.mpd`, or SharePoint DASH manifests).
|
|
- The cleaned URL, FFmpeg command, and yt-dlp command will appear in the popup.
|
|
|
|
4. **Customize Options**
|
|
- Use the dropdowns to select video quality (**Best, 1080p, 720p, 480p**) and format (**MP4, MKV, TS**).
|
|
- Enter a custom output filename, or leave it blank to use the timestamp-based default (e.g., `video_20250305_143022.mp4`).
|
|
|
|
5. **Copy Commands**
|
|
- Click **"Copy FFmpeg"** or **"Copy yt-dlp"** to copy the respective commands to your clipboard.
|
|
- Paste the commands into a terminal to download the video using FFmpeg or yt-dlp.
|
|
|
|
|
|
## Screenshots
|
|
|
|
_Screenshot of the popup interface showing captured manifest, commands, and options._
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! Please follow these steps:
|
|
|
|
1. **Fork the repository**.
|
|
2. **Create a new branch** for your feature or bug fix:
|
|
```bash
|
|
git checkout -b feature/your-feature-name
|
|
```
|
|
3. **Make your changes and commit them**:
|
|
```bash
|
|
git commit -m "Add your commit message here"
|
|
```
|
|
4. **Push to the branch**:
|
|
```bash
|
|
git push origin feature/your-feature-name
|
|
```
|
|
5. **Submit a pull request** to the main branch.
|
|
|
|
## License
|
|
|
|
This project is licensed under the **MIT License**. See the `LICENSE` file for details.
|
|
|
|
## Contact
|
|
|
|
- **Author:** Minidu Weerasinghe
|
|
- **GitHub:** [MiniduTH](https://github.com/MiniduTH)
|
|
- **LinkedIn:** [linkedin.com/in/minidu0th](https://linkedin.com/in/minidu0th)
|