{"id":13889169,"url":"https://github.com/aayushdutt/modrinth-collection-downloader","last_synced_at":"2026-06-14T20:04:06.971Z","repository":{"id":227995435,"uuid":"772892518","full_name":"aayushdutt/modrinth-collection-downloader","owner":"aayushdutt","description":"Script to download mods from a Modrinth Collection","archived":false,"fork":false,"pushed_at":"2024-08-03T15:57:28.000Z","size":8,"stargazers_count":12,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-24T16:37:40.084Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aayushdutt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-16T06:52:19.000Z","updated_at":"2024-11-17T10:34:03.000Z","dependencies_parsed_at":"2024-08-03T16:58:11.615Z","dependency_job_id":null,"html_url":"https://github.com/aayushdutt/modrinth-collection-downloader","commit_stats":null,"previous_names":["aayushdutt/modrinth-collection-downloader"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aayushdutt/modrinth-collection-downloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aayushdutt%2Fmodrinth-collection-downloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aayushdutt%2Fmodrinth-collection-downloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aayushdutt%2Fmodrinth-collection-downloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aayushdutt%2Fmodrinth-collection-downloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aayushdutt","download_url":"https://codeload.github.com/aayushdutt/modrinth-collection-downloader/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aayushdutt%2Fmodrinth-collection-downloader/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265558425,"owners_count":23787934,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-06T14:00:43.590Z","updated_at":"2026-06-14T20:04:06.966Z","avatar_url":"https://github.com/aayushdutt.png","language":"Python","funding_links":[],"categories":["Mod managers/updaters"],"sub_categories":["CLI"],"readme":"# Modrinth Collection Downloader\n\n\u003e Download and update mods from Modrinth collections with automatic dependency resolution and parallel downloads.\n\n[![Python](https://img.shields.io/badge/python-3.6+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\nA fast, user-friendly Python script that downloads mods from Modrinth collections with intelligent dependency handling, parallel downloads, and an intuitive interactive interface.\n\n## ✨ Features\n\n- 🚀 **Parallel Downloads** - Download multiple mods simultaneously for faster processing\n- 🔗 **Automatic Dependencies** - Automatically resolves and downloads required dependencies\n- 💬 **Interactive Mode** - User-friendly prompts with sensible defaults\n- 🔄 **Smart Updates** - Updates existing mods by default (configurable)\n- 📊 **Detailed Statistics** - Comprehensive summary with separate tracking for mods and dependencies\n\n\u003e Also check out my new project [mctui](https://github.com/aayushdutt/mctui) - the TUI launcher for Minecraft. Minimal, fast launcher with mod management and other batteries built in.\n\n## 🚀 Quick Start\n\n### Interactive oneliner\n\nThe easiest way to use the script - just run it and follow the prompts:\n\n```bash\n# Using curl (replace python with python3 for mac)\ncurl -sL https://raw.githubusercontent.com/aayushdutt/modrinth-collection-downloader/master/main.py | python -\n\n# Or using wget (replace python with python3 for mac)\nwget -qO- https://raw.githubusercontent.com/aayushdutt/modrinth-collection-downloader/master/main.py | python -\n```\n\nYou'll be prompted for:\n\n- Collection ID or URL\n- Minecraft version\n- Loader (fabric, forge, quilt, etc.)\n- Update preference (defaults to Yes)\n\n**Example session:**\n\n```bash\n$ curl -sL https://raw.githubusercontent.com/aayushdutt/modrinth-collection-downloader/master/main.py | python -\nEnter collection ID or URL: https://modrinth.com/collection/5OBQuutT\nEnter Minecraft version (e.g., \"1.21.9\"): 1.21.9\nEnter loader (e.g., \"fabric\", \"forge\", \"quilt\"): fabric\nUpdate existing mods? [Y/n] (default: Y):\nFound 22 mod(s) in collection\nProcessing 2 required dependency(ies) for Dynamic FPS...\n  [DEPENDENCY] DOWNLOADING: Fabric API - fabric-api-0.134.0+1.21.9.jar...\nDOWNLOADING: Dynamic FPS - dynamic-fps-3.10.1+minecraft-1.21.9-fabric.jar...\n...\n```\n\n### Local Installation\n\nDownload or copy `main.py` and run it:\n\n```bash\n# Download the script (or copy from repository)\ncurl -sL https://raw.githubusercontent.com/aayushdutt/modrinth-collection-downloader/master/main.py -o main.py\n\n# Run interactively\npython main.py\n\n# Or with arguments\npython main.py -c 5OBQuutT -v 1.21.9 -l fabric\n```\n\n## 📋 Command-Line Options\n\n```\noptions:\n  -h, --help            show this help message and exit\n  -c, --collection COLLECTION\n                        ID or URL of the collection to download\n                        (e.g., 5OBQuutT or https://modrinth.com/collection/5OBQuutT)\n  -v, --version VERSION\n                        Minecraft version (e.g., \"1.20.4\", \"1.21\")\n  -l, --loader LOADER   Loader to use (e.g., \"fabric\", \"forge\", \"quilt\")\n  -d, --directory DIRECTORY\n                        Directory to download mods to. Default: \"./mods\"\n  -u, --update          Download and update existing mods. Default: true\n  --no-update           Do not update existing mods\n```\n\n**Note:** All arguments except `-d` are optional. The script will prompt for any missing values.\n\n## How It Works\n\n- **Dependencies**: Automatically downloads required dependencies recursively. Marked with `[DEPENDENCY]` in logs.\n- **Parallel Downloads**: Downloads up to 5 mods concurrently.\n- **Updates**: Enabled by default. Skips mods already at latest version by comparing filenames.\n- **File Format**: Saves as `filename.modid.ext` (e.g., `dynamic-fps-3.10.1+minecraft-1.21.9-fabric.LQ3K71Q1.jar`)\n\n## Requirements\n\n- Python 3.6+\n- No external dependencies (uses standard library only)\n\n## Troubleshooting\n\n- **\"command not found: python\"**: Use `python3` instead, or [install Python](https://www.python.org/downloads/).\n- **\"No version found\"**: Mod doesn't support the specified version/loader. Check Modrinth for supported versions.\n- **\"Collection not found\"**: Verify the collection ID/URL is correct and public.\n- **Dependencies not downloading**: Only \"required\" dependencies are downloaded. Optional ones are skipped.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=aayushdutt/modrinth-collection-downloader\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#aayushdutt/modrinth-collection-downloader\u0026type=date\u0026legend=top-left)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faayushdutt%2Fmodrinth-collection-downloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faayushdutt%2Fmodrinth-collection-downloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faayushdutt%2Fmodrinth-collection-downloader/lists"}