banana/README.mdown

4.9 KiB

Elder Scrolls Online Commadline Addon Manager

Elder Scrolls Online addon manager and a Tamriel Trade Centre price table updater.

MIT License

It is recommended that you back up your ESO live profile before using banana in case you want to revert back.

On Windows, press Windows Key + e to open a file explorer and enter the following path in the address bar:

%HOME%\Documents\Elder Scrolls Online\

or on Windows 11

Documents\Elder Scrolls Online\

Make a copy of the live folder and rename it to something meaningful like old or backup.

Usage

Follow the installation instructions for your platform:

On first run, the addons.list file will be created in your ESO live directory. It will look similar to the following:

https://www.esoui.com/downloads/info7-LibAddonMenu.html
https://www.esoui.com/downloads/info1245-TamrielTradeCentre.html
https://www.esoui.com/downloads/info1146-LibCustomMenu.html

Add the ESOUI url for each additional addon you wish to keep updated. Make sure to include the www. indicator that ESOUI requires for some stupid reason.

Windows Installation

  1. Download the latest banana.exe release for Windows.

  2. Add the executable to the user's path or replace "banana.exe" with the full path to where the executable is stored.

  3. Run the executable from the commandline banana.exe for a default AddOn update or with banana.exe -h for usage.

Windows Optional

To schedule a periodic background run of banana, open Powershell as a user and enter the following commands.

$Command = (Get-Command "banana.exe").Source
$Action = New-ScheduledTaskAction -Execute $Command -Argument "--log"
$Trigger = New-ScheduledTaskTrigger -Daily -At 11am
$Settings = New-ScheduledTaskSettingsSet -RunOnlyIfNetworkAvailable -StartWhenAvailable -RunOnlyIfIdle
Register-ScheduledTask -TaskName "eso-banana" -Action $Action -Trigger $Trigger -Settings $Settings -Description "Elder Scrolls Online addon manager and a Tamriel Trade Centre price table updater."

To check to make sure the task is registered correctly, enter Get-ScheduledTask and check that the first entry looks similar:

TaskPath                                TaskName                          State
--------                                --------                          -----
\                                       eso-banana                        Ready

Windows Unschedule

Only run the following command if you wish to remove scheduled run of eso-banana.

To remove the schedule, use the Unregister-ScheduledTask command:

Unregister-ScheduledTask eso-banana

Press enter to confirm removal.

SteamOS Installation

The following instructions are for arch linux system installed with the Steam Deck.

  1. From the Steam Deck instructions:

From the STEAM menu, select Power, then Switch to Desktop

  1. Download the latest banana.elf release for SteamOS.

  2. Set executable with chmod +x banana.elf and add the executable to ~/.local/bin/ or any directory in the user's $PATH environment.

    • optionally replace "banana.elf" with the full path to where the executable is stored.
  3. Run the executable from the commandline banana.elf for a default AddOn update or with banana.elf -h for usage.

Note: banana will create and addons.list file which can be edited to include additional adddon URLs at the following path:

$EDITOR "~/.steam/steam/steamapps/compatdata/306130/pfx/drive_c/users/steamuser/Documents/Elder Scrolls Online/live/addons.list"

  1. To return to Gaming Mode:

...there's a shortcut link to 'Return to Gaming Mode'. Select that to get back to standard Steam Deck UI. You can also go through the system menus to Log Off to get back.

SteamOS Optional

Because systemd is cancer you will need to edit the banana.service file to include your user's home path. If banana is not installed to ~/.local/bin/banana.elf, open a new terminal and use the results from which banana.elf.

[Unit]
Description="Elder Scrolls Online addon manager and a Tamriel Trade Centre price table updater."
Wants=banana.timer

[Service]
Type=oneshot
ExecStart=/home/<user_name_here>/.local/bin/banana.elf
User=deck

[Install]
WantedBy=multi-user.target

Finally, install the systemd timer and service to run banana everyday.

cd ./banana/
cp banana.timer banana.service /etc/systemd/system/
sudo systemctl enable banana.timer
sudo systemctl enable banana.service

SteamOS Unschedule

Only run the following command if you wish to remove scheduled run of banana.

systemctl list-timers --all
sudo systemctl disable banana.timer