Repository navigation
Releases
Releases · apoapsis138/armarius
Armarius 4.14.0
Printing and exports (PDF Exports and Handouts)
- Player and Storyguide copies. Printing a character asks the host or a storyguide whether it's a Player copy or a Storyguide copy, starting at the Player copy each time. A Player copy leaves off every Secret not yet revealed and anything the players don't know of; a player always gets the Player copy, with their own character's notes and goals. The full record now prints the character's Secrets, each marked revealed or not, and the player's notes and goals.
- A new order for the full record. Page 1 is the Characteristics, Personality Traits, Abilities and Combat & Condition; the Virtues and Flaws follow; then a magus's Hermetic Background and Arts, the story and diary, and last the Grimoire, each spell in full and never split between pages. The Spells in the Grimoire option is gone: the full record always gives each spell's description, and the play sheet a line each.
- A play sheet. A character can print as a play sheet, about a page for a companion or grog and two for a magus: Characteristics, Virtues and Flaws by name, traits, Abilities, Combat & Condition, then the Arts, Casting Scores, Raw Vis and the spells a line each.
- Less empty paper. Sections now run on to the next page instead of moving whole: tables between their rows, the Virtues and Flaws down their columns. The Abilities are set in two columns, the Arts in three, and the Arts start a new page only when little of the page is left. The Combat box stays with Weapons and Equipment. Raw Vis keeps lines to pencil in, and the familiar's box is short and points to its own sheet. A magus's full record takes about half the pages it did.
- Covenants, laboratories and familiars laid out for paper. They now print as a record laid out for the page, like a character, instead of a picture of the screen: real text you can search, nothing cut off at the edge or shortened with "…", and every history entry, diary entry and book. Each asks for a Player or Storyguide copy and a background like a character. Colour no longer carries meaning on paper: the Lab Totals are numbers with the best in bold, and a turned-off Specialization is struck through. A table's long words now wrap onto a second line instead of shrinking.
- Printing in a theme. Print options have a Theme: each magus (with their laboratory and familiar) in their House's colours, or any theme by name. The page takes the theme's colours and paper, with the House's mark beside the title and in the running head, and large and faint behind the first page's title. On plain white a dark theme prints in light colours, so there's never pale ink on white.
- Print the Troupe. The Troupe chapter has Print the Troupe: every player character's sheet in one PDF, each from a fresh page and in its own House's colours (or one theme for everyone), with a bookmark for each.
- Export as Markdown. A character's, covenant's, laboratory's or familiar's sheet can be written as a Markdown file, on the terminal (More) and the desktop (Manage): the same copy and sheet as printing, with tables a wiki or notes app shows. Help has a how-to.
Self-hosting (Castellum)
- A threat model of its own for hosting on a box. What can go wrong when a NAS or server hosts the saga (the container image, the tunnel, the key kept in a file, the
admincommand and the backups), what guards against each, and what is left to you, now has its own document, with a worked example for a UGREEN NAS. The Remote seats threat model, for hosting from your desktop, points to it. - Clearer advice on where to keep the host key. The guide and the example settings no longer send the key to a NAS's encrypted shared folder without a caveat: keep it in a private folder of its own, encrypted where the box can (try the NAS's encrypted folder first, since UGOS's can't be used), and know that a plain folder doesn't protect it if the drives are stolen. Back the key and the tunnel token up apart from the nightly backups.
Desktop version (Illuminatio)
- My sheet. While Playing, your name on the Playing button (or
c) opens your character's sheet from any page; the trail, Esc orcagain takes you back. - The trail's switcher. The last crumb of the trail lists the other people, laboratories or covenants at its level.
Seasons (Book of Hours)
- General spells from a Lab Text. A Lab Text for a General spell, such as Aegis of the Hearth, now teaches the level written on it instead of refusing with "has no level" (#16). The magus learns a version of their own at that level, with the text named as its source, and the Lab Text they write teaches that version; two magi learning from the same text each get their own. A General spell's text with no level asks for one, and the Lab Work window gives its reason once, not twice.
App updates (Renovatio)
- Told when a newer version is out. Once a day at most, when it starts, the app asks GitHub for the latest Release, sending only its own version, and never holding up the start. When a newer one is out, the desktop's title page says "! Armarius X.Y.Z is available" beside the version, and the settings gear wears a small "!" seal; the terminal's title page lists Update last, and the first saga you open shows the same line once. Nothing is downloaded or installed: getting the new version is done as before.
- The Update row. At the top of the desktop's Settings window, or on the terminal's new Update screen: the new version, its date and the first lines of its notes, with What's new for all of them, Download page (a copy run from the source says to pull main instead) and Skip this version. Check now asks at once and says what it found, or that GitHub couldn't be reached and why. Check for updates when Armarius starts turns the daily check off, and
ARMARIUS_UPDATES=offturns every check off. - Security fixes stand out. A new version whose notes have a bullet marked Security: is shown in the theme's warning colour, "with security fixes", and can't be skipped. A new major version says that players who join by Remote seat must move to it too.
- Never on a host. A copy a host runs for a player, the hosts themselves, the admin command and the container image never check.
- Version mismatches told plainly. Joining a host on another major version still stops, and now offers Update when yours is the older, or says "Your storyguide's Armarius is older" when theirs is. On another minor version you can play, and the gear's seal and the Settings window say the two versions haven't been tested together. The storyguide's Players list notes a player who last joined on another version.
Your data and upkeep (Fundamenta)
- Sagas saved on this computer by default. A new install keeps its sagas in your app data folder (
C:\Users\you\AppData\Local\Armariuson Windows,~/.local/share/Armariuson Linux), not in OneDrive, where a sync could catch a save half-written. If you already use Armarius, nothing moves: it goes on saving where it always has, now shown as a folder you chose. Change save folder on the saga picker moves it.
Help (Glossa)
- Host for Players help names the two ways players join as the window does (Remote seats; Browser or terminal) and links each to its guide, and the unplanned-seasons help gives the idle non-player setting's name for each version of the app.
- What's New in plain words. Each feature is headed by what it is first, then its name: Help (Glossa), Self-hosting (Castellum), Sourcebook packs (Peregrinatio). Its editions read Self-hosting I: Vigilo Confido, and the Chronicle's major versions Version 4.x: Sodalis. A Release's notes on GitHub are headed the same way.
- Every Help page rewritten. The pages for each sheet, chapter, form and season step read like the how-to guides: short sentences, lists instead of long catalogues, "they" for any character, and each version's labels apart. Headings name the place without "tab", since the desktop has chapters. A few slips are fixed on the way: the familiar's Bond Powers say the level is worked out when ticked, a deep cover's Disguise roll is the one the app rolls (Houses of Hermes: Societates p. 87), Notes & Goals are on the Description, and Lands of the Nile's tomb curses, wards and traps are working records.
- The web help's menu by topic. The how-to guides are grouped by what you're doing (Start here, Characters and magic, Seasons and the laboratory, The covenant, The saga's world, Tribunals and conflict, Playing together, Your data) instead of one long list. A screen whose name doesn't say what it holds has a few plain words after it (The Armarium: the saga's books), and each sourcebook pack is listed by its book's name.
- The web pages read like the guides. The site's front page, install guide and FAQ give one action per step and plainer sentences, and point to the new guides for updating and for hosting browsers and SSH.
Armarius 4.13.1
Glossa
- Help checked against the books. The how-to guides' rules and page references were checked against the Definitive Edition, its errata and the supplements they cite. A few page references are corrected, and where the app makes its own call on something the book leaves open or reads differently (three subjects for an Adventure, Elemental Magic's share, a Presiding Quaesitor prosecuting any charge, galdramen without Twilight), the help now says so.
- Help matches the app. The desktop's Advance Season card, the New Magus, New Companion and New Grog cards, chapters rather than tabs, the full list of optional rules, every pack's assumptions page, and moving (not renaming) a saga file once it's hosted on a server are now described as they are.
- Your save folder, wherever it is. The how-to guides now say "your save folder" and point to the Sagas page, which shows where it is, instead of assuming it's in OneDrive.
- Guides that read more easily. Every how-to guide opens on what you want to do and gives one action per step, with the book's rules kept on the reference pages they link to. Hosting is now a short page to choose a way, with a guide for browsers and SSH and one for Remote seats; "How to host on your own box" is now How to self-host a saga, and the faith guide is How to see what a character's faith allows. The sourcebook guide lists each pack in a line or two, and each pack's assumptions page now opens with what the pack brings.
- New guides. How to join a saga as a player, invite a player, change or reset a passcode, update to a new version, change the save folder, restore a saga from a backup, and keep a player character's notes and goals.
- Remote seats need the same major version as the host, not the very same version, as the guides now say.
Armarius 4.13.0
Castellum
- Host a saga on a server or NAS. Run Remote seats from an always-on box, such as a Linux computer, a UGREEN NAS or a small rented server, instead of your desktop. Each release now publishes a container image,
ghcr.io/apoapsis138/armarius(Intel/AMD and ARM), with a locked-down compose file that runs it beside a Cloudflare Tunnel. A new guide in Help walks through the whole setup, from moving the saga over to joining it from your desktop as storyguide. Hosting for browsers and SSH stays on the desktop. - Keys without a keychain. On a box with no keychain, the host key and SSH host key live in a private folder you choose. Armarius refuses a folder that's missing, readable by others, or inside the data folder, so keys never travel with the saga or its backups.
- Run it from a terminal. The new
admincommand does everything the Host for Players window does: players, roles and passcodes, invites and approvals, seats, the Log, rotating the host key, and bringing a saga in. - Nightly backups.
admin backupzips the saga and its seat files safely while players are saving, keeps the newest 30, and never includes the host key. The compose file runs it every night.
Glossa
- The help on the web. apoapsis138.github.io/armarius has the desktop's help and how-to guides, a step-by-step install guide, and answers to common setup questions. It's rebuilt with each release.
Fundamenta
- No busy cursor on GNOME. On Linux under GNOME, the app no longer shows a busy cursor for about 15 seconds at start and when switching windows. Set
QT_QPA_PLATFORM=waylandif you'd rather it used Wayland.
Scriptorum
- Smoother tab switching. Switching a sheet's tab now redraws the footer once, even on a slow computer.
Armarius 4.12.0
Fundamenta
- Download the app. Each Release now has a download for Windows and one for Linux that runs without Python: unzip it and start Armarius (the desktop) or armarius-terminal (the terminal version). Help's new guide, How to download and run the app, covers Windows' "Windows protected your PC" warning and moving to a newer version.
- Hosting from a download. A downloaded copy can host a saga for players, in a browser, over SSH or with Remote seats, just as a copy run from the source can.
- Releases. Changes now gather on a development branch and are listed here under Unreleased; a release gives them one version together, instead of a new version for every change. The repository checks every change on Windows and Linux, and each tagged release is published on GitHub with its notes from this page.
- How Armarius is made. The README now says plainly that Armarius is built with Claude Code as a coding assistant, what the maintainer designed and does, and that none of its art is generative AI.
- Steadier checks. The tests no longer touch the computer's own keychain, so they run the same on a machine without one, and three tests that sometimes failed on a busy machine wait for the screen they act on.
Scriptorum
- No crash closing a window as it opens. A window closed, or the app quit, at the very moment the season's results, a menu, a yes/no question, a books chooser or a file chooser opened could crash while choosing what to focus.
Glossa
- Where the source is. Help's About page links the source of the version you're running.
- What's New in reach. Help lists its REFERENCE pages (About this App, What's New and Keys) before the long list of how-to guides, and the filter box finds About and What's New by name.
- Unreleased work on What's New. What's New shows changes not yet in a release first, as Unreleased (in development).