ESO Tools

(c)2024 Donovan C. Young

This software is published under the terms of the MIT Software License

ESO Tools is a command line tool designed to help manage ESO AddOns

Installation

Using Go

The best method to obtain the latest release is directly via Go itself, so if you have GoLang already installed, you can get the latest release via

go install github.com/dyoung522/esotools@latest

Direct binary download

Otherwise, you can download the pre-compiled binaries from the Assests section in our GitHub Releases

• esotools.exe is the Windows binary
• esotools-linux is the Linux binary
• esotools-osx is the MacOS binary

Feel free to rename them to esotools on your particular system for ease of use.

Configuration

Before you can use the tool, it needs to know the location where your Local ESO game configuration files are installed. This is usually in %Documents%\Elder Scrolls Online on Windows or ${HOME}/Documents/Elder Scrolls Online on MacOS.

Configuration File

The best way to do this is to create an .esotools.yaml file in your HOME directory with the following contents:

eso_home: "/<your-home-directory>/Documents/Elder Scrolls Online"

The advantage to this method is that you only need to do this once, and then can simply run esotools without supplying any additional information.

PLEASE NOTE: DO NOT include the live folder as part of your path.

Other Configuration Options

Optionally, you can also use the command line option --esohome (or -H for short), or set an ESO_HOME environment variable. Using either of these options will override anything in your .esotools.yaml file (if it exists).

command-line option

esotools -H "${HOME}/Documents/Elder Scrolls Online"

environment variable

ESO_HOME="${HOME}/Documents/Game Files/Elder Scrolls Online" esotools

Usage

Usage:

  esotools [command]


Available Commands:

  backup    Various backup commands
  check     Various check commands
  completion Generate the autocompletion script for the specified shell
  help      Help about any command
  list      Various listing commands


Flags:

      --config string   config file (default is $HOME/.esotools.yaml)
  -H, --esohome live    The full installation path of your ESO game files (where the live folder lives).
  -h, --help            help for esotools
  -N, --no-color        do not output ANSI color codes
  -v, --verbose count   counted verbosity
      --version         version for esotools


Use "esotools [command] --help" for more information about a command.

Commands

backup savedvars

Creates a ZIP backup file of all SavedVariables in the current directory.


Usage:

  esotools backup savedvars [flags]


Flags:

  -h, --help   help for savedvars

check addons

Checks AddOns installed in the ESO AddOns directory, and reports any errors


Usage:

  esotools check addons [flags]


Flags:

  -h, --help       help for addons
  -o, --optional   Warn if optional dependencies aren't installed as well

check savedvars [--backup|--clean|--dryrun]

Specifically, it reports on extraneous SavedVariable files that do not correspond to any known AddOn.
Optionally, you can auto-remove them with the --clean flag.


Usage:

  esotools check savedvars [flags]


Flags:

      --backup    Performs a backup prior to any destructive actions
      --clean     Removes extranious SavedVariable files
      --dry-run   Shows what changes would be made without actually making them. Use this to double-check before using --clean
  -h, --help      help for savedvars

list addons

Lists AddOns installed in the ESO AddOns directory.

By default, this will print out a simple list with only one AddOn per line. However, other formats may be specified via the flags.


Usage:

  esotools list addons [flags]


Flags:

  -h, --help       help for addons
  -j, --json       Print out the list in JSON format
  -m, --markdown   Print out the list in markdown format
  -D, --no-deps    Suppresses printing of AddOns that are dependencies of other AddOns
  -L, --no-libs    Suppresses printing of AddOns that are considered Libraries
  -r, --raw        Print out the list in the RAW ESO AddOn header format (most verbose)
  -s, --simple     Prints the AddOn listing in simple plain text