Skip to content

The window

The desktop shows one page at a time, the way a book is read: the Sagas, a saga, one of its covenants, characters, laboratories or familiars, Saga Content, the Seasons, a Creation Worksheet or Help. The bar across the top of the window says where you are and holds what works on every page.

You type: nothing here. You choose where to go.

The app works out: what each page shows, and which actions it offers.

The trail and the pages

The trail at the top left names the pages above the one on show, such as "Sagas › Matrix › Keep › Leandro". Click one to go back to it.

  • A jump. My sheet (your name on the Playing button, or c, while you are Playing) opens your character's sheet below the page on show, wherever that is, and the trail marks the jump with ↪ in place of ›: "… › Rhine Tribunal ↪ Aurelia of Bonisagus". The crumb before it, Esc or c again takes you back to that page, at the chapter you left it on. If the trail already passes through your sheet (from your familiar or your laboratory), My sheet steps back up to it instead. See Jump to your sheet and back.
  • The switcher. When the page on show is a character, a laboratory or a covenant, a ▾ follows its crumb. Click it for the others at the same level: a character's covenant's people by Magi, Companions and Grogs (those of no covenant, for one who belongs to none), the covenant's laboratories, or the saga's covenants, the troupe's first. The one on show is marked "on show". Click another, or choose it with Up and Down and press Enter, to open it in place of the last crumb; the crumbs above it stay. A person opens at the chapter on show if they have it, else where you last left them. A long list has a box at its top: type to narrow it. Esc, or a click outside, closes it. It lists only what you may read (in Player view, or a player's seat, what the players know).

  • Sagas shows every saga as a card. Click one to open it.

  • A saga's page opens on The Troupe, with the player characters, the troupe's covenants and the pages you've bookmarked. Its other chapters are listed under The saga.
  • A covenant's page lists its people, laboratories and possessions. Click a person or a laboratory to open their page. A magus's familiar opens from the magus's page.

A covenant, laboratory or character still being made is In Creation. Its page is drawn on drafting vellum, and its header has the In Creation / In Play switch and the Creation Worksheet.

Moving around

  • A record's page is a book of chapters. The rail on the left lists them, and a click shows one. A chapter longer than the window scrolls. Come back to a page and it opens on the chapter you left it at, until the app is closed.
  • Click a card or row to choose it. A card for a covenant, person, laboratory or familiar opens its page.
  • The trail goes back up. Leaving a page cancels a form left open on it.
  • Drag the app's name in the middle of the top bar to move the window, and double-click it to maximise. Resize it from its edges and corners. A form opens inside the screen, shrunk to fit if it must. See How to fit the window to your screen.

What the buttons act on

  • A section's Add, Edit and Delete buttons act on that section. Edit and Delete act on the row or card last clicked in it, or the only one there is, and stay greyed out until there is one. Delete asks first.
  • A form, a list to choose from and a question such as Delete's open in a window of their own over the page. When a button asks several things they come one after another, and the page waits until the window is closed.
  • Each window has the app's title bar. Drag it to move the window, and use its close button. A form or list also has a maximise button, or double-click the bar, and a form's edges resize it.
  • Choosing a file or folder uses the system's own window.
  • A window is sized to what it holds, and grows when a choice shows more fields, as Lab Work's does. Past the height of the screen its fields scroll inside it, above its buttons, so a long form such as Export Pack's list of ticks can be read to its end.
  • Save keeps what you typed, and Cancel leaves things as they were. If you've changed anything, Cancel, the close button and Esc ask first, so a slip doesn't lose your work. A form that only works something out has Close in place of Cancel, and doesn't ask.
  • Every change is saved to the saga file at once.
  • One form is open at a time, and while it's open the page's other buttons wait. Clicking a New card, such as New Magus while a New Character form is open, takes you back to the form already open instead of opening another.
  • Buttons in a page's header or chapter heading, such as Edit Covenant, act on the record itself.
  • What the terminal keeps in its New and More menus is on the page itself. A New card ends the cards it adds to (New Covenant, New Character, New Laboratory). Other actions are buttons in the chapter or section they act on, such as Give beside a list's Add, Edit and Delete, Set Up Research Library on a covenant's Library or Set Date in the saga's Seasons chapter.
  • A record's Manage chapter holds what acts on the record as a whole: Export, Update from a File, Print to PDF, Show on Map and Delete. Show on Map is there for a covenant, laboratory, neighbour or creature on one of the saga's maps (see The Atlas).
  • Advance Season, the card at the foot of the chapters on the left, shows the present season's medallion and date. Click anywhere on it to advance the saga by one season, after it asks first. It's on every page of a saga with chapters, but not on a Creation Worksheet, a Fight or a Siege. See Advance Season.
  • The gear at the right of the top bar, past a thin rule after Help, opens the Settings window, with the theme, the sounds and Reduce motion.
  • The bookmark, a ribbon at the right of the header of a character, covenant, laboratory, familiar, Tribunal, neighbour or creature, keeps that page on The Troupe.
  • Find, just left of Help, or Ctrl+F, opens Find, to open any record by its name.
  • Help, ? or F1 opens Help on the page and chapter on show. Esc goes back a page, or cancels a form that's open, and q quits. See Keys.

The Inspector and the theme

The Inspector, on the right of a record's page, shows in full whatever you last clicked on the page, such as a row, a card, a book or a spell.

The theme is the look the whole app is drawn in: Scriptorum (aged parchment and iron gall ink), Scriptorum Dark (vellum by candlelight), or a House's own. Choose it in the Settings window, from the gear at the right of the top bar. The desktop remembers your choice on this computer and opens in it next time.

While a saga is open, the headpiece band under the top bar carries the present season's medallion at its centre. It's drawn in the set the saga chooses, its Medallion style setting. The same medallions mark the seasons elsewhere:

  • the Seasons page's title and each past season's heading
  • each season's column in Ahead, on the Seasons page and a covenant's Seasons chapter
  • a covenant's header, with no words, for its own Covenant Season beside its Magic Aura and Loyalty
  • the title of a covenant's Seasons chapter
  • a character's This Season
  • the column heads of a character's and a laboratory's calendar
  • a siege's track

The present season's medallion glows. A figure drawn as a medallion, such as an aura or a Loyalty, takes the same set in its own colour. They change with the season when it's advanced, and with the set when the saga's settings change it.

Sounds, in the Settings window, turns the sounds on or off, and the app remembers which. Sounds are kept for moments that mean something:

  • a page turning when you open a chapter, and a longer one for a record or page
  • a quill when a form is saved
  • coins in a Treasury, and a chest for the Inventory
  • a wax seal when the new season comes to the top of its dial
  • a dull knock when an entry is refused

Plain button presses stay silent. While the sounds are on and Armarius is the active window, it keeps the audio device awake with silence, so Bluetooth speakers and headphones don't lose the start of each sound. The sounds play on Windows only.

The pages move a little, never in your way:

  • The Inspector's new item inks in on its gilt leaf as a sheen of light crosses it.
  • A chosen row's gold wash spreads from the left, with its leaf after it.
  • A chapter fades in with a small slide.
  • An experience line that has moved since you last saw it, after Advance Season or an edit, grows to its new length.
  • When the season advances, the dial of the four seasons turns (see Advance Season).
  • When a record is moved to In Play, a wax seal with its initial is pressed on the page for a moment.

Reduce motion, in the Settings window, stills them. The pages change at once, with no dial and no seal. It shows ticked while it's on, and the app remembers your choice. Until you choose, it follows Windows' own Animation effects setting.

See also: The saga, Saga Content, Seasons, Getting started, The Settings window

The Settings window

The gear at the right of the top bar opens the Settings window. It stays open beside the page while you go on working. Close it with Close or its title bar's close button, and the gear brings it back. While a newer version of Armarius is out, the gear wears a small "!" seal.

  • Update, at the top, says whether a newer version is out: "! Armarius X.Y.Z is available", with its date and the first lines of its notes (in the warning colour, "with security fixes", when its notes mark a security fix, a line starting Security:; faint once you've skipped it). What's new shows all its notes in Help, Download page opens its Release in your browser (a copy run from the source says to pull main instead), and Skip this version hides the notice until a newer one (not for security fixes). In a joined saga whose host runs another minor version, it says so instead, with Update when yours is the older. Check for updates when Armarius starts asks GitHub at most once a day, sending only the app's version; untick it to stop, and to hide the notice. Check now asks at once and says what it found, or "Couldn't reach GitHub" and why. See How to check for an App update.
  • Theme is a drop-down showing the look the app is drawn in, as a small sample of its page with the House's mark, its name and a few words on it.
  • Open it for every look. Scriptorum and Scriptorum Dark come first, then the House themes under their House family (True Lineages, Mystery Cults, Societates). House Diedne comes last, on its own under Renounced.
  • Choose one and the whole app, the window included, is drawn in it at once. There's nothing to confirm.
  • With the drop-down chosen but closed, the up and down arrow keys step from theme to theme, past the family headings. Each is drawn as you reach it, to compare them quickly.
  • A record In Creation is drawn on the theme's own drafting page, cooler and ruled. Printed pages stay in Scriptorum.
  • Sounds turns the app's sounds on or off.
  • Reduce motion stills the pages' movements, the season dial and the seal.

A House theme draws the window, its pages and its windows in its House family's form, with the House's own colours, paper and mark:

  • True Lineages (Bonisagus, Guernicus, Mercere, Tremere): square-cut and Roman. A double rule runs round the page with square blocks at its corners, a key pattern runs through the band over the page, and headings are in inscriptional capitals.
  • Mystery Cults (Bjornaer, Criamon, Merinita, Verditius): round and closed. A frame has rounded corners and a ring at each, with chains of rings, and headings are in uncials.
  • Societates (Ex Miscellanea, Flambeau, Jerbiton, Tytalus): angular, with a frame whose corners are cut off, and chevrons. A row of swallow-tailed pennants in the House's colours hangs from a cord across the band over the page. Big titles, such as a sheet's name or a window's title, are in blackletter, and section headings are in small capitals in the House's heading colour.

The House's sign closes every chapter of a page, in the headings' ink between the family's rules, where Scriptorum has its three leaves. It also shows faintly at the foot of the Inspector, as a watermark shows in a sheet held to the light. Scriptorum and Scriptorum Dark belong to no House, so they show the Order of Hermes's sigil there instead. An illuminated initial takes the House's pigments. Text stays as easy to read as in Scriptorum, since a texture is drawn fainter behind text and whole in the margins. The colours that mean something keep their colours in every theme, such as a realm, a season's kind, Loyalty, an error or a warning, and so does a coat of arms.

The House themes:

  • Bonisagus (True Lineages, light): clean vellum faintly ruled with compass-drawn circles, lapis ink and the crossed keys.
  • Guernicus (True Lineages, light): a law tablet's cool marble, crossed by soft veins and lines of incised capitals. Iron-black ink, indigo headings, and the scales of justice on a sword in bronze, the House's metal.
  • Mercere (True Lineages, light): road-dust parchment creased where letters were folded, with drops of sealing wax and a dotted road. Headings are in the Redcap's deep red, and frame and rules in the triangle's deep woad blue. The sign closing each chapter shows the mark in the book's own colours, with the red cap, the yellow coin and the blue triangle.
  • Tremere (True Lineages, dark): iron by night, laid with the flagstones of a Roman road worn so low they only just show. Pale steel headings, rust for frame and rules, and Mars incised with a square. Cold and still where its rival Tytalus storms.
  • Bjornaer (Mystery Cults, light): a pale hide, its grain pricked and softly creased, sewn along seams whose ochre thread has faded into it. Fur runs along the frame, and feathers hang from the corner rings and lie along the rules. Dark pine headings, a bear-brown ochre for frame and rules, and the cone closing each chapter.
  • Criamon (Mystery Cults, dark): the violet dark of the Cave of Twisting Shadows. Its rock is marked with loops of the infinite, rings within rings and small spirals, worn half away into the dark. Bone-pale ink, lamp-amber headings and the Loop of the Infinite in the Eye of Time.
  • Merinita (Mystery Cults, dark): a faerie wood at twilight, the faint shadows of oak leaves and acorns on a moss-dark page. Oak leaves lie along the frame from the corner rings and along the rules, and a vine of oak leaves runs through the band over the page. Moonlit green-silver headings and leaves, heather violet for frame and rules, and the oak in its circle closing each chapter.
  • Verditius (Mystery Cults, dark): a forge by night, its soot-dark metal hammered with faint dents and catching the forge's light in a few soft glints. A cut stone is set in each corner's ring, and hammer and tongs cross in the band over the page. Headings in the gold of the House's rings, hot copper for frame and rules, and the hand with its five rings closing each chapter.
  • Ex Miscellanea (Societates, light): many parts made one whole. A warm linen page carries a patchwork of pages from the traditions the House gathers, each ruled its own way and sewn to the next along stitched seams, with the mist of Cad Gadu's lake drifting over it. Lake-slate headings, a lichen ochre for frame and rules, the crooked staff closing each chapter, and pennants dyed one muted colour for each tradition.
  • Flambeau (Societates, dark): a page that has been through the fire. It's ember-black, scorched in soft dark blots with the heat still glowing under them and a few live embers caught in the scorch, with a small flame at each corner and over the band. Flame headings, crimson for frame and rules, pennants in flame and crimson, and the hourglass closing each chapter. A name or a passage opens on an initial quartered crimson and flame, as a knight's shield is.
  • Jerbiton (Societates, light): a Byzantine city's fine arts. Cream vellum has the faintest weave of a tapestry through it, purple threads and now and then a teal one, with a tessera at each corner. Imperial purple headings, a mosaic teal for frame and rules, and pennants in both. Over the band, the House's own pennant flies from its staff with mercury's sign, and the pennant on its tower closes each chapter.
  • Tytalus (Societates, dark): Fudarus's storm-slate sky, with banks of sea mist rolling over it and rain driven slantwise through them. Headings and the spira closing each chapter are in Buliste's violet, a bright amethyst. Frame, rules and scroll bars are in Harpax's green, a deep, dark verdigris. The two claimants' colours are set against each other in lightness as well as hue, so they part even for red-green colourblind eyes. A name or a passage opens on a small illuminated initial, a burnished-gold letter on a ground quartered violet and green.
  • Diedne (Renounced, dark): the pagan House the Order destroyed, drawn as a forbidden book read by a covered lamp.
  • Its page is a palimpsest. The ghost of older writing in an invented hand shows through where it was scraped off the vellum, faded where the knife went over it and almost gone behind the text. The skin is fine-scratched by the knife.
  • It belongs to no family, so it keeps Scriptorum's frame and ornaments, worn. Its frames, the Inspector's too, its rules and the band over the page are broken off in places, and two corner flourishes are gone.
  • Uncial headings in a pale ash-grey like faded chalk, oak-gall brown for frame and rules, and plain initials with no gilt.
  • Closing each chapter, in the dark of the Inspector's watermark, are the last traces of a sign gouged out of the page: a few ends of a triskelion's spirals. The books give Diedne no symbol, since its own was struck from the records, so this one is invented.

The app remembers each choice on this computer.

See also: How to choose a theme, The Inspector and the theme