update 08/01/2026

Co-Authored-By: M Ramzan Ch <191318204+MegaMind-Solution@users.noreply.github.com>

Author: Pro-Bandey

README.md

@@ -1,4 +1,4 @@
-# DownGD 2.O 🚀
+# DownGD 2.0 🚀
 
 A powerful, pixel-perfect, single-page web application to download files or folders from GitHub repositories. It supports public URLs, private repositories (via Token), and requires **no server**.
 
@@ -8,10 +8,11 @@ A powerful, pixel-perfect, single-page web application to download files or fold
 - **Client-Side Only**: Works 100% in the browser (GitHub Pages / Vercel compatible).
 - **Smart Routing**: Share links like `mysite.com/#/github.com/user/repo` to auto-start downloads.
 - **Private Repo Support**: Enter a Personal Access Token (stored locally) to access private files.
-- **Beautiful UI**: Smooth animations, file previews, and 2.Ogress bars.
+- **Partial Downloads**: Download large repositories in steps (e.g., files 0-100) to avoid browser limits.
+- **Beautiful UI**: Smooth animations, file previews, and progress bars.
 - **Theming**: 8 Themes including Dracula, Cyberpunk, AMOLED, and more.
 
-## 🔗 How to Use Samrt Links
+## 🔗 How to Use Smart Links
 
 To share a direct download link with a friend, simply add the GitHub URL after the hash (`?=`):
 
@@ -21,38 +22,55 @@ To share a direct download link with a friend, simply add the GitHub URL after t
 ### With Name
 > [https://downgd.github.io/?=https://github.com/facebook/react/tree/main/packages&name=react-core](https://downgd.github.io/?=https://github.com/facebook/react/tree/main/packages&name=react-core)
 
+### Partial / Range Download
+If a repository is too large, you can limit the number of files to download using `&st` (Start) and `&mx` (Max).
+> [https://downgd.github.io/?=https://github.com/facebook/react/tree/main/packages&st=50&mx=150](https://downgd.github.io/?=https://github.com/facebook/react/tree/main/packages&st=50&mx=150)
+
+*   `&st=50`: Start downloading from the 50th file.
+*   `&mx=150`: Stop downloading at the 150th file.
+
 When the user visits this link, the app will:
 1. Parse the URL.
-2. Auto-fill the input.
-3. Immediately start fetching and zipping the folder.
+2. Auto-fill the input and limit fields.
+3. Immediately start fetching and zipping files **50 to 150**.
 
 ## 🔑 Private Repositories
 
 1. Generate a GitHub Token (Settings > Developer Settings > Personal Access Tokens).
 2. Scopes needed: `repo` (for private) or just public access.
-3. Open DownGD 2.O > Click Gear Icon (⚙️).
+3. Open DownGD 2.0 > Click Gear Icon (⚙️).
 4. Paste token. It is saved in your browser's LocalStorage and never sent to any 3rd party server.
-Got it 👍
-Below are **ONLY the two new sections** you asked for — **Script details** and **Extension details** — written to drop directly into your existing README **without changing anything else**.
 
 ---
-## 🔗 Api
+## 🔗 API
 
-To embed a direct download link with in your website/page, simply use this pattern
+To embed a direct download link within your website/page, simply use this pattern. The API also supports the `&st` and `&mx` parameters.
 
-### embed as a link
+### Embed as a link
 ```html
-<a href="https://downgd.github.io/api/?=https://github.com/facebook/react/tree/main/packages&name=react-cor"></a>
+<!-- Download all files -->
+<a href="https://downgd.github.io/api/?=https://github.com/facebook/react/tree/main/packages&name=react-core">Download Core</a>
+
+<!-- Download files 0 to 100 only -->
+<a href="https://downgd.github.io/api/?=https://github.com/facebook/react/tree/main/packages&name=react-core&st=0&mx=100">Download Part 1</a>
 ```
-### or use like this js
+
+### Use via JavaScript
 ```javascript
 function triggerDownload() {
     const repo = "https://github.com/facebook/react/tree/main/packages";
-    const apiUrl = `https://git-zip-pro.vercel.app/api/?url=${repo}`;
+    
+    // Optional: Add limits for large folders
+    const params = "&st=0&mx=200"; 
+    
+    const apiUrl = `https://git-zip-pro.vercel.app/api/?url=${repo}${params}`;
 
     window.open(apiUrl, '_blank');
 }
 ```
+
+---
+
 ## 📜 Userscript
 
 DownGD also provides a **GitHub-integrated userscript** that adds a native-looking **Download button directly inside GitHub menus**.
@@ -61,7 +79,6 @@ DownGD also provides a **GitHub-integrated userscript** that adds a native-looki
 
 * Injects a **“Download Repo / Folder / File”** action into GitHub’s context menus
 * Automatically detects:
-
   * **Repository menu** → shows **Download Repo**
   * **Folder menu** → shows **Download Folder**
   * **File menu** → shows **Download**
@@ -95,6 +112,7 @@ DownGD also provides a **GitHub-integrated userscript** that adds a native-looki
 The DownGD userscript can also be packaged as a **lightweight browser extension** using ScriptRunner-style extensions.
 
 ## [Download Now](https://downgd.github.io/api/?=https://github.com/DownGD/downgd.github.io/tree/main/extension&name=Extension)
+
 ### 🚀 Extension Capabilities
 
 * Zero background services
@@ -118,7 +136,6 @@ The DownGD userscript can also be packaged as a **lightweight browser extension*
 
 ---
 
-
 ## 🤝 Contributing
 
 Feel free to open issues or submit PRs. The code is written in JS/CSS for maximum simplicity and performance.

api/api.js

@@ -1,15 +1,11 @@
-
-
 const API_BASE = "https://api.github.com/repos";
 const RAW_BASE = "https://raw.githubusercontent.com";
 
-
 const config = {
     token: localStorage.getItem("gh_token") || "",
     controller: new AbortController()
 };
 
-
 const ui = {
     card: document.getElementById("card"),
     title: document.getElementById("status-title"),
@@ -18,19 +14,27 @@ const ui = {
     bar: document.getElementById("bar")
 };
 
-
 (function init() {
-
     const params = new URLSearchParams(window.location.search);
 
     let url = params.get("url") || params.get(""); 
     const customName = params.get("name");
 
+    // --- NEW: Parse Limit Parameters ---
+    // We use undefined if not present, so we can handle defaults later
+    const startLimit = params.has("st") ? parseInt(params.get("st")) : null;
+    const maxLimit = params.has("mx") ? parseInt(params.get("mx")) : null;
 
     if (!url) {
-       
         const search = window.location.search.substring(1); 
+        // Logic to extract URL if it's the first param without a key
+        // Note: This might need adjustment if params like &st= are first, 
+        // but assuming url is usually first or named "url="
         if(search.startsWith("=")) url = search.substring(1);
+        else if(!search.includes("url=") && search.includes("&")) {
+             // Handle case: ?github.com/user/repo&st=50
+             url = search.split("&")[0];
+        }
     }
 
     if (!url) return setError("Missing URL", "Please provide a GitHub link.");
@@ -41,10 +45,11 @@ const ui = {
         else url = "https://github.com/" + url;
     }
 
-    startDownload(url, customName);
+    // Pass limits to startDownload
+    startDownload(url, customName, startLimit, maxLimit);
 })();
 
-async function startDownload(url, saveName) {
+async function startDownload(url, saveName, startLimit, maxLimit) {
     try {
         const parsed = parseGitHubUrl(url);
         if (!parsed) throw new Error("Invalid GitHub URL");
@@ -60,7 +65,8 @@ async function startDownload(url, saveName) {
         if (parsed.type === "blob") {
             await processSingleFile(parsed, saveName);
         } else {
-            await processFolder(parsed, saveName);
+            // Pass limits to processFolder
+            await processFolder(parsed, saveName, startLimit, maxLimit);
         }
 
         handleSuccess();
@@ -70,7 +76,6 @@ async function startDownload(url, saveName) {
     }
 }
 
-
 function handleSuccess() {
     ui.card.classList.add("state-success");
     ui.title.innerText = "Downloaded";
@@ -81,27 +86,21 @@ function handleSuccess() {
 
     setTimeout(() => {
         if (returnUrl && returnUrl.startsWith("http")) {
-
             ui.text.innerText = "Returning...";
             window.location.href = returnUrl;
         } 
         else if (window.history.length > 1 && document.referrer) {
-
             ui.text.innerText = "Returning to page...";
             window.history.back();
         } 
         else {
-
             ui.text.innerText = "Closing tab...";
-            
             window.close();
-
             try { window.opener = null; window.open("", "_self"); window.close(); } catch (e) {}
 
             setTimeout(() => {
                 if (!window.closed) {
                     ui.text.innerText = "Download complete. You can close this tab.";
-                    
                     if (document.referrer) {
                         ui.text.innerText = "Returning...";
                         window.location.href = document.referrer;
@@ -112,29 +111,51 @@ function handleSuccess() {
     }, 1500);
 }
 
-
-
-async function processFolder(parsed, customName) {
+async function processFolder(parsed, customName, startOpt, maxOpt) {
     ui.title.innerText = "Fetching files...";
     const data = await fetchAPI(`/${parsed.user}/${parsed.repo}/git/trees/${parsed.branch}?recursive=1`);
     const targetPath = parsed.path ? parsed.path + "/" : "";
-    const files = data.tree.filter(f => f.type === "blob" && (parsed.path === "" || f.path.startsWith(targetPath)));
+    
+    // Get ALL valid blobs first
+    const allFiles = data.tree.filter(f => f.type === "blob" && (parsed.path === "" || f.path.startsWith(targetPath)));
+
+    if (!allFiles.length) throw new Error("Folder is empty");
+
+    // --- NEW: Slicing Logic ---
+    let start = startOpt !== null ? startOpt : 0;
+    let end = maxOpt !== null ? maxOpt : allFiles.length;
+
+    // Validation to prevent crashes
+    if (start < 0) start = 0;
+    if (end > allFiles.length) end = allFiles.length;
+    if (start >= end) {
+        // Fallback: if user sets Start > End, just download everything or reset Start
+        start = 0; 
+        end = allFiles.length;
+    }
+
+    // Slice the files array
+    const filesToDownload = allFiles.slice(start, end);
+    const totalToDownload = filesToDownload.length;
 
-    if (!files.length) throw new Error("Folder is empty");
+    if (totalToDownload === 0) throw new Error("No files in selected range");
+
+    ui.title.innerText = `Downloading (${start}-${end})...`;
+    ui.text.innerText = `Preparing ${totalToDownload} files...`;
+    // --------------------------
 
-    ui.title.innerText = "Downloading...";
     const zip = new JSZip();
     let count = 0;
     const CHUNK = 5;
 
-    for (let i = 0; i < files.length; i += CHUNK) {
-        await Promise.all(files.slice(i, i + CHUNK).map(async f => {
+    for (let i = 0; i < totalToDownload; i += CHUNK) {
+        await Promise.all(filesToDownload.slice(i, i + CHUNK).map(async f => {
             try {
                 const content = await fetchContent(parsed, f);
                 const zipPath = parsed.path ? f.path.substring(parsed.path.length + 1) : f.path;
                 zip.file(zipPath, content);
                 count++;
-                updateProgress(count, files.length);
+                updateProgress(count, totalToDownload);
             } catch (e) {}
         }));
     }
@@ -160,7 +181,6 @@ async function processSingleFile(parsed, customName) {
     saveAs(new Blob([content]), fileName);
 }
 
-
 async function fetchAPI(endpoint) {
     const headers = config.token ? { "Authorization": `token ${config.token}` } : {};
     const res = await fetch(`${API_BASE}${endpoint}`, { headers });

api/readme.md

@@ -46,6 +46,19 @@ You can also use the hash or `?=` syntax:
 ```
 https://DownGD.github.io/api/?=https://github.com/facebook/react/tree/main/packages
 ```
+### Partial / Range Download
+If a repository is too large, you can limit the number of files to download using `&st` (Start) and `&mx` (Max).
+```html
+https://downgd.github.io/?=https://github.com/facebook/react/tree/main/packages&st=50&mx=150
+```
+
+*   `&st=50`: Start downloading from the 50th file.
+*   `&mx=150`: Stop downloading at the 150th file.
+
+When the user visits this link, the app will:
+1. Parse the URL.
+2. Auto-fill the input and limit fields.
+3. Immediately start fetching and zipping files **50 to 150**.
 
 ### 4. Integration Example (JavaScript)
 You can use an `iframe` or `window.open` to trigger downloads from your own website: