Merframe is an open-source alternative to AlecaFrame that runs natively on Linux (Proton) and Windows.

Merframe displays information about:

• World timers
• Foundry
• Inventory
• Relics
• Rivens
• Mastery
• Resources
• warframe.market trading
• warframe.market analytics
• Stats

In-game overlays are available on Windows, X11 and XWayland (This includes Wayland since Proton uses XWayland).

Big Warframe script updates (usually big content drops) will break the overlays until Merframe is updated as well. Changes in data structures from content we get from Warframe Community Developers (WFCD) may break the app. Please create an issue if either of these go unnoticed for a day.

You can download the latest release on the releases page, or on the official Merframe website.

Bug reports, feature requests, and contributions are welcome.

Contents

• Notice
• Running the app
• Running the app from source
• Privacy
• How does Merframe work?
• On memory (Linux)
• Credits
• License

Notice

Merframe is a fan project and is not affiliated with Digital Extremes. Warframe and the game artwork under app/public/game/ are the property of Digital Extremes Ltd. and are used under its content policy for non-commercial fan projects.

Running the app

Releases are provided as an .exe or .msi installer (Windows), .deb, .rpm, Arch .pkg.tar.zst packages, and an AppImage.

Windows may warn you on install that the application is not known. This is normal, and I'm not willing to pay Microsoft to make it go away.

AppImage is the preferred way of running the application on Linux. Due to how GitHub serves files, you must set the execution permission yourself: chmod +x ./Merframe_amd64.AppImage.

On Arch, you may install the .pkg.tar.zst with pacman -U, or build it from source with makepkg in packaging/arch/.

Updating

The app will offer you a self-installing update when one is available. You may disable this in settings or at any update offer.

The Arch package does not update itself. You'll have to install the next .pkg.tar.zst with pacman -U again.

Running the app from source

Rust workspace under crates/, Tauri 2 app with a React front end under app/.

You will need:

• rustup (link to rustup)
• pnpm package manager (link to pnpm)

cd app
pnpm install  # Only on first run or after updates
pnpm tauri dev

You can also build a debug binary and run that instead:

cd app
pnpm tauri build --debug
../target/debug/merframe  # Linux, available after the above command
..\target\debug\merframe.exe  # Windows

Running the app from cargo is not supported as that will not start the Vite server.

When a Rust type sent to the front end changes, run pnpm types in app/ to regenerate app/src/types/generated/ and its index.ts. pnpm types:check fails when this needs to be done. The generated files are committed so that pnpm build doesn't need cargo.

Diagnostics: RUST_LOG=merframe_lib=debug,wf_scan=debug pnpm tauri dev. App data: ~/.local/share/Merframe/ on Linux, %APPDATA%\Merframe\ on Windows. App data holds the SQLite store, the last inventory as inventory.json.gz, WFCD image/data cache, settings, and merframe.log.

Privacy

The warframe.market session token (allows acting as you) is stored in plaintext in market_token in the app data directory. It is readable by the user's own processes, just as any other desktop client's session would be. The token does not contain your password.

Merframe is not sending any of your personal data anywhere outside your PC. All third party calls are item-specific lookups and carry no information outside your IP (since the request is coming from your PC).

Services Merframe talks to:

• api.warframe.com: the public world state, polled every 5 to 10 minutes.
• api.warframe.market: orders and riven auctions. Prices work without a login, only listing items needs one.
• api.merframe.net: a price cache run by me, so that Merframe does not ask warframe.market for every item separately. The app fetches this every 15 minutes by default and only downloads it when it changed. The cache itself checks Prime parts and sets every 30 minutes, other items with orders every 4 hours, the rest daily, and refreshes trade volumes and the 90-day history once a day. A price in Merframe is for Prime items at most about half an hour old, for anything else likely a couple hours.
• raw.githubusercontent.com: item data from WFCD's warframe-items.
• cdn.warframestat.us: item images, downloaded once and kept in the app data directory.
• A Discord webhook, only if you set one up under notifications.

How does Merframe work?

Merframe reads out what the game stores in its own space on your computer - the game's memory. This is the same approach AlecaFrame uses (via Overwolf) for inventory data.

Merframe goes a bit further and takes this approach for all data: Your current inventory, displayed riven, riven rolls, relic fissure & relic rewards. AlecaFrame uses OCR for this, which is arguably less risky.

DE has so far tolerated memory reading, but they can not give a clear okay or recommendation for third-party tools. As with all user tools: Use at your own risk.

Memory holds way more than the game shows to a user. Merframe strives to only display what a player could also work out by hand from what the game shows them. To put it in a concrete rule: If it can be done with pen and paper, Merframe may show it.

On memory (Linux)

Merframe reads the memory of the running game through /proc/<pid>/mem on Linux. With kernel.yama.ptrace_scope at 0 or 1, the default of most distributions, this works without any setup. Wine and Proton let other processes of the same user read the game.

A system with scope 2 refuses the read unless Merframe holds CAP_SYS_PTRACE. Scope 3 refuses it in every case and can only be lowered by a reboot. In case of a memory permission issue, Merframe reports it as Reading process <pid> is not permitted.

You have the following options in case you run into that error at scope 2:

Globally set your system's memory read scope until the next reboot (will also allow other programs to read memory across processes)

sudo sysctl kernel.yama.ptrace_scope=0

Allow it for just Merframe:

sudo setcap cap_sys_ptrace=ep ./merframe

Credits

Merframe stands on the work of others. Thank you to:

• AlecaFrame, whose feature set Merframe re-creates for Linux and Windows. No AlecaFrame code is used.
• warframe.market for the trading platform and its public API.
• The Warframe Community Developers: item data from warframe-items, the node, sortie and Nightwave tables from warframe-worldstate-data, the world cycle arithmetic documented by warframe-worldstate-parser, and the item images served from cdn.warframestat.us.
• The editors of the Warframe wiki, the source of the Helminth ability table and of the items the exports do not carry.
• Digital Extremes for Warframe, its public worldState and a content policy that lets fan projects exist.
• ChickenDrawsDogs for their awesome Dog Days "Hang Loose" Poster drawing, which is the header image.
• Tauri, React, shadcn/ui, Radix UI, Tailwind CSS and Lucide, which the app is built with.

License

Merframe is free software under the GNU General Public License, version 3 or (at your option) any later version. The full text is in LICENSE. It comes without any warranty. The game artwork is excluded, see Notice.