fix: version number url

* Print parent folder of mod variants

Because some mods have multiple variants with the same name.
As is, it is impossible to tell them apart in the selection.
This commit changes the selection to also print the parent folder of the
variants.

* remove the name of the mod zip/dir itself because it not necessary

---------

Co-authored-by: v4n <105587619+v4n00@users.noreply.github.com>

README.md

@@ -2,10 +2,15 @@
 
 Helldivers 2 Mod Manager CLI is a command line interface for managing Helldivers 2 mods. Since there is no Linux mod manager available and I like being a nerd by using CLI tools instead of GUIs, this project was born.
 
-This script is complete, the version will always [remain at 0.x.x](https://0ver.org/)
+This mod manager is complete, the version will always [remain at 0.x.x](https://0ver.org/). Version 0.6.x will be the last version of this mod manager.
 
 ## Installation
 
+Pre-requisites:
+
+- You must have the `unzip` package installed for zip archives;
+- You might want to have the `unarchiver` package installed for rar archives.
+
 To install Helldivers 2 Mod Manager CLI run the following command in your terminal:
 
 ```bash
@@ -13,19 +18,11 @@ bash -c "$(curl -fsSL https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/head
 ```
 
 > [!CAUTION]
-> Running this script will require sudo permissions. **DO NOT TRUST** random scripts from the internet. If you want to review the script before running it, check out the mod repository for yourself.
+> Running this script will require sudo permissions. **DO NOT TRUST** random scripts from the internet. If you want to review the script before running it, check out the repository for yourself.
-
-If for some reason, the installation command doesn't work you can:
-
-1. Go to <https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/install.sh>
-1. Right click -> Save page as...
-1. Go to your downloads folders `cd ~/Downloads`
-1. Give the script execution permissions `chmod +x install.sh`
-1. Run the script `./install.sh`
 
 ## Usage
 
-The script gets added to `/usr/local/bin/h2mm` and can be used by running `h2mm` in your shell, which will show the help message explaining how to use the script.
+The script gets added to `/usr/local/bin/h2mm` (or `$HOME/.local/bin` on Steam Deck) and can be used by running `h2mm` in your shell, which will show the help message explaining how to use the script.
 
 ```bash
 h2mm
@@ -33,43 +30,55 @@ h2mm
 
 ### Available commands
 
-- `install` - Install a mod by the file provided (directory, zip, patch).
+- `install` or `i` - Install a mod by the file provided (directory, zip, patch);
-- `uninstall` - Uninstall a mod.
+- `uninstall` or `u` - Uninstall a mod;
-- `list` - List all installed mods.
+- `list` or `l` - List all installed mods;
-- `enable` - Enable a mod.
+- `enable` or `e` - Enable a mod;
-- `disable` - Disable a mod.
+- `disable` or `d` - Disable a mod;
-- `export` - Export installed mods to a zip file.
+- `rename` or `r` - Rename a mod;
-- `import` - Import mods from a zip file.
+- `order` or `o` - Change load order for a mod;
-- `order` - Change load order for a mod.
+- `export` or `ex` - Export installed mods to a zip file;
-- `modpack-create` - Create a modpack from the currently installed mods.
+- `import` or `im` - Import mods from a zip file;
-- `modpack-switch` - Switch to a modpack.
+- `modpack-create` or `mc` - Create a modpack from the currently installed mods;
-- `modpack-list` - List all installed modpacks.
+- `modpack-switch` or `ms` - Switch to a modpack;
-- `modpack-delete` - Delete a modpack.
+- `modpack-list` or `ml` - List all installed modpacks;
-- `modpack-overwrite` - Overwrite a modpack.
+- `modpack-delete` or `md` - Delete a modpack;
-- `modpack-reset` - Reset all installed modpacks.
+- `modpack-overwrite` or `mo` - Overwrite a modpack;
-- `update` - Update h2mm to latest version.
+- `modpack-reset` or `mr` - Reset all installed modpacks;
-- `reset` - Reset all installed mods.
+- `nexus-setup` or `ns` - Setup Nexus Mods integration;
-- `help` - Display this help message.
+- `update` or `up` - Update h2mm to latest version;
+- `reset` or `rs` - Reset all installed mods;
+- `help` or `h` - Display this help message.
 
-### Basic usage
+### Examples
 
 To find out how to use a command, you can run `h2mm <COMMAND> --help`.
 
 #### Install mod(s)
 
 ```bash
-h2mm install /path/to/mod.zip
+h2mm install mod.zip
-h2mm install /path/to/mod/files
+h2mm install /path/to/mod/directory/
-h2mm install /path/to/mod.zip /path/to/mod2.zip /path/to/mod/files
+h2mm install /path/to/mod.zip /path/to/mod2.zip /path/to/mod/files # mix and match hoewever you want
 h2mm install -n "Example mod" mod.patch_0 mod.patch_0.stream # -n is mandatory when using files
-h2mm install -n "Example mod" mod* # using a wildcard to include all files
+```
+
+> It's better to be in the directory where the mod files are located, so you don't have to specify the full path. For mod downloads, you can do `cd ~/Downloads` and then run the command.
+>
+> Also, use the Tab key to autocomplete the file names, as it will help you escape special characters likes spaces or quotes.
+
+#### List installed mods
+
+```bash
+h2mm list
+h2mm list -v # verbose mode
 ```
 
 #### Uninstall a mod
 
 ```bash
 h2mm uninstall -n "Example mod"
-h2mm uninstall -i 3
+h2mm uninstall -i 3 # get the index from the list command
 ```
 
 #### Enable/disable mods
@@ -81,18 +90,22 @@ h2mm disable -n "Example mod"
 h2mm disable -i 3
 ```
 
-#### List installed mods
-
-```bash
-h2mm list
-```
-
 #### Updating the script
 
 ```bash
 h2mm update
 ```
 
+## Nexus Mods integration
+
+Nexus Mods integration allows you to use the 1-click install feature of Nexus Mods (with the "Vortex" or "Mod manager download" buttons). You can set up Nexus Mods integration by running the following command:
+
+```bash
+h2mm nexus-setup
+```
+
+You will be walked through the setup process, which will ask you for your Nexus Mods API key and your preferred terminal.
+
 ## Compatibility
 
 The script is developed and tested on Arch Linux, but it should work on other Linux distributions as well. If you encounter any issues, please open an issue on the repository.
@@ -103,62 +116,7 @@ Status of platforms:
 - Steam Deck :white_check_mark:
 - Windows - WSL :white_check_mark:
 
-> The script works on WSL, but you need to specify the path to the Helldivers 2 mods directory manually, to find your Windows partition head to `/mnt/` and from there go to your Helldivers 2 data directory, on a typical install it should be on `/mnt/c/Program\ Files\ \(x86\)/Steam/steamapps/common/Helldivers\ 2/data`. You also need to have `unzip` installed, which can be done by running `sudo apt install unzip`.
+> The script works on WSL, but you need to specify the path to the Helldivers 2 mods directory manually, to find your Windows partition head to `/mnt/` and from there go to your Helldivers 2 data directory, on a typical install it should be on `/mnt/c/Program\ Files\ \(x86\)/Steam/steamapps/common/Helldivers\ 2/data`. You also need to have `unzip` installed, which can be done by running `sudo apt install unzip`. Nexus Mods integration is not supported on WSL.
-
-## Advanced usage
-
-### Shortcuts
-
-You can use the short form of commands to save some time. The shortcuts are:
-
-- `i` for `install`
-- `u` for `uninstall`
-- `e` for `enable`
-- `d` for `disable`
-- `l` for `list`
-- `ex` for `export`
-- `im` for `import`
-- `o` for `order`
-- `mc` for `modpack-create`
-- `ms` for `modpack-switch`
-- `ml` for `modpack-list`
-- `md` for `modpack-delete`
-- `mo` for `modpack-overwrite`
-- `mr` for `modpack-reset`
-- `up` for `update`
-- `r` for `reset`
-
-### Modpacks support
-
-You can set up modpacks by using the `modpack-*` commands. This allows you to quickly change between a set of mods. For more information, check the help message.
-
-```bash
-h2mm modpack-create -n "Modpack 1"
-# install, enable, disable other mods...
-h2mm modpack-create -n "Modpack 2"
-h2mm modpack-switch -n "Modpack 1"
-```
-
-### Exporting and importing
-
-You can export all installed mods to a zip file and import mods from the same file. This can be useful for sharing mods with others or for backing up your mods. The archive file (`.tar.gz`) will be saved in the current directory.
-
-```bash
-h2mm export
-h2mm import /path/to/mods.tar.gz
-```
-
-### Resetting all installed mods
-
-You can reset all installed mods by running the following command. This will remove all installed mods and the database, in case things go wild.
-
-```bash
-h2mm reset
-```
-
-### Database location and details
-
-The database is stored in the `Helldivers 2` install directory, under the `data` folder with the name `mods.csv`, where the mods are also installed. The database is a simple CSV file which you can use to manually manage mods if needed, you can mostly use it to rename or reorder mods.
 
 ## Contributing
 

install.sh

@@ -7,7 +7,6 @@ ORANGE='\033[0;33m'
 NC='\033[0m'
 
 DESTINATION_PATH="/usr/local/bin"
-SCRIPT_NAME="h2mm"
 REPO_URL="https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master"
 
 function log() {
@@ -30,34 +29,37 @@ function log() {
 
 # warning
 
+log INFO "${RED}!!! WARNING !!!${NC}"
 cat << EOF
-!!! WARNING !!!
+This script will install Helldivers 2 Mod Manager CLI for Linux to $DESTINATION_PATH/h2mm.
-This script will install Helldivers 2 Mod Manager CLI for Linux to $DESTINATION_PATH/$SCRIPT_NAME.
 Running this script will require sudo permissions. DO NOT TRUST random scripts from the internet.
-If you want to review the script before running it, check out the mod repository for yourself:
+If you want to review the script before running it, check out the repository for yourself:
 https://github.com/v4n00/h2mm-cli
-!!! WARNING !!!
-
 EOF
+log INFO "${RED}!!! WARNING !!!${NC}"
+log INFO ""
 
 # breaking changes hash table
 breaking_changes_patches=(
     ["2"]='sed -i "s/^\([0-9]\+\),/\1,ENABLED,/" "$1/mods.csv"'
     ["3"]='sed -i "1 i\\3" "$1/mods.csv"'
-	["4"]='awk '\''BEGIN {FS=OFS=","} NR==1 {print 4; next} {print NR-1, $2, $3, $4, $5}'\'' "$1/mods.csv" | tee "$1/mods.csv" > /dev/null'
+	["4"]='tmp_file=$(mktemp) && awk '\''BEGIN {FS=OFS=","} NR==1 {print 4; next} {print NR-1, $2, $3, $4, $5}'\'' "$1/mods.csv" > "$tmp_file" && tee "$1/mods.csv" < "$tmp_file" > /dev/null && rm "$tmp_file"'
+	["5"]='sed -i "s/^\([0-9]\+\),\(.*\),\(.*\),\(.*\)/\1,\2,\3,,,,\4/" "$1/mods.csv"; sed -i "1 s/4/5/" "$1/mods.csv"'
+	["6"]='sed -i "s/^\([0-9]\+\),\(.*\),\(.*\),\(.*\),\(.*\),\(.*\),\(.*\)/\1,\2,\3,\4,\6,\7/" "$1/mods.csv"; sed -i "1 s/5/6/" "$1/mods.csv"'
 )
 
 # notify if update is happening
 installed_version=""
 latest_version=""
-if [[ -x "$(command -v $SCRIPT_NAME)" ]]; then
+if [[ -x "$(command -v h2mm)" ]]; then
-    installed_version=$($SCRIPT_NAME --version)
+    installed_version=$(h2mm --version)
 
 	# if installed version isn't x.x.x crash
 	if [[ ! "$installed_version" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
 		log ERROR "Installed version is not in the correct format."
 		log ERROR "h2mm is installed here -> $(which h2mm)"
 		log ERROR "Delete the script file and retry the install script, any mods installed will not be lost."
+		log INFO 'Download using the command: bash -c "$(curl -fsSL https://raw.githubusercontent.com/v4n00/h2mm-cli/refs/heads/master/install.sh)"'
 		exit 1
 	fi
 
@@ -82,14 +84,17 @@ if [[ "$response_sd" == "y" || "$response_sd" == "Y" ]]; then
     if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
         # add ~/.local/bin to PATH
         log INFO "Installing the script on a Steam Deck means adding $DESTINATION_PATH to your \$PATH."
-        log INFO "If you're using a different shell than bash, you may need to add it manually."
+        log INFO "If you're using a different shell than bash (the default), you may need to add it manually."
 
 		log PROMPT "Do you want to add $DESTINATION_PATH to your \$PATH in ~/.bashrc? (Y/n): "
         IFS= read -e response
         if [[ "$response" == "y" || "$response" = "Y" || -z "$response" ]]; then
             echo "export PATH=\"\$HOME/.local/bin:\$PATH\"" >> "$HOME/.bashrc"
-
 			[[ $? -ne 0 ]] && { log ERROR "Failed to add $DESTINATION_PATH to \$PATH in ~/.bashrc." ; exit 1; }
+
+			source "$HOME/.bashrc"
+			export PATH="$HOME/.local/bin:$PATH" # fallback kinda in case sourcing fails
+
             log INFO "Added $DESTINATION_PATH to your \$PATH in ~/.bashrc."
         fi
     fi
@@ -111,33 +116,42 @@ latest_major=$(echo "$latest_version" | awk -F. '{print $2}')
 
 if [[ $latest_major -gt $installed_major ]]; then
 	log INFO ""
-	log INFO "Major version upgrade detected."
+	log INFO "${GREEN}IMPORTANT${NC}: Major version upgrade detected. Check out the changelogs here -> https://github.com/v4n00/h2mm-cli/releases"
-	log INFO "Check out the changelogs here -> https://github.com/v4n00/h2mm-cli/releases"
+	log INFO "The script will proceed to upgrade the database file. Creating a backup in case anything goes wrong."
-	log INFO "The script will proceed to upgrade the database file to avoid breaking changes."
 
-	# find hd2 path
+	# make backup
-	search_dir="${HOME}"
+	h2mm export
-	target_dir="Steam/steamapps/common/Helldivers\ 2/data"
 
 	# check if game directory is in ~/.config/h2mm/h2path
 	if [[ -f "$HOME/.config/h2mm/h2path" ]]; then
 		game_dir=$(cat "$HOME/.config/h2mm/h2path")
-		[[ ! -d "$game_dir" ]] && { log ERROR "Helldivers 2 data directory in ~/.config/h2mm/h2path is not a valid directory." ; exit 1; }
+		[[ ! -d "$game_dir" ]] && { log ERROR "Helldivers 2 data directory is not valid: $game_dir." ; exit 1; }
-
-		log INFO "Helldivers 2 data directory found: $game_dir."
 	else
-		log INFO "Searching for the Helldivers 2 data directory... (20 seconds timeout)"
+		log INFO "Searching for the Helldivers 2 data directory... (10 seconds timeout)"
-		game_dir=$(timeout 20 find "$search_dir" -type d -path "*/$target_dir" 2>/dev/null | head -n 1)
+		game_dir=$(timeout 10 find "$HOME" -type d -path "*/Steam/steamapps/common/Helldivers\ 2/data" 2>/dev/null | head -n 1)
 	fi
 
 	# if not found, prompt user
 	if [[ -z "$game_dir" ]]; then
+		# if not found, ask user for the directory
 		log INFO "Could not find the Helldivers 2 data directory automatically."
 		log PROMPT "Please enter the path to the Helldivers 2 data directory: "
-		IFS= read -e game_dir
+		IFS= read -e game_dir; unset IFS
-		if [[ ! -d "$game_dir" ]]; then
+		game_dir="$(substitute_home "$game_dir")"
-			log ERROR "Provided path is not a valid directory."
+
-			exit 1
+		[[ ! -d "$game_dir" ]] && { log ERROR "Provided path is not a valid directory."; exit 1; }
+	else
+		# confirm with the user that the directory is ok
+		log INFO "Found Helldivers 2 data directory: $game_dir"
+		log PROMPT "Is this the correct directory? (Y/n): "
+		read confirm
+
+		if [[ "$confirm" != "y" && "$confirm" != "Y" && "$confirm" != "" ]]; then
+			log PROMPT "Please enter the path to the Helldivers 2 data directory: "
+			IFS= read -e game_dir; unset IFS
+			game_dir="$(substitute_home "$game_dir")"
+
+			[[ ! -d "$game_dir" ]] && { log ERROR "Provided path is not a valid directory."; exit 1; }
 		fi
 	fi
 
@@ -166,11 +180,19 @@ if [[ $latest_major -gt $installed_major ]]; then
 fi
 
 # install
-log INFO "Installing $SCRIPT_NAME to $DESTINATION_PATH."
+log INFO "Installing h2mm to $DESTINATION_PATH."
-sudo curl "$REPO_URL"/h2mm --output "$DESTINATION_PATH/$SCRIPT_NAME"
+sudo curl "$REPO_URL"/h2mm --output "$DESTINATION_PATH/h2mm"
-sudo chmod +x "$DESTINATION_PATH/$SCRIPT_NAME"
+sudo chmod +x "$DESTINATION_PATH/h2mm"
 log INFO ""
 
-[[ ! -x "$(command -v $SCRIPT_NAME)" ]] && { log ERROR "Installation failed. Mod manager was not found in \$PATH." ; exit 1; }
+[[ ! -x "$(command -v h2mm)" ]] && { log ERROR "Installation failed. Mod manager was not found in \$PATH." ; exit 1; }
-log INFO "Helldivers 2 Mod Manager CLI ${GREEN}successfully${NC} installed: $DESTINATION_PATH/$SCRIPT_NAME."
+
-log INFO "Use it by running '$SCRIPT_NAME'. Made with love <3 by v4n and contributors."
+log INFO "Helldivers 2 Mod Manager CLI ${GREEN}successfully${NC} installed."
+log INFO "${GREEN}IMPORTANT${NC}: To install mods, you need to have installed:"
+log INFO " -> \"unzip\" package for .zip archives"
+log INFO " -> \"unarchiver\" package for .rar archives"
+log INFO "If you do not know how to install these packages, please search for your linux distro on how to install packages."
+log INFO ""
+log INFO "Use the mod manager by running 'h2mm' in your terminal."
+log INFO "Check out the Nexus Mods integration by running 'h2mm nexus-setup'."
+log INFO "Made with love <3 by v4n and contributors."

version

@@ -1 +1 @@
-0.4.0
+0.6.0