Repository navigation
Releases
xkoranate-CE 0.4.2
OOC
This release brings with it a litany of bug fixes, and three new features. The first is native inter-conference play. The second is auto-formatting of qualified/eliminated entrants (You no longer have to do the permutation maths yourself!), and the third is a new handy-dandy help menu and better documentation on how to use the app. You'll find that in the help section on the ribbon. -Mertagne
To download the program, scroll down to the Assets section at the bottom of this page and download the correct file for your operating system.
Downloads
These builds are unsigned/unnotarised, so your OS may warn on first launch (macOS Gatekeeper, Windows SmartScreen) - you'll need to explicitly allow the app to run.
- macOS (Apple Silicon):
xkoranate-0.4.2-macos-arm64.zip→ unzip, then runxkoranate.app. - macOS (Intel):
xkoranate-0.4.2-macos-x86_64.zip→ unzip, then runxkoranate.app. - Windows:
xkoranate-0.4.2-windows.zip→ unzip, then runxkoranate\xkoranate.exe. - Linux:
xkoranate-0.4.2-linux.tar.gz→ extract, then runxkoranate/xkoranate.
xkoranate-CE 0.4.2
A feature and fix release on top of 0.4.1. Events, tables, signup lists and settings carry over untouched. Events saved before this release also work with the new qualification markers.
Inter-conference round robin
A new competition type for a league split into conferences. Each group is one conference. (#66, closes #24)
- Two kinds of fixtures. Teams play a round robin inside their own conference (Legs in conference, default 2) and also meet every team in the other conferences (Legs v others, default 1). Set it to 0 to keep the conferences apart.
- A fair, repeatable schedule. Cross-conference matchdays are spread evenly through the season, and the same teams always give the same schedule. Conferences can be different sizes; teams just sit out the odd matchday.
- Tables per conference, plus an optional Overall table. Each conference's table counts all of its teams' games, including games against other conferences.
- Separate points for cross-conference games through Win v others. Until you change it, it uses the same points as games inside a conference.
- Headings use your group names, e.g.
Pacific v Atlantic, and the setup step says "Conferences".
The schedule is ported from @blackmage37's prototype on #24, with three of its problems fixed: repeated fixtures with five or more conferences, a team playing twice on one matchday when conferences differ in size, and a shuffled order that changed every run. Partial cross play, rotating division matchups and division-record tiebreakers, as used by the NFL, are not in this release.
Qualification markers
A new Format qualifications box on the Scorinate step marks entrants who have mathematically qualified (Q) or been eliminated (E). (#68)
- Three rules: Top X, Top X in each group, and Top X in each group + best N of the teams one place below the cut, compared across groups.
- Works in round robin, inter-conference and mass-start heats. In league tables the marker gets its own column right after the points. In heats it's added to the end of each line.
- A marker is never wrong. A tie on the table's first sort rule always counts against the team being judged, so a Q or E can show up a matchday later than you'd expect, but never too early.
- Changing the rule updates every matchday straight away, with no re-roll. Markers are added when results are shown or exported, like the BBCode option, so your saved results stay plain.
- Older events work too. League tables saved before this release get markers. Old heats events have no saved heat ranks, so in best-N mode their teams one place below the cut stay unmarked.
User manual
- A rewritten user guide for organisers rather than developers. It covers installing the app (including getting past the Windows and Mac warnings), every step of event setup, importing signups and the mistakes to avoid, knockout brackets, posting with BBCode, the table generator, troubleshooting, and a glossary. (#62)
- Two new walk-throughs: Your first event builds a football group stage, and Your first race sets up a women's 100 m final with a screenshot of each step. (#62, #67)
- Help › xkoranate manual opens it. The shortcut is F1, or ⌘? on macOS. F1 in the table generator opens the table generator page. (#62)
- The site's Light, Dark and True Dark colours match the app.
Fixes
Freezes
- Shooting events froze on a tie they couldn't shoot off. The mixed-team 10 m air pistol, 10 m air rifle and trap events have no shoot-off data, so a tie at the cutoff or on the podium was re-shot forever. The tie now stands. (#64)
- Rugby union—NSFS knockouts froze on a level shootout. The sport file had no kick probability, so no kick ever went in. It now uses 0.65, the same as the other rugby sports. Any sport whose shootout can't separate two sides now skips the shootout and settles the tie with a coin toss instead. The original C++ program froze here too. (#71)
Crashes
- Field-event finals with fewer than 8 athletes crashed, because the top eight get extra attempts. (#72)
- Decathlon, heptathlon and pentathlon points for a slow time crashed. Times past the formula's cut-off now score 0 points, as in the scoring tables. (#72)
- A DNF in an event that shows decathlon points, or in a sport where higher scores win (Summer vigil fasting), crashed. (#72)
- Sorting by "Win percentage (draws ignored)" crashed when a side's games so far were all draws. (#72)
- "View match odds" for NSFS baseball crashed on a 0-100 field. (#72)
- Boxing and taekwondo league tables crashed on a stoppage (KO, DSQ, RSC). A stoppage now counts as a 1-0 win for the winner. Before, it was credited to the loser. (#63)
Wrong results or lost data
- Unsaved work was lost when a save didn't happen. Choosing Save at the unsaved-changes prompt and then cancelling Save As threw your changes away without warning. In the table generator, Save at that prompt acted like Discard. Both now keep your work. A save that fails to write shows an error and keeps the unsaved state. (#70)
- Importing a signup file left Maximum skill at 1, so a field ranked 0-100 was scored on its raw ranks in every sport that rescales skill. An import now raises the maximum to the highest imported skill. (#72)
- Taekwondo matches with negative scores dropped out of round-robin tables from the next matchday on. (#65)
- A knockout's empty bracket leaked into the next event you opened and showed up as a stray heading in its results. (#61)
- Golf course table: editing a cell pushed every later hole down one, and green edits were saved somewhere nothing reads. (#72)
- Gaelic and Australian football extra time printed as
( (0) – (0)). (#72) - Archery and shooting showed the no-cutoff text when reopening an event that had a cutoff. (#72)
- A failed participant import (unreadable file, or not UTF-8) stopped later participant edits from reaching the event. (#72)
Several of these bugs are probably in the C++ original too, so this release moves the port further from matching it exactly but corrects some stagnant issues that are present. We have tried to preserve backwards compatibility with existing tournament XMLs where possible.
Under the hood
- About 1,900 fewer lines of code, with no change in behaviour. The ~25 sort-rule modules are now one table, and paradigms, competitions, file reading and writing, and the UI share common helpers. (#69)
- A sweep tool,
tools/sweep.py, scorinates every sport file under every competition type it offers and groups any failures. It found most of the fixes above. - 736 tests, up from 457 at 0.4.1, including a regression test for each fix above.
Full changelog: v0.4.1...v0.4.2
xkoranate-CE 0.4.1
OOC
First feature release since the port went stable, and it's a biggie that should be a big quality of life upgrade: knockout tournaments. Thanks to everyone who has been filing issues! Three of the fixes below came straight from them. -Mertagne
To download the program, scroll down to the Assets section at the bottom of this page and download the correct file for your operating system.
Downloads
These builds are unsigned/unnotarised, so your OS may warn on first launch (macOS Gatekeeper, Windows SmartScreen) - you'll need to explicitly allow the app to run.
- macOS (Apple Silicon):
xkoranate-0.4.1-macos-arm64.zip→ unzip, then runxkoranate.app. - macOS (Intel):
xkoranate-0.4.1-macos-x86_64.zip→ unzip, then runxkoranate.app. - Windows:
xkoranate-0.4.1-windows.zip→ unzip, then runxkoranate\xkoranate.exe. - Linux:
xkoranate-0.4.1-linux.tar.gz→ extract, then runxkoranate/xkoranate.
xkoranate-CE 0.4.1
A feature and fix release on top of 0.4.0. Events, tables, signup lists and settings carry over untouched, and this release also goes the other way: files hand-edited or written by older versions that 0.4.0 had started refusing now load again.
Single-elimination tournaments
A new single-elimination competition type, offered for every head-to-head paradigm - association football, the esports sports, chess, judo, tennis, fencing, wrestling and the rest. Pick it and the event setup page becomes a bracket editor; each round's fixtures are derived from the winners of the round before. (#52, closes #22)
- The first-round draw is yours to arrange. Three toolbar buttons fill the bracket, after which every pairing can still be dragged by hand:
- 🎲 Dice - random draw.
- Seed by skill - strongest against weakest, with the top two able to meet only in the final.
- Keep top seeds apart - asks how many seeds, then spreads them across the bracket so none of them meet early. Seeds are placed before byes, so a bracket with byes still honours the promise.
- Byes are real entrants - draggable rows you can drop into a particular slot, not tail padding. A bracket sized larger than the field spreads its byes rather than stacking them at the bottom, and competition types that don't understand byes strip them, so a group set up for a cup can be reused for a league without phantom participants.
- Bracket size is a dropdown, snapped to a power of two and clamped to a size the draw can actually fill.
- Round output names the next round's pairings rather than listing who advanced. View full schedule covers the whole bracket, with later rounds reading "Match 9 winner v Match 10 winner" until they are known.
- Optional third-place playoff, played as its own matchday before the final.
- Rearranging a bracket that already has results asks first, and a drag you decline is put back.
The draw maths is ported from the prototypes @blackmage37 attached to #22. Two-pot draws, same-nation avoidance, two-legged ties and Qusma seeding are not in this release. They might be in a future one, though!
Interface
- Search the sport list. A filter box above the sport tree on the first step of the event editor, so a discipline can be found by typing instead of scrolling 117 rows. Matches at any level, case-insensitive, keeps a match's ancestors and subtree visible, and clearing it puts you back where you were. (#53)
- Double click opens a dropdown, in one gesture. In every reorderable list, a double click on a row now opens its editor whether or not the row was already selected - previously an unselected row cost three clicks - and the list drops open with it. Choosing an entry closes the editor immediately, and the editor is sized to its row instead of covering the rows above and below. (#55)
- A selected row now shows a small arrow when its editor is a dropdown rather than free text, on the sort-criteria and tiebreaker lists, the event setup participants, and the WC36 RP bonus ratings. (#55)
Fixes
- Saved events loaded empty on some sports - opening an event whose paradigm doesn't use a maximum skill (FIBA-rules basketball, SQIS football) dropped every participant and result, leaving group members showing as "unknown participant". Association football was unaffected, which made it look sport-specific; the cause was 0.4.0's new "pin to max participant rank" checkbox writing an empty editor back over the signup list still being loaded. Hits every file saved by an earlier version,
0.4.0-pr3and the old C++ program alike. (#51, fixes #48) - Hand-edited files read as truncated - a signup list whose indentation had been stripped, which is what a spreadsheet paste leaves behind, lost everything after the first signup, and groups then pointed at participants that were no longer there. The reader was running one token past each signup's end. (#58, fixes #56)
- Decimal commas parse again -
1,5is one and a half. A decimal point still wins where both appear, so commas beside a point group thousands. (#58, fixes #57) math domain errorcrash mid-scorination - switching an event from a paradigm that passes skill through un-normalised (LISA) to one that rescales left a stale maximum behind, so skills entered on a 0-100 scale normalised to 27-92 instead of 0.27-0.92 and the random generator raised. Nine paradigms share that maths; the same hole in the Gaussian generator is closed too. (#52)- Competition type was overwritten on load - anything other than the first type in the list, round robin for football included, was silently replaced when a saved event was opened, and the event was rewritten on save. (#52)
- "Add all available participants" duplicated the field in a bracket, so clubs ended up playing themselves. (#52)
- Switching competition type destroyed your pools - every group was merged into one under the first group's name, with no undo. The pools are now given back. (#52)
- BBCode stopped bolding winners for best-of-1 esports - the sport file used ASCII hyphens where every other sport file uses an en dash. Corrected in the file, deliberately rather than by widening the match, so Gaelic and Australian scorelines like
Cork 2-08 (14) drew with Mayo 1-11 (14)are still left alone. (#52) - A coin-tossed tie is reproducible again where the sport has no generator of its own - the one result the paradigm can't derive was the one result that couldn't be repeated. (#52)
Under the hood
- C++ inheritance boilerplate removed from the port - abstract stubs and a vestigial
QObjectbase that the Python classes never needed. (#49, #50) - Duplicated logic shared - the odds paradigm lookup and the tiebreaker score accumulation each existed in more than one competition, and the braced-uuid conversions in seven modules. Two leftover debug prints that fired on every match of every round-robin event went with them. (#54)
- 457 tests, up from 248 at 0.4.0, including a regression test for each fix above.
- Docs cover the knockout format and the bracket editor.
Full changelog: v0.4.0...v0.4.1
xkoranate-CE 0.4.0
OOC
xkoranate-CE is finally out of pre-release. Three release candidates' worth of community testing later, this is the first stable build of the Python port, and it has already gone past where the original C++ program left off. -Mertagne
If you would like to buy me a beer as thanks, you can do so here.
To download the program, scroll down to the Assets section at the bottom of this page and download the correct file for your operating system.
Downloads
These builds are unsigned/unnotarised, so your OS may warn on first launch (macOS Gatekeeper, Windows SmartScreen) - you'll need to explicitly allow the app to run.
- macOS (Apple Silicon):
xkoranate-0.4.0-macos-arm64.zip→ unzip, then runxkoranate.app. - macOS (Intel):
xkoranate-0.4.0-macos-x86_64.zip→ unzip, then runxkoranate.app. - Windows:
xkoranate-0.4.0-windows.zip→ unzip, then runxkoranate\xkoranate.exe. - Linux:
xkoranate-0.4.0-linux.tar.gz→ extract, then runxkoranate/xkoranate.
xkoranate-CE 0.4.0
The first stable release of xkoranate-ce-python - a faithful Python/PySide6 port of xkoranate-CE, the sports "scorinator" used by NS Sports, the sports roleplay forum for NationStates. Originally written in Qt4/C++ by Commerce Heights, this port preserves the original program's behaviour - scorination maths, competition formats, file formats, and general UI - while running on current macOS, Windows, and Linux via Python and Qt 6.
This release consolidates everything from 0.4.0-pr1, -pr2 and -pr3, plus the LISA and table-generator work that landed afterwards. If you have been running a pre-release, this is a straight upgrade! Your events, tables, signup lists and settings all carry over.
Licensed under GPLv3, with full attribution to the original xkoranate-CE authors and contributors: see NOTICE.md.
The port itself
- Cross-platform builds - native builds for macOS (Apple Silicon and Intel), Windows, and Linux, produced by the same PyInstaller spec and built automatically on release. (#18, #38)
- Test suite + CI - unit and integration tests run on every push, and build jobs verify the frozen app on all target platforms, so community changes are known to work before they reach
main. Coverage now includes the paradigm classes themselves, where the scorination math actually lives. (#16, #46) - Reproducible dev environment - contributor setup is managed with pixi, which resolves PySide6 and Qt as matched, locked binaries. This removes a class of bug where a machine's Python Qt bindings and native Qt libraries drift out of sync. (#46)
- Crash/launch logging - the app writes a log file on any failure, including ones that happen before it can finish starting, and shows an error dialog for crashes once it's running. See the getting started guide for log locations. (#36)
Scorination and paradigms
- Home advantage is user-adjustable - magnitude, not just on/off, across NSFS, SQIS, Footba11er and Howzzat, with the underlying NSFS math corrected to match the original formula. This fixes the long-standing "home advantage bug". (#9, #11, #14, #15)
- LISA paradigm ported and then brought fully up to par with SQIS/NSFS (#1, #17, #42):
- Extra-time formula corrected to the reference algorithm's smooth probability floor instead of an approximated hard cutoff.
- Style-modifier curve replaced with the same 5-point distribution SQIS/NSFS use for association football.
- Per-event home advantage override, and a working schedule button.
- Three LISA home advantage modes (#45) - pick one per event:
- Fixed (default) - one flat magnitude for every match, same as every other paradigm.
- Adversarial (per-team) - each team sets its own −5 to +5 rating, and the two teams' ratings combine. Boosting your own home ground also raises the boost you hand opponents when you visit them, so it's self-limiting by design; nobody can max out the slider for free. That makes it the right fit for player-vs-player competition, and it's the behaviour the algorithm's own creator built to avoid a home-advantage arms race there.
- Individual (per-team, uncapped) - each team's own rating applies only when they are at home, with no effect on or from the away side, and no cap. Not self-limiting, so it suits domestic leagues where home advantage needn't be zero-sum and can be as wacky as an organiser likes.
- Both per-team modes add a "Home Adv" participant column, and both reproduce the flat default exactly when left untouched.
- Formula constants are now adjustable per event - LISA's power scalar, reference rank, REAR and margin divisor; SQIS's constants A/B and attack count; NSFS's full rank and attack coefficient set. Previously XML-only. Everything beyond home advantage and "Show team names" sits behind a collapsed "Advanced options" section, each field with a restore-default button. (#42)
- Skill-normalization fields now match the maths - minimum/maximum skill bounds are hidden for the paradigms whose formulas provably ignore them (SQIS/Footba11er/Howzzat win probability is a plain skill ratio; LISA needs true raw rank), so the only knobs shown are the ones that actually change results. Also adds a "Pin to max participant rank" option that follows the highest entered rank instead of acting as a ceiling that clamps entries. (#42)
- Odds calculator and automatic schedule output for head-to-head match paradigms. LISA's odds are now computed exactly from the algorithm rather than sampled, since its win/draw/loss split is fully determined. (#12, #13, #45)
Table generator
- OT/shootout tracking and NHL-style points - standings now track regulation vs. overtime/shootout results, with configurable OT/SO win and loss points on top of win/draw/loss, so leagues can score NHL-style (2-2-2-1-1-0) rather than a flat split. Matches are tagged either by a trailing
OT/SOmarker in the results box (Aquilla 3–2 OT Busby) or automatically when a round-robin's own simulation resolves a tie. (#43) - Recognises the simulator's own output format when pasted back in -
Aquilla 2–2 Busby (3–2 OT), including two-stage tiebreakers like(2–2 AET) (3–4 pen.). Only real tiebreaker keywords count, so teams named Ottawa or Southampton, and bracketed suffixes likeBusby (2–1 Reserve), are left alone. (#43) - Six new standings tiebreakers - regulation wins, overtime/shootout wins, losses, home losses, away wins, home goals conceded, plus a last-resort coin flip that is persisted per team in the table file, so reopening or regenerating the table never re-rolls it. (#43)
- "OT/SO breakdown" column toggle (OTW/SOW/OTL/SOL). (#43)
Interface
- Modernized UI - Material Design icons, a discoverable File/View menu bar, and general UX polish (dialog button colours, dropdown scaling, participant wording). (#2, #10)
- Three themes - Light, Dark, and True Dark (OLED), which forces the background to pure black. Theme selection lives in the View menu. (#34)
- BBCode output - scorinated results can be wrapped in
[pre]tags for direct posting to the forum, with match winners automatically bolded in head-to-head result lines. (#7, #19)
Fixes
- Windows file dialogs - "Open"/"Save" for events, tables, results and signup lists popped a "you can't open this location using this program" error instead of a file picker; Qt's internal search-path aliases (
events:/) were reaching the native Windows dialog as literal paths and being read as a URL scheme. Each alias is now resolved to a real directory first. (#39, fixes #37) - Intel Macs - macOS releases were arm64-only, with no Rosetta path for an arm64 binary. Separate Apple Silicon and Intel builds now ship. (#38)
- Linux launch failures - two separate bugs made every shipped Linux binary fail instantly with no visible error: CI bundled only enough shared libraries to run on the build machine itself, and the build machine's glibc was newer than several supported distros. The build now bundles the full dependency closure, targets an older Ubuntu LTS baseline, and is verified by launching in a bare container. (#33, #36)
- Single-click selection in reorderable lists (tiebreaker order, sort criteria) needed a second click, because the edit trigger made Qt wait out the double-click interval first. Single click highlights immediately; double-click still edits. The sort-criteria highlight also picks up the theme accent colour. (#41)
- Numeric athlete-list columns (rank, seed) sort numerically instead of alphabetically. (#6)
- CSV/TXT athlete import no longer drops style mods and other extra columns, so they can be imported. (#8)
- "Maximum skill" default was silently clamped to 99.99 on every event ever created, because the default value was applied before the spinbox range. (#42)
- "Goals are called" dropdown no longer clips its widest item, and no longer clips its text against the dropdown arrow. (#43)
- Long tooltips now wrap at a readable width instead of stretching to nearly the full screen. (#45)
- Fixed a zero-division risk in pinned max-rank handling and an enabled-state bug in the advanced options section. (#42)
Compatibility
- Scorination files (events/RPer lists/signups) and table generator files written by the original xkoranate-CE load unchanged, and files written by this port match the original format.
- Table generator changes are purely additive: tables that never use an OT/SO decider compute points and sort exactly as before, and older table
.xmlfiles load with the existing win/loss configuration. - LISA events default to Fixed home advantage mode, which behaves exactly as the fixed magnitude always has, so existing events are unaffected.
- Settings are stored under the same `thirdgeek...
v0.4.0-pr3
Highlights
- Fixed: the app couldn't open its own file dialogs on Windows — clicking "Open"/"Save" for events, tables, results, or signup lists popped a "you can't open this location using this program" error instead of the file picker. The dialogs were seeded with Qt's internal search-path aliases (e.g.
events:/) as literal paths; Qt's own model resolves these fine, but Windows' native dialog tried to openevents:as a URL scheme. Each alias is now resolved to a real directory before reaching the dialog. (#39, fixes #37) - Fixed: macOS releases were arm64-only, so the app couldn't run on Intel Macs at all (no Rosetta path for arm64 binaries). Builds are now produced separately for Apple Silicon and Intel — download the zip matching your Mac. (#38)
-- Download the arm64 release for Apple Silicon macs, and try the x86 release for Intel Macs. - Fixed: single-clicking an already-selected row in a reorderable list (tiebreaker order, sort criteria, etc.) required a second click to actually highlight it, because the edit trigger made Qt wait out the double-click interval first. A single click now highlights immediately; double-click still opens it for editing. The sort-criteria list's highlight also now picks up the app's theme accent colour instead of an unstyled system colour. (#41)
Full changelog: v0.4.0-pr2...v0.4.0-pr3
v0.4.0-pr2
Update (2026-07-02): the Linux fix below (#33) turned out to be incomplete — a second, unrelated bug (#36) still made the app unable to launch on several currently-supported distros (e.g. Linux Mint 21.x). This release's assets have been rebuilt in place with both fixes; if you downloaded the Linux build before this note was added, please re-download it.
Highlights
- Fixed: Linux release builds crashing silently on launch. Two separate bugs, both fixed:
- CI was only bundling enough shared libraries to run on the build machine itself, not the full set the packaged Qt plugins need — every shipped Linux binary failed instantly on end-user machines with no visible error. The build now bundles the complete dependency closure and is verified by launching in a bare container with nothing but graphics drivers installed. (#33)
- Even after that fix, the build machine's glibc was newer than several currently-supported Linux distros (e.g. Linux Mint 21.x, glibc 2.35), so the binary still failed with a
GLIBC_2.38 not founderror. The Linux build now targets an older Ubuntu LTS baseline for wider compatibility, verified against a real Linux Mint 21.3 environment. (#36)
- Added: Crash/launch logging. Both bugs above were invisible to anyone double-clicking the app — no terminal, no error, just nothing happening. The app now writes a log file on any failure (even one that happens before it can fully start), and shows an error dialog for crashes that occur once it's running, so future reports can come with an actual log file attached. See the getting started guide for log locations. (#36)
- Added: A "True Dark (OLED)" theme — dark mode with the background forced to pure black, for OLED displays. Theme selection (Light / Dark / True Dark) now lives entirely in the View menu; the old toolbar toggle switch was removed since it no longer fit a three-way choice. (#34)
Full changelog: v0.4.0-pr1...v0.4.0-pr2
xkoranate-ce-python 0.4.0-pr1
OOC
We've finally managed to leverage LLMs for good in the NS Sport community! Hopefully this is the start of some more committed development to xkoranate to bring it up to modern standards. -Mertagne
If you would like to buy me a beer as thanks, you can do so here.
xkoranate-CE 0.4.0-pr1
The first release of xkoranate-ce-python — a faithful Python/PySide6 port of xkoranate-CE, the sports "scorinator" used by NS Sports, the sports roleplay forum for NationStates. Originally written in Qt4/C++ by Commerce Heights, this port preserves the original program's behaviour — scorination math, competition formats, file formats, and general UI — while running on current macOS, Windows, and Linux via Python and Qt 6.
This is a pre-release (-pr1): the core port is functionally complete and tested, but it hasn't yet had a broad shakeout from the wider NS Sports community. Please report anything that looks or behaves differently in a bad way from the original xkoranate-CE, or any bugs. You can use the issues board in this repo to do this.
Highlights
- Cross-platform builds — native builds for macOS, Windows, and Linux, produced by the same PyInstaller spec and built automatically by this release. (#18)
-- Please test these, in particular the linux build! - Modernized UI — a light/dark theme toggle (via
qdarktheme), Material Design icons (qtawesome), a discoverable File/View menu bar, and general UX polish (dialog button colors, dropdown scaling, participant wording). (#2, #10) - LISA paradigm ported and extended with a per-event home advantage override and a working schedule button. (#1, #17)
-- Give this a test, too - much of the port was automated. - Automatic schedule output and an odds calculator for head-to-head match paradigms. (#12, #13)
- Home advantage is now user-adjustable (magnitude, not just on/off) across NSFS, SQIS, Footba11er, and Howzzat, with the underlying NSFS math corrected to match the original formula, solving the well known "home advantage bug". (#9, #11, #14, #15)
- Bug fixes: numeric athlete-list columns (rank, seed) now sort numerically instead of alphabetically; CSV/TXT athlete import no longer drops style mods and other extra columns, allowing for these to be imported. (#6, #8)
- BBCode output — scorinated results can now be wrapped in
[pre]tags for direct posting to the forum, with match winners automatically bolded ([b]...[/b]) in head-to-head result lines. (#7, #19) - Test suite + CI — unit and integration tests now run on every push, and build jobs verify the frozen app on all three target platforms. This ensures that future community changes to the repository are known to work before merging them to the main branch. (#16)
- Licensed under GPLv3, with full attribution to the original xkoranate-CE authors and contributors — see NOTICE.md.
Compatibility
- Scorination files (events/RPer lists/signups) and table generator files written by the original xkoranate-CE load unchanged, and files written by this port match the original format.
- Settings are stored under the same
thirdgeek.com/xkoranateidentifier, so directory preferences from an existing installation carry over.
Downloads
Pick the build for your platform below. These builds are unsigned/unnotarised, so your OS may warn on first launch (e.g. macOS Gatekeeper, Windows SmartScreen) — you'll need to explicitly allow the app to run.
- macOS:
xkoranate-macos.zip→ unzip, then runxkoranate.app. - Windows:
xkoranate-windows.zip→ unzip, then runxkoranate\xkoranate.exe. - Linux:
xkoranate-linux.tar.gz→ extract, then runxkoranate/xkoranate.
What's next
The issues board is a port of the issues from the existing C++ repo, and at some point I may begin tackling them. They are more complex, however!