https://github.com/jaylann/NexusAutoDL

A tool for automatically downloading mods from Nexusmods with support for different Mod Managers such as Vortex, Portmod and Wabbajack.
https://github.com/jaylann/NexusAutoDL

automation downloader modmanager mods nexusmods portmod vortex wabbajack

Last synced: 9 days ago
JSON representation

A tool for automatically downloading mods from Nexusmods with support for different Mod Managers such as Vortex, Portmod and Wabbajack.

• Host: GitHub
• URL: https://github.com/jaylann/NexusAutoDL
• Owner: jaylann
• License: gpl-3.0
• Created: 2022-11-08T22:15:29.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-06-27T10:28:04.000Z (6 months ago)
• Last Synced: 2024-06-27T15:14:45.199Z (6 months ago)
• Topics: automation, downloader, modmanager, mods, nexusmods, portmod, vortex, wabbajack
• Language: Python
• Homepage:
• Size: 53.7 KB
• Stars: 13
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• starred - jaylann/NexusAutoDL - A tool for automatically downloading mods from Nexusmods with support for different Mod Managers such as Vortex, Portmod and Wabbajack. (Python)

README

        
# NexusAutoDL

This tool is designed for automating the process of downloading mods from [Nexusmods](https://www.nexusmods.com/), without being a premium member. It is designed with mod managers such as [Portmod](https://gitlab.com/portmod/portmod) and [Wabbajack](https://www.wabbajack.org/). It also contains an integration for Nexusmods own mod manager, [Vortex](https://www.nexusmods.com/about/vortex/), which contrary to the affore mentioned, does not automatically open the mods download page but instead forces users to suffer through another click. This tool is designed to automatically click through a download list and download all of the contained mods without user intervention.

# Features 

This tool offers a plethora of different features. It is designed to work with multiple screens and even has a browser integration. If you’re working with multiple monitors and are also using Vortex, this tool has the ability to open and move your primary browser and your Vortex instance, so that you can start downloading right away. In addition, this tool offers Interruption Detection. As Vortex sometimes throws errors or otherwise asks the user for input. These interruptions will be detected and circumvented.

# Prerequisites

First you will need to have Python 3.9 installed.

Then when running the script either on one monitor, or with --force-primary enabled, as well as --vortex enabled, you will need to make sure that both the Vortex Mod Manager window and your Browser window are visible at the same time.

# Running the Script

Clone this repository:

`git clone https://github.com/jaylann/NexusAutoDL`

Or manually download the repository.

Then go into the directory you cloned/downloaded to.

`cd NexusAutoDL`

Install all necessary packages.

`pip install -r requirements.txt`

Run python script with or without arguments.

Windows:

`python main.py `

MacOS/Linux:

`python3 main.py `

# Command Line Options

- `--browser : selects browser to open and move to work

with Vortex. Can only be used in combination with --vortex. Currently

supported browsers: “chrome”, “firefox”`

- `--vortex: specifies use with Vortex mod manager`

- `--verbose: prints verbose output`

- `--force-primary: forces a system with multiple monitors to only be scanned on it’s primary display`

# Demo

https://user-images.githubusercontent.com/61842101/202874471-d5700912-16fd-4b7e-ab3f-0b97d05f6d9e.mp4

# Credit

Credit goes to [nexus-autodl](https://github.com/parsiad/nexus-autodl) for inspiring this project.

# Disclaimer

Nexusmods TOS state that using an automated program to download mods is prohibited. By using this software you are doing so at your own risk. The Author is not responsible for any kind of consequences and damages that might occur by using this program.