Skip to content

Latest commit

Β 

History

772 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Albion Free Market Data Client

Release Downloads

⚠️ ATTENTION

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

image

πŸ’» 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.

market

πŸš€ 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
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.

image

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:

image
  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.
image
  1. Open Terminal:
    • Press Command + Space to open Spotlight.
    • Type Terminal.
    • Press Return.
image
  1. In Terminal, go to your Downloads folder:

    cd ~/Downloads
  2. Remove the quarantine flag from the app:

    xattr -dr com.apple.quarantine AFMDataClient_MacOS.app
image
  1. Drag AFMDataClient_MacOS.app into your Applications folder.

  2. 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.

image

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

image

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

image

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

User Trades

Settings

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:

ExitLag Settings

πŸ”— Related Projects

πŸ‘¨β€πŸ’» Credits

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

πŸ“Š Download Statistics

View detailed download statistics here.

About

No description, website, or topics provided.

Resources

Stars

39 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages