Elder Scrolls Online addon manager and a Tamriel Trade Centre price table updater.
  • Go 97.3%
  • Makefile 2.7%
Find a file
JoYo 3f6c7e32dd Refactor addon manager with state tracking and improved architecture
- 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)
2026-11-06 17:35:08 -05:00
.gitignore Refactor addon and TCC updates 2026-11-06 17:12:10 -05:00
banana.go Refactor addon manager with state tracking and improved architecture 2026-11-06 17:35:08 -05:00
banana.service Refactor addon manager with state tracking and improved architecture 2026-11-06 17:35:08 -05:00
banana.timer Refactor addon manager with state tracking and improved architecture 2026-11-06 17:35:08 -05:00
banana_test.go Refactor addon manager with state tracking and improved architecture 2026-11-06 17:35:08 -05:00
go.mod initial go rewrite 2024-06-05 01:01:15 -04:00
go.sum Refactor addon and TCC updates 2026-11-06 17:12:10 -05:00
LICENSE Initial commit 2021-12-05 19:27:05 +00:00
Makefile Refactor addon manager with state tracking and improved architecture 2026-11-06 17:35:08 -05:00
README.mdown Refactor addon manager with state tracking and improved architecture 2026-11-06 17:35:08 -05:00

Elder Scrolls Online Command-line 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:

%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

  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 command line 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
$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.

  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. Open a terminal in the download folder and install it to ~/.local/bin/banana:

install -D -m 755 banana.elf ~/.local/bin/banana
  1. Run banana from the command line for a default AddOn update or with banana -h for usage. If ~/.local/bin is not in your $PATH, use ~/.local/bin/banana instead.

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"

  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

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.