
>_ Torn Atlaslocal ledger & journal
Get started
Torn Atlas is in beta (v0.9). You can browse shared tools right away, connect your own account with the browser extension, or use the Travel script inside Torn.
Extension or Travel script?
- Browser extension — full dashboard and background history. Use it for personal stats, net worth charts, trips, and flips. It attempts a sync every three minutes while the browser is running, even with Torn and Torn Atlas tabs closed. Snapshots and logs stay in this browser profile. The current download is a ZIP you install manually using the steps below.
- Travel script — travel tools inside Torn. Install it from a link if you already use Tampermonkey on desktop or Torn PDA on mobile. It runs on matching Torn pages and shows ranked trips, restock timers, and a day plan. The optional Log tab reads recent travel and shopping activity with a limited Torn API key. Full dashboard history and background sync are extension features.
What is Torn Atlas
A dashboard for your Torn account, built around the stuff spreadsheets and half-remembered tabs used to handle: your stats and vitals at a glance, a net worth/cash trend graph, a travel day-planner that scores every destination by real profit-per-hour (using live abroad stock data, not guesswork), a trip log, market and stock-market tools with swing signals, crimes reference data (including a full unique-outcome breakdown per crime type, community-sourced since Torn's own API doesn't expose it), and education tracking.
It's built for one person's account per browser - there's no shared login, no leaderboard, nothing social. You connect your own key, you see your own data. The shared stuff (item and stock prices, abroad stock) is the same for everyone and needs no key at all.
Why a site and an extension
Torn Atlas is two separate pieces working together, and that split exists specifically to keep your API key off any server:
- The extension holds your API key and talks to Torn's own official API directly from your browser. It never hands the key to this site or anyone else - it just keeps a local, rolling copy of your synced data.
- The site is the dashboard/UI. It never sees your key at all - each page just asks the extension (already sitting in your browser) for the latest synced results and renders them. That's the only thing that crosses to this server, and only for the moment it takes to build that one page - see exactly what that means below and in Terms & data policy.
A single combined tool could technically work the same way client-side, but splitting them makes the trust boundary obvious and checkable: the extension's code is short enough to read in five minutes and confirm it only ever calls api.torn.com, full stop.
What actually happens when you connect
Torn Atlas has two kinds of data:
- Shared data - item market prices, stock prices, abroad stock (YATA). Same for every visitor, updates in the background automatically, no key needed at all. You already see this on Market and Finance.
- Your personal data - stats, net worth, vitals, travel, crimes. This comes ONLY from a small browser extension you install yourself. It reads your API key and calls Torn's own official API directly from your browser - your key itself is never sent to this site, ever. The result is kept in your browser's own local storage, and when you load a page here that needs it, your browser sends THAT (not your key) to this server once, to render the page - it's used in memory for that one response and never written to any database, never logged, never kept around afterward, and never visible to any other visitor, not even the site operator. Every page that shows this kind of data repeats that same fetch-and-send fresh, each time you load it - nothing persists here between loads.
Concretely, the extension: syncs automatically every 3 minutes while your browser is open (or instantly if you click "Sync now"), fetches your profile/stats/bars/travel/cooldowns/education/crimes-relevant fields, and stores only a rolling snapshot locally. Uninstalling the extension deletes all of it instantly, since nothing is kept anywhere else on an ongoing basis.
Install the extension
This is a manual "Load unpacked" install, not a Chrome Web Store listing - and honestly, that's arguably the more trustworthy way to install it: you can open every file in a text editor and read exactly what it does before it ever touches your browser, rather than trusting a store listing and its update pipeline. It's also the only real option while Torn Atlas is still invite-only for testing.
- Download the extension (.zip) and unzip it somewhere you won't delete - your browser loads it live from that folder, so don't move or remove it afterward.
- In Chrome or Brave, go to
chrome://extensions (or brave://extensions).
- Turn on Developer mode (top-right toggle).
- Click Load unpacked and select the unzipped
torn-atlas-extension folder.
- Click the new Torn Atlas icon in your toolbar (pin it via the puzzle-piece icon if you don't see it).
- In the popup, click Settings.
- Don't have a Torn API key yet? Generate one here - pick Limited Access, nothing more is needed.
- Paste your key into the extension's Options page and click Save - it syncs immediately.
- Visit Torn Atlas (the link you were given) and open the Dashboard - your stats should be there within a few seconds.
Updating the extension later
When a new version comes out, you'll need to grab it again - but how you update matters. Everything the extension has learned about your account (your trip log, Flipping trades, saved API key, timezone) lives in your browser's local storage, tied to that specific extension folder. Update it the right way and all of that stays intact; update it the wrong way and it's gone for good, since none of it is ever backed up anywhere else on purpose (see Terms & data policy).
Do this:
- Download the new zip and unzip it into the exact same folder you used the first time, overwriting the old files. Don't unzip it into a new folder - Windows will often name it something like "torn-atlas-extension (1)" if you're not careful, and that counts as a different folder to your browser.
- Go to
chrome://extensions (or brave://extensions), find Torn Atlas, and click the small reload icon (a circular arrow) on its card.
- If you already had a Torn Atlas tab open, close it completely and open a fresh one - a plain refresh (F5) doesn't reliably reconnect an already-open tab to the reloaded extension, and you'll see "No response from the Torn Atlas extension" until you do.
Don't do this: removing the extension and adding it again via "Load unpacked", or unzipping updates into a fresh folder each time. Either one gives your browser a brand-new copy of the extension with empty storage - your trip log and everything else it remembers starts over from zero, silently, with no warning.
Along the way
Everything on the nav is live now - dashboard, travel day-planner and trip log, market/finance tools, crimes reference, education, stats. See Terms & data policy for exactly what's stored where.