- Go 97.3%
- Makefile 2.7%
- Replace procedural addon update logic with structured sync workflow - Add state file tracking installed addons for intelligent removal and updates - Implement async-safe atomic file writes to prevent corruption on failures - Refactor path resolution to support Windows, macOS, and Proton on Linux - Add comprehensive addon list parsing with BOM and comment support - Extract HTTP, zip, and file operations into reusable helpers - Add --region flag for Tamriel Trade Centre price table selection - Add --dry-run flag to preview changes without modifying files - Fix addon update to skip when files are current before downloading - Improve error handling to continue syncing after individual addon failures - Add extensive test coverage for core functionality - Update Makefile with better build targets and SteamOS install instructions - Update systemd units for user-level service on SteamOS - Fix typo in README (Command-line) |
||
|---|---|---|
| .gitignore | ||
| banana.go | ||
| banana.service | ||
| banana.timer | ||
| banana_test.go | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| README.mdown | ||
Elder Scrolls Online Command-line Addon Manager
Elder Scrolls Online addon manager and a Tamriel Trade Centre price table updater.
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:
%USERPROFILE%\Documents\Elder Scrolls Online\
If your Documents folder is synced with OneDrive, it may be under %USERPROFILE%\OneDrive\Documents\Elder Scrolls Online\ instead.
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, one per line.
URLs with or without https:// and www. are accepted.
Lines starting with #, // or - are ignored, which is handy for temporarily disabling an addon.
Addon folder sync
banana keeps the AddOns folder in sync with addons.list.
Any addon folder that does not belong to an addon in the list is deleted, including addons you installed by hand.
Add every addon you want to keep to addons.list first.
To see what would be updated or removed without changing anything, run:
banana --dry-run
banana records which folders each addon installed, and which version, in AddOns/banana.json.
Addons that are already up to date are not downloaded again.
If any entry in addons.list cannot be resolved (a typo, or ESOUI being unreachable), nothing is removed on that run.
Options
| Option | Description |
|---|---|
-i, --addon-list |
path to the addon list file (default: addons.list in the ESO live directory) |
-o, --live-dir |
path to the ESO AddOns directory (default: AddOns in the ESO live directory) |
-t, --ttc |
only update the Tamriel Trade Centre price table |
-r, --region |
Tamriel Trade Centre price table region, us (default) or eu |
-n, --dry-run |
show what would be updated or removed without changing anything |
The price table is only updated when the TamrielTradeCentre addon is installed.
banana exits with a non-zero status if anything failed, after attempting every addon.
Windows Installation
-
Download the latest
banana.exerelease for Windows. -
Add the executable to the user's path or replace "banana.exe" with the full path to where the executable is stored.
-
Run the executable from the command line
banana.exefor a default AddOn update or withbanana.exe -hfor 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
$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."
EU players should add -Argument "--region eu" to the New-ScheduledTaskAction command.
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 the Arch Linux based SteamOS installed on the Steam Deck. They also work on other Linux distributions with Steam installed natively or via Flatpak.
- From the Steam Deck instructions:
From the STEAM menu, select Power, then Switch to Desktop
-
Download the latest
banana.elfrelease for SteamOS. -
Open a terminal in the download folder and install it to
~/.local/bin/banana:
install -D -m 755 banana.elf ~/.local/bin/banana
- Run
bananafrom the command line for a default AddOn update or withbanana -hfor usage. If~/.local/binis not in your$PATH, use~/.local/bin/bananainstead.
Note: banana will create an addons.list file, which can be edited to include additional addon URLs, at the following path:
$EDITOR "~/.steam/steam/steamapps/compatdata/306130/pfx/drive_c/users/steamuser/Documents/Elder Scrolls Online/live/addons.list"
- 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
To run banana every day and shortly after login, install the systemd user timer and service.
This does not need sudo, and survives SteamOS updates.
From a clone of this repository:
make install-steamos
Or by hand, from the folder containing banana.service and banana.timer:
install -D -m 644 -t ~/.config/systemd/user/ banana.service banana.timer
systemctl --user daemon-reload
systemctl --user enable --now banana.timer
The service runs ~/.local/bin/banana; edit ExecStart in banana.service if you installed it elsewhere or want to pass options such as --region eu.
Check recent runs with journalctl --user -u banana.service.
SteamOS Unschedule
Only run the following commands if you wish to remove the scheduled run of banana.
systemctl --user list-timers --all
systemctl --user disable --now banana.timer
Or, from a clone of this repository, make uninstall-steamos, which also removes ~/.local/bin/banana.