Albion Free Market Data Client

⚠️ ATTENTION

After installation, the Data Client will be minimized in system tray!

💻 Data Client

An alternative client for The Albion Online Data Project that provides the same functionality as the official client, but with a user-friendly graphical interface and easy-to-use settings.

Note: Data is mostly uploaded to The Albion Online Data Project, except when the user explicitly chooses not to.

Beta Release: This software is in beta. Use at your own risk.

Important: If you use this client, uninstall the official AODP client to avoid uploading data twice.

Free and Open Source: This software is completely free, open source (check license) and is not tied to the usage of Albion Free Market website. The data uploaded via this software to AODP can be seen in any Albion Online fansite that consumes AODP and even on your own sheets.

🚀 Features

Feature	Description
Gathering and Fishing Tracker	Tracks harvested resources, fishing rewards, session value, and silver per hour
Market Data Collection	Captures in-game market data and uploads to AODP servers
Market Mail Tracking	Collects and displays your market mail data for price tracking
Trade History	Stores instant buy/sell trades for later reference
Damage Tracker	Tracks combat encounters with damage, DPS, healing, fame, and party/player summaries
Loot Tracker	Tracks loots from the player and others, includes estimated market value
Enhanced Capture	Captures data from loadout's quick buy screen, market screens, and gold screen
Specs Capture	Uploads character specs for use with AFM website
Farming Tracker	Privately records island plots, farming inputs/outputs, focus usage, and observed EMV for your AFM account
Launch on Startup	Automatically starts with your system
System Tray	Runs quietly in system tray for minimal interference
Auto-Updates	Silent, automatic updates
Configurable Settings	Adjustable parallelism for AODP's PoW solving and uploads
User-Friendly	No admin permissions required (except for NpCap installation)
Free and Open Source	This software is free to use and is open source

📥 Installation

Windows

1. Navigate to the releases section to download the latest installer (AFMDataClientSetup_v_x.x.x.x.exe)
2. Run the installer and follow the on-screen instructions
3. After installation, the application will run minimized in the system tray
4. Click the tray icon to open the user interface
5. The application will automatically update when new versions are available

Uninstallation

Use the regular Windows Uninstall a program feature to remove the application.

Linux

Option 1: One-line Installer

curl -s https://api.github.com/repos/JPCodeCraft/AlbionDataAvalonia/releases/latest | jq -r '.assets[] | select(.name == "AFMDataClient_Linux64_Installer.sh") | .browser_download_url' | xargs curl -L -o installer.sh && sed -i 's/\r$//' installer.sh && chmod +x installer.sh && ./installer.sh && rm installer.sh

Option 2: Manual Installation

1. Download AFMDataClient_Linux64_Installer.sh from releases
2. Fix line endings: sed -i 's/\r$//' AFMDataClient_Linux64_Installer.sh
3. Make executable: chmod +x AFMDataClient_Linux64_Installer.sh
4. Run the installer: ./AFMDataClient_Linux64_Installer.sh

Uninstallation

curl -s https://api.github.com/repos/JPCodeCraft/AlbionDataAvalonia/releases/latest | jq -r '.assets[] | select(.name == "AFMDataClient_Linux64_Uninstaller.sh") | .browser_download_url' | xargs curl -L -o uninstaller.sh && sed -i 's/\r$//' uninstaller.sh && chmod +x uninstaller.sh && ./uninstaller.sh && rm uninstaller.sh

Note: Linux version does not support automatic updates. Run the installer again to update. Note: Linux installation and software had very limited testing. Feel free to contribute to the repository if you can.

macOS

The macOS version requires macOS 14 or newer. If you are on Apple Silicon, download AFMDataClient_MacOS_arm64.app.zip. Intel users should download AFMDataClient_MacOS_x64.app.zip.

The macOS app is not signed, so macOS may say "AFMDataClient_MacOS" is damaged and can't be opened. Remove the download quarantine flag before opening it:

1. Make sure AFMDataClient_MacOS.app is visible in your Downloads folder. Safari may extract the zip automatically. If you still see only the .zip file, double-click it first.

2. Open Terminal:
   • Press Command + Space to open Spotlight.
   • Type Terminal.
   • Press Return.

3. In Terminal, go to your Downloads folder:

   cd ~/Downloads

4. Remove the quarantine flag from the app:

   xattr -dr com.apple.quarantine AFMDataClient_MacOS.app

5. Drag AFMDataClient_MacOS.app into your Applications folder.

6. Open AFMDataClient_MacOS.app from Applications.

   If double-clicking does not open it, run:

   open /Applications/AFMDataClient_MacOS.app

If packet capture is blocked, the app shows a Capture Blocked status.

It also shows an Install permissions button. Click it, approve the macOS administrator prompt, and let the app restart.

Once it restarts and you get ingame, you should see the app working.

Older AFM installations may instead show Permissions Update Available and an Update permissions button. Run this one-time update to replace the legacy permission service.

AFM checks for new versions and notifies you, but macOS updates must be downloaded and installed manually.

Uninstallation

1. Quit AFM Data Client from the system tray.

2. Open Terminal and remove the packet capture permission service:

   sudo /bin/sh "/Applications/AFMDataClient_MacOS.app/Contents/Resources/uninstall-capture-permissions.sh"

   If you kept the app somewhere other than Applications, adjust the path. The script is safe to run if capture permissions were never installed.

3. Move AFMDataClient_MacOS.app from Applications to Trash.

The uninstaller preserves your database, backups, settings, and logs. To remove all AFM user data as well, run the following only after confirming that you no longer need those files:

rm -rf "$HOME/Library/Application Support/AFMDataClient"

💻 System Requirements

• Windows and Linux: basically anything that can run Albion Online
• macOS: macOS 14 or newer

📊 Features Showcase

Damage Tracker

The Combat tab includes a passive combat tracker for reviewing combat while the client is running. It detects the local player, party members, other players, and mobs from captured packets, then groups health changes and fame gains into combat encounters.

The tracker shows:

• Damage dealt, damage received, healing done, healing received, and fame gained
• Total values, per-second combat rates, and fame-per-hour for the full session or the selected chart window
• Encounter history with duration, status, fame, DPS, damage taken, HPS, and healing received
• Player, party, and mob summaries with filters for all entities, party only, players only, or mobs only
• A time chart with configurable aggregation, total/rate/fame metrics, and 1m, 5m, 10m, 30m, 1h, or unlimited windows

Use the Combat tab's Pause button to stop counting health changes without losing tracked entities, or Reset to clear the current tracker data. If you do not want combat data tracked, enable Disable Combat Tracker in Settings.

Gathering and Fishing Tracker

The Gathering tab includes a passive tracker for reviewing gathering and fishing sessions. A session starts when the first gathered or fished item is recorded, then tracks harvested resources and confirmed fishing rewards from captured packets.

The tracker shows:

• Total estimated session value, silver per hour, total item amount, and elapsed active time
• Item summaries with item images, amount, estimated market value, total estimated value, and silver per hour
• Minute-by-minute activity with item amount, estimated market value, and silver per hour
• Completed session history with saved session totals and item summaries
• Shareable 2400x1350 PNG cards for completed history sessions
• Pause/resume controls for temporarily ignoring new gathering and fishing events
• Save Session and Discard Session controls for manually closing or clearing the current live session

Active gathering/fishing sessions are checkpointed locally so progress can be recovered if the app closes unexpectedly. On startup, an unfinished checkpoint is closed into History using the last recorded activity time. Completed history is saved locally in SQLite and keeps the estimated values from when the session was recorded.

If no gathered or fished reward is recorded for 30 minutes, the current session is automatically saved to History.

If you do not want gathering and fishing data tracked, enable Disable Gathering Tracker in Settings.

User Trades

Settings

❓ FAQ

Is this allowed by the Albion Online developers?

"Our position is quite simple. As long as you just look and analyze we are ok with it. The moment you modify or manipulate something or somehow interfere with our services we will react (e.g. perma-ban, take legal action, whatever)."

— MadDave, Technical Lead at Sandbox Interactive for Albion Online, 2017 (source)

This application:

• ✅ Does NOT modify the game client
• ✅ Does NOT inject code into memory
• ✅ Does NOT track player positions
• ✅ Does NOT display overlays on the game
• 🛜 Does passively capture network packets to collect market data

How do I restore an automatic SQLite backup?

AFM creates a compressed database backup every 24 hours. It keeps the three newest backups plus recovery points closest to 5, 10, and 15 days old. You can open the backup folder and see the same restore instructions in Settings > Backup.

Automatic backups are stored under the app data folder in backups. Each ZIP contains afmdataclient.db. Stored history and player data are included, but the saved sign-in token is removed.

To restore a backup:

1. Exit AFM from the system tray and confirm that it is no longer running.
2. Copy the current data folder somewhere safe.
3. Extract the selected backup ZIP.
4. In the data folder, move aside afmdataclient.db and any afmdataclient.db-wal or afmdataclient.db-shm files.
5. Copy the extracted afmdataclient.db into the data folder.
6. Start AFM, verify the restored history, and sign in again.

How do I migrate all local data, including settings?

All local data (SQLite database, settings, cached files, and automatic backups) is stored under the app data folder.

Windows path

C:\Users\<username>\AppData\Local\AFMDataClient

Linux path (default)

~/.local/share/AFMDataClient

If $XDG_DATA_HOME is set, use:

$XDG_DATA_HOME/AFMDataClient

macOS path (default)

~/Library/Application Support/AFMDataClient

Steps

1. Close AFM (exit from the system tray).
2. Copy the entire AFMDataClient folder from the path above.
3. On the new machine, paste it to the same path.
4. Start AFM.

How do I make it work with ExitLag?

Change the Packets redirection method to Legacy - NDIS in your ExitLag app under the TOOLS section:

🔗 Related Projects

• The Albion Online Data Project
• Albion Free Market

👨‍💻 Credits

This software was developed by JP CodeCraft, the developer behind Albion Free Market.

📊 Download Statistics

View detailed download statistics here.

Building with the shared core

The desktop and Android clients share AFMDataClientCore. This repository pins its library at shared/AFMDataClientCore; no sibling checkout or NuGet feed is required to build.

git clone --recurse-submodules https://github.com/JPCodeCraft/AlbionDataAvalonia.git
cd AlbionDataAvalonia
git submodule update --init --recursive
dotnet restore AlbionDataAvalonia.sln
dotnet build -c Debug AlbionDataAvalonia.sln
dotnet test PowBench.Tests

After switching branches or pulling a change to the submodule pointer, run git submodule update --init --recursive again. Shared changes are committed and pushed in AFMDataClientCore first; each client then updates its pinned commit independently. A standalone development checkout can live beside the clients at Repos/AFMDataClientCore, while builds always reference the pinned submodule.

DesktopClientCore explicitly enables market orders (including loadouts), market history, specs, EMV, islands, gold, and world events. It adapts desktop settings, account credentials, and upload statistics to the shared runtime. Combat, party, gathering/fishing, loot, awakened items, market mail, and trade history remain desktop services and subscribe after shared packet processing. Capture drivers, database schemas, installers, and UI stay in the desktop repository.

Shared-library integration validation includes building the desktop solution and running the PoW correctness tests. Manual checks cover ordinary and loadout market routing, gold and bandit uploads during Private Mode, authenticated specs/EMV/world events, local tracker updates, account/server changes, and island collection, failed actions, offline retry, and restart recovery. Cross-platform capture and UI checks require the corresponding operating systems; builds alone do not validate live game traffic.

Private Mode and sharing

Private Mode saves all captured buy/sell orders, including loadout offers, to your AFM account for the flipper and website price tools. No market-order categories are also sent to AODP. Market history, gold prices and bandit events remain public. Private Mode and both sharing choices default off and are saved in UserSettings.json. All three survive restarts, sign-out and account changes. Turning Private Mode off keeps the sharing choices saved for when it is enabled again. Sharing only applies to private orders while signed in; private order uploads are skipped while signed out, without a public fallback or an offline queue.

Settings > Sharing accepts a user ID, email or exact AFM website username in one field. The website username is not an Albion character name. Both users must add each other; up to five friends are supported. Ambiguous matches are rejected; use email instead. Existing entries remain tied to the saved account if a username changes. Private and shared price summaries expire up to 48 hours after their five-minute observation bin starts. Turning sharing off affects new uploads only.

Release validation: enable Private Mode and both sharing choices, restart, sign out and sign back in (also with another account); verify all choices stay selected. Turn Private Mode off and back on, then disable each sharing choice and repeat restart/sign-out checks to confirm both enabled and disabled values persist. Capture an ordinary item and each former public exception (runes, souls, relics, alchemy extracts and fish sauce), including loadout offers, and confirm no market orders reach AODP. Verify history/gold/bandit uploads remain public. Check tooltips and the Sharing field on a narrow window, and add/remove friends by all three identifiers. These UI/capture checks require a signed-in client and live game traffic.