A free, live Fortnite ranked overlay and ELO tracker for streamers. Pulls real-time ELO, rank, and season stats from OliTracker and displays them as an OBS browser source, so your Fortnite stream overlay always shows your current rank without you touching a thing.
✨ 8 designs to choose from, any accent color you want, each one self-contained in its own folder, just grab the one you like.
A start-to-finish video showing how to download, set up, and use the overlay:
▶️ Not playing here? Click to watch or download the setup video (it's also attached to the latest release).
- Watch: full setup walkthrough
- Quick start
- Setup wizard (the easy way)
- Features
- Designs
- Requirements
- Setup
- Switching game modes
- Switching between stats and creator code
- Troubleshooting
- Changing the accent color
- FAQ
- How it works
- License
🧙 The fastest way is the setup wizard it does every step below for you (design, color, Account ID lookup, and launch). Prefer to set it up by hand? Here's the manual way:
- Click Code > Download ZIP above, unzip it, and open the folder for the design you want (see the gallery below). Or just run
setup.batand it'll ask which design you want and copy it straight to your Desktop. - Run
account-id.batto look up your Epic Account ID. - Open
server.py, paste your username and account ID into the two lines near the top, save. - Run
start.bat. Add a Browser Source in OBS pointed athttp://localhost:8888/overlay.
That's it, you're live. Full details for each step are below if you get stuck anywhere. 👇
Don't want to edit any files by hand? Download FortniteOverlaySetup.zip from the latest release, unzip it, and run FortniteOverlaySetup.exe inside the extracted folder instead of the manual steps above.
It walks you through everything in a console window: picks a design from a small preview window, lets you set an accent color (by name or hex code), asks whether you want stats or a creator code shown, looks up your Epic Account ID for you automatically, then builds a ready-to-run overlay folder right next to the .exe and offers to start it and open it in your browser, all in one go. If an overlay is already running on port 8888, it stops that one first so the new one can take over. No editing server.py, no separate Account ID lookup step.
💡 The wizard is just a convenience layer over the same 8 designs in this repo, it builds the exact same
server.py/start.bat/stop.batfiles described below. Use whichever way you prefer.
⚠️ It ships as a zip (rather than a single.exe) because standalone PyInstaller executables are commonly flagged as false positives by antivirus heuristics, distributing it as an extracted folder instead of a self-extracting single file avoids that. Windows SmartScreen may still warn the first time you run it since it's an unsigned indie tool, click More info > Run anyway, same as the.batfiles.
- Live rank, ELO, and leaderboard position, pulled every 10 seconds
- Session ELO delta: tracks how much you've gained or lost since you started the overlay
- Unreal leaderboard tracking: shows ELO to next rank (
NEXT 14 ELO to #66) - Non-Unreal progress tracking: shows promotion progress % and percent gained today (
53% TO GOLD III) - Mode switcher for BR, Reload, and Boxfights, each with its own independent stats, and your last selected mode is remembered the next time the overlay loads
- Live stats / creator code toggle, right in the browser, no restart needed, see below
- Season stats (K/D, Win%, Kills, Wins), accurate per game mode
- 8 overlay designs, any accent color you want
- Built-in error messages: if something goes wrong (bad account ID, OliTracker is down, etc.) a small message shows under the card instead of the overlay just sitting there blank
Click a design's name to open its folder. Every design can show either season stats or a creator code, switchable live with the on-overlay toggle, so each one gets two previews below.
| Design | Stats mode | Creator code mode |
|---|---|---|
| Minimal Clean single-row card with rank and ELO side-by-side and a bold colored left border. |
 |
 |
| Classic A timeless dark card with a thin top accent line and subtle dividers between sections. |
 |
 |
| Sharp Stacked sections with a strong accent color and clipped corners. Feels structured and aggressive. |
 |
 |
| Wide Spread out horizontally with a glowing accent bar on the left. Great for wider stream layouts. |
 |
 |
| Slash A diagonal cut splits the rank and ELO into two panels. Stands out on any stream. |
 |
 |
| Rainbow Animated rainbow rank text and a shimmering ELO value. High energy. |
 |
 |
| Modern Sleek card with a soft radial glow accent and a bold colored left border. |
 |
 |
| Pulse Green terminal HUD with a radial progress gauge and monospace readout. Built for a clean, tactical look. |
 |
 |
- Python 3 or later. Download it from python.org/downloads if you don't have it. During setup, tick Add python.exe to PATH, the overlay won't start without it.
- Windows. The
.batfiles are Windows only. Mac/Linux users can runpython server.pydirectly from a terminal, and look up their Account ID manually at olitracker.com instead of usingaccount-id.bat. - OBS Studio with a Browser Source.
- Your Epic Account ID (the bundled
account-id.batlooks this up for you, see Setup below).
💡 Every design folder (
Minimal/,Classic/,Sharp/,Wide/,Slash/,Rainbow/,Modern/,Pulse/) is self-contained: it has its ownserver.py,account-id.bat,start.bat, andstop.bat. You only ever need the one folder for the design you picked.
Click Code > Download ZIP at the top of this page, then unzip it anywhere on your PC. Your Desktop works fine. The ZIP includes all 8 designs, so open the folder for the one you picked from the gallery above, everything you need is in there.
If you'd rather not dig through folders, run setup.bat in the unzipped repo. It asks which design you want and copies just that one to your Desktop in a clean folder by itself.
⚠️ Windows may show a SmartScreen warning ("Windows protected your PC") the first time you run any of the.batfiles, since they were downloaded from the internet. Click More info > Run anyway. This is normal for any downloaded script, the files only run Python and a console window, nothing else.
Double-click account-id.bat. Enter your Epic display name and it will print your account ID in the console window and copy it to your clipboard.
If it can't find your account, search your username at olitracker.com instead, open your profile, and copy the account ID out of the page URL.
Open server.py in Notepad (right-click > Open with > Notepad) and find these two lines near the top:
EPIC_USERNAME = "YourUsername"
EPIC_ACCOUNT_ID = "your-account-id-here"Replace both values with your username and account ID, then save the file.
Double-click start.bat. A window will briefly appear confirming it started, then close itself, and the overlay opens in your browser so you can see it's working. The overlay keeps running in the background after you close that tab.
- On some setups (depends on how Python was installed) a second window titled "Fortnite Overlay Server" stays open instead of closing. That's normal, just leave it open and minimize it, closing it stops the overlay.
- To stop the overlay, double-click
stop.bat. - Want to run more than one design at once to compare them side by side? Each one defaults to port
8888, so only one can run at a time on that port. Openserver.pyin the second design's folder and changePORT = 8888to something else like8889, then use that port in its OBS Browser Source URL.
- In OBS, click the + button under Sources
- Select Browser
- Set the URL to
http://localhost:8888/overlay - Set Width to
600and Height to300(adjust to taste) - Click OK
🎉 The overlay will appear and start showing your live stats within a few seconds of your first game.
The overlay shows mode buttons (BR, Reload, Boxfights) below the widget. Click a button to switch, and the rank, ELO, and stats all update for that mode. Your choice is remembered the next time you open the overlay. In OBS you can interact with browser sources by right-clicking the source and selecting Interact.
ℹ️ You'll only see buttons for modes you actually have ranked stats in. If you've never queued Reload, no Reload button shows up, that's expected, not a bug.
Below the mode buttons there are two more buttons, Stats and Creator Code. Click between them to switch what shows on the card, live, with no server restart needed. Pick Creator Code and a text box appears where you can type your own code directly in the browser, it updates the overlay instantly as you type. Switching between the two never changes the size of the overlay, so nothing else in your OBS scene shifts around.
Your choice and the code you typed are remembered per design the next time the overlay loads, the same way the BR/Reload/Boxfights choice is remembered. The CREATOR_CODE value in server.py (or whatever you picked in the wizard) sets the starting default: that's what shows the first time, and if you later change it there and restart, the new setting takes over again.
Overlay shows "starting up" for a long time
OliTracker may be slow to respond. Wait 30 seconds, and if it still doesn't load, check that your Account ID in server.py is correct.
A small orange message shows up under the overlay
That's the actual error from the server. For example, HTTP 404 from OliTracker usually means the account ID is wrong, and no ranked data found usually means the account has no ranked games played yet. Fix what it says and it clears on the next poll.
Port already in use error
Something else is using port 8888. Run stop.bat first, then start it again. If the issue persists, change PORT = 8888 to another number like 8889 in server.py and update the OBS URL to match.
Stats look wrong after switching modes Give it one poll cycle (about 10 seconds) after clicking a mode button. The server fetches fresh data on each cycle.
OBS shows a black box instead of the overlay
Make sure start.bat has been run first, the browser source needs the local server running. Also double check the URL in OBS is exactly http://localhost:8888/overlay.
Windows says the file is unsafe / SmartScreen popup
That's expected for any .bat file downloaded from the internet. Click More info > Run anyway.
I want to see exactly what the server is doing
While the overlay is running, open http://localhost:8888/debug in a browser for a full status dump (current rank, ELO, detected modes, last error), or http://localhost:8888/raw for the raw OliTracker response. Both are handy if something looks wrong and the on-overlay error message isn't enough to go on.
Two ways to do this:
🔍 Quick preview, no editing
Add ?color= followed by a hex code to the overlay URL, both in your regular browser and in the OBS Browser Source. For example: http://localhost:8888/overlay?color=ff7a00. This overrides the accent color at runtime, useful for trying out a color before committing to it. (On the Rainbow design, the rank text always stays an animated rainbow, the override only changes the highlight colors around it.)
💾 Permanent change
Open server.py and find the CSS inside OVERLAY_HTML. Near the top of the <style> block, inside :root, there's an --accent hex value (the design's main color) and a matching --accent-rgb (the same color as r, g, b). Change both to your color and the whole design updates. Use coolors.co to pick one. (Tip: the ?color= trick above is easier and updates both for you, no editing needed.)
Does this work on Mac or Linux?
Yes! Run python server.py from a terminal instead of start.bat, and look up your Account ID manually at olitracker.com instead of running account-id.bat. Everything else is the same.
Can I run two designs at the same time to compare them? Yes, see the port note under Setup above. Change the port in one of them so they don't collide.
Does this slow down Fortnite or use a lot of resources? Nope. It's a tiny local web server that polls OliTracker every 10 seconds. CPU and memory use are both negligible.
Can I resize or reposition the overlay? Yes, it's a normal OBS Browser Source. Resize, move, and add filters to it exactly like any other source.
Will this break if Epic or OliTracker changes something?
It depends on OliTracker's API staying in the same shape. If stats suddenly stop updating, check /debug first (see Troubleshooting), and check that olitracker.com itself is loading your stats correctly in a normal browser.
Is any of my data sent anywhere besides OliTracker? No. The server only talks to the OliTracker API to pull your stats, and serves the overlay page to your own browser/OBS on your own PC. Nothing else.
This Fortnite rank tracker is a small Python web server that runs locally on your PC. It polls the OliTracker API every 10 seconds, parses your ranked stats, and serves a single HTML page at localhost:8888/overlay. OBS loads that page as a browser source and auto-refreshes the displayed data, turning it into a live Fortnite stream overlay with zero manual updates. No data ever leaves your machine other than the API request to OliTracker.
MIT, see LICENSE. Use it, edit it, ship it, just don't blame us if Fortnite changes their API.
Built by fwsoapy on Discord. Stats powered by OliTracker.