Every fixture, result, table and cup tie in your Football Manager save, laid out like a broadcast and never changed.
A Windows desktop viewer for the fixtures, results, grids and league tables in a Football Manager 27 (or 26) save. Saves are read with fmsave and are never modified.
Database viewer · entry point fm_review.py · launcher Box2Box.bat
Release: 1.8
Status: Current version on main
Application on disk: fm_review.py (VERSION 1.8), launched with Box2Box.bat
- Why Box2Box
- Key features
- Glimpse
- Quick start
- How a save reaches the screen
- Keyboard and mouse
- Feature tour
- Themes and club colours
- Exports
- Start Box2Box from the desktop
- How it is built
- Project layout
- Tests
- Release history
- Copyright and licence
Football Manager keeps every fixture and result of every competition in your save, but the game shows them a screen at a time. Box2Box opens the save beside the game and lays the lot out at once: a home-and-away grid, tables with their zones, form and streaks, positions by matchday, expected goals, two-legged ties and a cup bracket.
Important
Your save is only ever read.
- Box2Box opens the save with
fmsaveand never writes to it. The status bar says so on every save. - Where the save does not hold something, Box2Box says so: an unrecovered score reads n/a or ?, a missing statistic reads —, and an estimated zone or an unfinished season is labelled.
- Competition names, settings and exports are kept in files of their own, never in the save.
| Pillar | What you get |
|---|---|
| Read only | The save is opened, read and closed; nothing in it is ever changed |
| Honest about gaps | Coverage counts, "n/a" scores, "at least" runs and estimated zones are all spelt out |
| Built for big saves | A save opens in about half a minute, and its expected goals follow while you browse |
| Yours to share | Excel, a single web page, CSV files, or a table ready to paste into a forum post |
| 🏆 Competitions hub | Every competition in the save, sorted into Your Club, League, Cup, Youth / Reserves and Friendlies, with entrants, fixtures and season progress |
| 🔲 Fixture grid | A high-contrast home-and-away matrix, coloured from the followed club's point of view |
| 📊 League standings | Broadcast-style zones from the save's own rules, and Overall, Home, Away and Form splits with W, D, L badges |
| 📈 Analysis | Form, Positions (matchday chart or season against season), xG, Ties and Bracket panels |
| 🏟️ Cup bracket | A knockout cup drawn as a tree of its last rounds, with aggregates, replays and the winner in bold |
| 🔍 Inspector drawer | Ctrl+I: a match's statistics and every meeting between the two clubs, or a club's form, record and next match |
| ⌨️ Command palette | Ctrl+K or Ctrl+P: jump to any competition, club, view, panel or action in a few keystrokes |
| 🖱️ Right-click menu | Follow either club, show only the meetings of two clubs, export or copy, from any row |
| 🗓️ Weekly results | Every match by week, matchday or date, with a club's campaign and running points |
| 🎨 Themes and club colours | Four themes, and the colours of the club you follow worked into the window |
| 📤 Exports | Excel workbook, standalone web page, CSV files, and Copy for a post for Reddit or the SI forums |
| 📂 Drag and drop | Drop a .fm save onto the launcher or the open window to open it |
The Table view on a made-up league of fictional clubs, in the Midnight Emerald theme.
The four themes: Midnight Emerald, Cyber Pitch, Deep Slate & Gold and High-Contrast.
Nothing in these pictures is read from a save: the league, the clubs and the followed club's colours were invented for them.
The standalone Windows build is the quickest path: unzip the folder from the latest Release, then double-click Box2Box.exe inside it. Nothing to install: Python, the libraries and the app icon are bundled. Settings and the error log are written next to Box2Box.exe, so the folder is portable — put it on a USB stick or a different drive and it behaves the same. Windows SmartScreen may prompt the first time because the exe is not code-signed; pick More info → Run anyway.
From source, double-click the Box2Box shortcut on the desktop (see below) or Box2Box.bat, then Open save…. Saves live in Documents\Sports Interactive\Football Manager 27\games. Reading one takes around half a minute. The save opens as soon as it has been read; its expected goals follow about 12 seconds later, while you browse. You can also drag a .fm save file onto the launcher to open it straight away, or onto the open window to switch to it: one save at a time, and not while another is still being read. Dropping onto the window uses tkinterdnd2 (installed from requirements.txt); without it the window works as before and says so.
From a terminal:
.venv\Scripts\python fm_review.py ["path\to\save.fm"]To set the environment up again:
py -3.14 -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txtPython 3.12 or newer is required. This working tree uses Python 3.14 in .venv.
flowchart LR
A["💾 .fm save<br/>FM27 or FM26"] --> B["📖 fmsave<br/>opens it read only"]
B --> C["🧮 fm_data<br/>builds the Dataset"]
C --> D["🖥️ Box2Box window<br/>views open"]
B -. "about 12 s later" .-> E["⚡ Match statistics<br/>expected goals"]
E -.-> D
D --> F["📤 Export ▾<br/>Excel · web page · CSV"]
D --> G["📋 Copy for a post<br/>Markdown + HTML"]
The save is read on a background thread, so the window stays responsive. Clubs, competitions, fixtures and results, league tables and competition rules come first; as soon as they are in, the views open. The match statistics behind expected goals take longest, so they are read last and added while you browse. Another save cannot be opened until they have arrived. A reader that fails on an unrecognised game build is noted in Save details & warnings, and everything else still opens.
flowchart TD
DS["🧮 Dataset<br/>one save"] --> HUB["🏆 Competitions<br/>hub"]
HUB -- "pick a competition<br/>and season" --> V{{"View switch"}}
V --> R["🗓️ Results<br/>by week, matchday or date"]
V --> G["🔲 Grid<br/>home and away"]
V --> T["📊 Table<br/>Overall · Home · Away · Form"]
V --> AN["📈 Analysis"]
AN --> AF["Form"]
AN --> AP["Positions<br/>matchday chart or season vs season"]
AN --> AX["xG"]
AN --> AT["Ties"]
AN --> AB["Bracket"]
R & G & T & AN -. "select a match or club" .-> I["🔍 Inspector<br/>Ctrl+I"]
| Keys or action | What it does |
|---|---|
| Ctrl+K or Ctrl+P | Open the command palette |
| Up / Down, Enter | Move through the palette's results, and go to the chosen one |
| Ctrl+I | Open or close the inspector drawer |
| Esc | Close the command palette or the inspector drawer |
| Right-click a row | Follow either club, Show only two clubs' meetings, export or copy |
| Click a team | Follow it (Table and Analysis) |
| Double-click a competition | Open it in the view you last used (Competitions hub) |
| Hover a W, D, L or ? badge | See that match in words |
Drop a .fm file |
Open it: onto Box2Box.bat, Box2Box.exe or the open window |
Open a feature for the full details.
🏆 Competitions hub
Competitions hub. Browse every competition in the save, classified into Your Club, League, Cup, Youth / Reserves and Friendlies. The hub shows entrants, fixture volume, matches played and season progress. Click a row to select that competition; double-click it, or pick it in the list on the left, to open it in the view you last used.
🔲 Fixture grid
Fixture grid. A high-contrast home-and-away matrix. When you follow a club, its row and column show results from that club's perspective (emerald for wins, amber for draws, crimson for defeats).
📊 League standings
League standings. Broadcast-style zone colours for promotion, play-offs and relegation, taken from the save's own competition rules where they can be matched — for example the Championship shows 1st–2nd promoted, 3rd–8th in the play-offs and 22nd–24th relegated. Where the rules cannot be matched (League One and League Two before their season starts), and for the Champions League and Europa League places of a 20-team top division, the zones are estimated from the league's size, and the note above the table says so. Zones are shown on the Overall table. Split the table instantly between Overall, Home, Away and Form (last five matches). Form is drawn as coloured W, D, L and ? badges, each row has a strip down its left edge in its zone's colour, a colour key sits under the table, and a small bar under each goal difference shows how large it is. Hover a badge to see that match in words, for example "Won 2-1 v Leeds United, Sat 8 Aug"; the same works in the Analysis Form panel and the inspector. A table worked out from the results separates teams level on points as the competition's own rules list them, where results can settle it (wins first in MLS and Brazil, goal difference first in most leagues), and the note says which order it used.
📈 Analysis: Form, Positions and xG
Analysis. Three looks at a season, each stating how much of it the save covers:
- Form: every team's last five results, current run, points per game, totals (clean sheets and failures to score among them) and longest winning, unbeaten, winless and losing runs, with the season's records underneath. Click a team to follow it; its last five appear in words below the sheet. A played match whose score the save does not hold shows as ?, counts in no total, and any run it touches reads "at least".
- Positions: each team's place after every matchday, worked out from the results and ranked within each of the game's tables (conferences and zones included), coloured by zone, and checked against the game's own table. For a league with at least two seasons in the save, a Matchday chart / Season vs season switch at the top of the panel flips to a side-by-side final standings table, newest season on the left, with a Δ Pos column showing the move since the previous season. Each column says (final) when every league match has a score and (in progress, X of Y) otherwise, and carries its own zone fill; a club absent from a season reads "—".
- xG: each team's expected goals for and against, from the match reports the save kept, beside its goals in the same matches. Over- and under-performance are green or red only where they average more than 0.25 goals a match. Missing values are left blank, never shown as 0.00.
🏟️ Cup bracket
Cup bracket. Analysis → Bracket draws a knockout cup as a tree of its last rounds (the final and up to three rounds before it): each tie shows both sides and their goals in each match, the winner in bold, and a line to the tie it fed; the earlier rounds are listed below. Two legs are decided on aggregate and a replay belongs to its tie. The save does not store extra time or penalties, so the winner of a drawn match is the side that plays in the next round, marked with a star. A competition that does not end in a single final says so and lists its rounds, and a group or league phase is counted, not drawn. The panel is for cups; a league says so.
🤝 Ties
Ties. In a competition with two-legged ties (the same two sides meeting twice in a round, home and away), Analysis → Ties lists each tie with both legs, the aggregate and where it stands, for example "Wrexham go through" or "Second leg to play". The save stores no away goals, extra time or penalties, so a level aggregate says it is not decided there. Elsewhere the panel says the competition has no two-legged ties. Rounds the save names (third round to final) keep their names; others read "Round 1", "Round 2".
🔢 Counts on the view switch
Counts on the view switch. In a window wide enough for them (about 1540 pixels), the switch shows how many matches are still to play in the competition and season (Results (254)), how many competitions the save holds (Competitions (500)), and the followed team's current run once it is three or longer (Table (N11)): W won in a row, U unbeaten, N without a win, L lost in a row, with a + when a match with no recoverable score could make the run longer. In a narrower window the switch shows plain names, so the counts never squeeze the controls beside it. The window itself cannot be made narrower than its controls need (about 1,410 pixels, or your screen's width if that is less).
⌨️ Command palette
Command palette. Ctrl+K or Ctrl+P opens a search box over the window; type a few letters, press Enter, and you are there. It finds competitions, clubs, the five views, the Table's splits, Results' groupings, the Analysis panels, and actions (exports, themes, Open save…, About and the like). Up and Down move, Esc closes. Clubs are those of the open competition plus every senior league and cup in the save, never youth, reserve or friendly competitions; a club opens in its main league and is followed. Matching ignores case and accents, and utd finds United.
🖱️ Right-click menu
Right-click menu. Right-click a row in Results, Grid, Table or Analysis to follow either club on it, to Show only the meetings of the two clubs in a match (a note and Clear button show while the filter is on), to open Head-to-head on the two clubs (from a Table, Analysis or Grid row that names only one club, the item reads Head-to-head with {followed} and uses the club you follow as the other side; it is greyed when no club is followed), to export, or to copy.
🔍 Inspector
Inspector. The Inspector button beside Export, or Ctrl+I, opens a drawer over the right edge of the sheet; the same button, Ctrl+I, Esc or its ✕ close it. It stays shut until you ask, follows whatever you select, and never takes the keyboard from the sheet. When its content is longer than the window, it scrolls with the mouse wheel. Select a match (a Results row or a Grid cell) to see its date, kick-off, round and status, the score, the statistics the save's match report holds (xG, shots, shots on target, possession, passes, corners, fouls and cards for each side), the followed club's last five results and run, and every meeting between the two clubs across every competition and season the save holds, grouped by competition and season. Select a club (a Table, Analysis or Grid row) to see its form, record, points per game, next match and expected goals. In the Competitions hub it describes the selected competition. A figure the save does not hold shows as —, never 0, and a match with no report says so.
📋 Copy for a post
Copy for a post. Export ▾ → Copy for a post ▸ (or the command palette) copies the Table, My club's results (with your next match) or the Recent results (the latest round) as a table ready to paste into a Reddit or SI forums career update. One copy puts two versions on the clipboard: Markdown text, which Reddit's editor takes, and an HTML table, which a rich editor takes. Each ends with the in-game date and how complete the data is, and a match with no recoverable score reads "n/a". Zone and club colours are left out, because forums strip them.
🗓️ Weekly results and coverage
Weekly results. Every match in chronological order, grouped by calendar week (Monday start), matchday or date. Pick a club to view their campaign with W/D/L indicators and running points. Matches with a match report in the save show their expected goals (xG); click one for its xG scoreline, for example Harbour Town [1.82] 2-1 [0.45] Mill Lane.
Coverage. Transparent counts of played matches, matches still to play, and played matches with unrecovered scorelines ("n/a").
🏷️ Competition names
Competition names. Saves do not store competition names, so a competition first appears by its id and best-known clubs, for example [8] West Ham, Wolves, Burnley. Use Name this competition… to name it. Names go in competition_names.csv (database_id,name), keyed on the game's database id, so they apply to every save and can be edited in Excel. fmsave reads the same format.
Theme ▾, at the top right, changes the window's colours at once, and you stay where you are: the competition, season, team, view and scroll position do not move. Four themes come with Box2Box:
- Midnight Emerald, the original look and the default.
- Cyber Pitch: near-black surfaces with electric cyan.
- Deep Slate & Gold: broadcast slate with gold headings and controls.
- High-Contrast: white on black with yellow, where every coloured cell reads at 4.5:1 or better (the usual measure of readable text). It shows no club colours.
Your choice is remembered in box2box_settings.json.
The club you follow also lends its colours to the title band (with a stripe of both colours along its foot), the selected view and the followed team's highlight. They never replace a colour that carries meaning: results, zones and headings keep theirs, and a club colour is lightened or darkened until it can be read and stands apart from what surrounds it.
The colours come from a built-in list: every English league club, and the big sides of Spain, Germany, Italy, France, Portugal, the Netherlands, Scotland and Turkey. For another club, or to correct one, follow that club and choose Theme ▾ → Club colours…: pick its main and second colours with Windows' colour picker, or choose No club colours, or Use the built-in colours to undo a change. Your changes are kept in box2box_settings.json, which stays on your machine.
Export ▾ (next to Name this competition…) saves the competition and season you are looking at:
- Excel workbook (.xlsx), with these sheets:
- Table, with its zone colours.
- Grid, coloured as in the app.
- Results, grouped as on screen.
- Your followed team's results, with running points.
- About: where the data came from.
- Web page (.html): one file with the same sections and colours, plus a box to show one team's matches. It opens in any browser and needs nothing else, so it can be shared as it is.
- CSV files (.csv): Results, Table, Grid and About, in a folder of their own, for your own analysis. Scores are written with an en dash (2–1) so that Excel does not turn them into dates.
Exports are made in the colours the window has when you choose Export: its theme, and the colours of the club you follow if it has any. The workbook's sheets stay white, and CSV files are plain text.
Exports go to Documents\Box2Box (Export ▾ → Open the export folder), one per competition and season. Each is named after the competition, the season and the save's in-game date, for example Harbour League 2026-27 (2026-10-03).xlsx, so exporting the same save again replaces it while a later save gets a file of its own. Every export says which save it came from, how complete the data is, and whether the zones are the game's or estimated. If Excel has the workbook open, Box2Box leaves the old file alone and asks you to close it first.
There are two launchers, built with different tools, for different audiences.
The standalone build (dist\Box2Box\Box2Box.exe, built by build_exe.ps1) is a self-contained Windows folder. It bundles Python, CustomTkinter, tksheet, tkinterdnd2 (with its tkdnd native library), fmsave, openpyxl and the app icon — nothing else needs installing. Settings and the error log are written next to the exe, so the folder is portable. A save dragged onto Box2Box.exe opens straight away, and a save dragged onto the window works too. Build it once, from PowerShell in the Box2Box folder:
.\.venv\Scripts\python -m pip install -r requirements-build.txt # once per machine
.\build_exe.ps1 # every rebuildThe output is dist\Box2Box\ — about 64 MB with roughly 1,170 files. Zip that folder and move or share it. The exe is not code-signed; Windows SmartScreen will prompt the first time (pick More info → Run anyway).
The C# launcher (Box2Box.exe at the project root, built by build_launcher.ps1) is a small development wrapper that carries the Box2Box football icon and starts Box2Box through the project's own .venv. Build it once, from PowerShell in the Box2Box folder:
.\build_launcher.ps1This compiles launcher\Box2Box.cs with the C# compiler that comes with Windows, so nothing else needs installing. It writes Box2Box.exe next to Box2Box.bat and puts a Box2Box shortcut on the desktop; add -NoShortcut to leave the desktop alone. Keep the exe in the Box2Box folder and start it from the shortcut, because on its own it cannot find the app. It never needs rebuilding when Box2Box is updated, and Box2Box.bat still works as before.
flowchart LR
S["🖱️ Desktop shortcut"] --> X["Box2Box.exe"]
X --> Q{"Project Python<br/>.venv found?"}
B["Box2Box.bat"] --> Q
Q -- "no" --> M["💬 How to set up<br/>the environment"]
Q -- "yes" --> P["🐍 pythonw.exe<br/>fm_review.py"]
P --> W["🖥️ Box2Box window"]
DR["📂 A .fm save dropped<br/>on the launcher"] -. "opens at once" .-> P
fm_review.py is the window. Everything it shows comes from fm_data.py, a pure data layer with no user interface, so the views, the exports and the tests all work from the same figures.
flowchart TD
R["🖥️ fm_review.py<br/>the main window"]
subgraph HELP["🧩 Window parts"]
direction LR
CP["command_palette.py<br/>Ctrl+K search"]
IN["inspector.py<br/>Ctrl+I drawer"]
BR["bracket.py<br/>cup bracket"]
TT["tooltip.py<br/>form tooltips"]
CB["clipboard.py<br/>Copy for a post"]
CC["club_colours.py<br/>clubs' colours"]
end
X["📤 fm_export.py<br/>Excel, web page, CSV"]
PA["🎨 palette.py<br/>themes and zone colours"]
D["🧮 fm_data.py<br/>Dataset, tables, form,<br/>positions, xG, ties, bracket rounds"]
FS[("📖 fmsave<br/>reads the .fm save")]
OX[("openpyxl")]
CT[("CustomTkinter · tksheet<br/>tkinterdnd2")]
R --> HELP
R --> X
R --> PA
R --> D
R --> CT
HELP -- "inspector, bracket,<br/>command_palette, tooltip" --> PA
HELP -- "inspector, bracket" --> D
X --> PA
X --> D
X --> OX
PA --> D
D --> FS
| File | Purpose |
|---|---|
Box2Box.bat |
One-click launcher for the application |
build_launcher.ps1, launcher/Box2Box.cs |
Builds Box2Box.exe, the launcher with the icon, and its desktop shortcut |
icon/football-64-sky-blue.ico |
The Box2Box icon: windows, taskbar and launcher |
docs/images/ |
The README's logo (box2box-logo.svg, and PNG copies) |
docs/screenshots/ |
Pictures of the window on a made-up league |
fm_review.py |
The main Box2Box desktop application (CustomTkinter + tksheet) |
fm_data.py |
Pure data layer: parsing, grid matrices, standings, form, positions, expected goals and competition summaries |
fm_export.py |
Excel, web page and CSV exports of one competition and season |
palette.py |
The app's colour themes and how club colours are worked into them, shared by the window and the exports |
club_colours.py |
Football clubs' colours, for the followed club's tint |
command_palette.py |
The command palette: how a query finds and ranks items, and the overlay that shows them |
inspector.py |
The inspector drawer: what it can show, and the overlay that draws it |
tooltip.py |
The small tooltip shown over form badges |
bracket.py |
The cup bracket: where each tie's box goes (pure layout) and the canvas that draws it |
clipboard.py |
Puts text and an HTML table on the Windows clipboard together, for Copy for a post |
test_fm_data.py, test_fm_export.py, test_fm_review_ui.py, test_palette.py, test_club_colours.py, test_command_palette.py, test_inspector.py, test_tooltip.py, test_clipboard.py, test_bracket.py, test_probe.py |
Test suite |
requirements.txt |
Pinned Python dependencies |
LICENSE |
Proprietary All Rights Reserved licence |
CHANGELOG.md |
Release history |
competition_names.csv and box2box_settings.json are created on the machine when you first name a competition or open a save. They are local files and are not part of the public tree.
From the repository root, with the project environment:
$env:QT_QPA_PLATFORM='offscreen'
.venv\Scripts\python.exe -m unittest discover -s . -p "test_*.py" -vThe same discovery command is:
python -m unittest discover -s . -p "test_*.py" -v
The tests write only to temporary directories and do not need a real Football Manager save. They do not reflect a private save. The probe smoke test in test_probe.py is skipped when the private local tool fm27_probe.py is not present, so a fresh clone still passes.
| Release | Date | Highlights |
|---|---|---|
| 1.8 | 18 Nov 2026 | ✨ Show only and copy results from the right-click menu, a place spark and bevel on the form pills, and a quieter UV build chip |
| 1.7 | 18 Nov 2026 | 🖥️ A standalone Windows build, head-to-head from the right-click menu, and a refreshed front page on GitHub |
| 1.6 | 17 Nov 2026 | 🏟️ The cup bracket, every meeting between two clubs in the inspector, and season against season in Positions |
| 1.5 | 16 Nov 2026 | 📋 Copy for a post, the Ties panel, form tooltips and a scrolling inspector |
| 1.4 | 16 Nov 2026 | ⌨️ Drop a save on the window, the command palette, the right-click menu and the inspector drawer |
| 1.3 | 16 Nov 2026 | 🎨 Colour themes, club colours, form badges, and the icon with a launcher |
| 1.2 | 15 Nov 2026 | 📈 The Analysis view: form, streaks, positions by matchday and expected goals |
| 1.1 | 15 Nov 2026 | ©️ An About screen with the copyright and the terms of use |
| 1.0 | 15 Nov 2026 | ⚽ First release: the hub, grid, standings, weekly results and exports |
Full notes for every release are in CHANGELOG.md.
Copyright (c) 2026 onwards Mark Hawksworth (hawkers63). All rights reserved.
Box2Box is proprietary software. Copying, distribution, modification, reverse engineering, sublicencing and commercial exploitation are prohibited without prior written consent. See LICENSE for the full terms.
The app shows the same notice: About, at the top right of the window, gives the version, the copyright notice and the full licence.
Canonical repository: https://github.com/hawkers63/Box2Box
Football Manager is a trademark of Sports Interactive Limited. Box2Box is a personal tool and is not affiliated with Sports Interactive or Sega.