Skip to content

Import Data

Brings records into the saga from files. Open it from Import in the saga page's Saga Management chapter.

You choose: what to import, then the file, in the desktop's Open window.

The app works out: a preview of what the file adds, shown before anything is added.

What can be imported

  • Characters, Covenants and Laboratories: a file exported from another saga with Export. The file must hold the kind you chose. The file picker starts in the exports folder.
  • A Whole Saga: a file written by Export Saga. Every covenant, laboratory, character and familiar in it is added beside this saga's own, as importing each record would. Their books and devices come too, with the saga's own spells and house rules. So do its places, neighbours and calendar entries, and its Tribunals, joined to this saga's own of the same name.
  • A Content Pack: a file written by Export Pack (see Content packs), brought in as Import a Content Pack says.
  • A Mystery Cult: a file written by Export a Cult. The cult, with its Lore, degrees, Scripts and components, joins this saga's own cults on Saga Content. One with a name this saga already has is marked "(imported)", and its founder, a character of the other saga, isn't kept.
  • Books: a CSV file with a header row. Its columns, in any order and any case, are name, type, language, author, year_published, description, art, ability, level, quality, tractatus_type, spell, codex, encyclopedia, opus and physical_form. Name and type are needed.
  • Rows with the same codex are bound together in one new codex of that name, an encyclopedia when its rows' encyclopedia column says yes.
  • A tractatus's opus can be commentary or correspondence.
  • physical_form is one of exemplar, flap-bound, juvenilia, edition de luxe, treasure-bound, ex libris, holographic, huge codex, unbound or damaged.
  • A level or quality of "var" means the figure is to be set later. The book is imported, highlighted until you edit it to give its numbers, and can't be studied until then.
  • Books imported here go to the Armarium, unassigned.
  • Import, a button on a covenant's Library, imports books straight into that covenant's library instead.
  • An owner or cost column is ignored, since the cost is always worked out.
  • Spells: a CSV file, through the Import Spells helper.

A row that can't be read is skipped, and the preview says why. When a book or spell has the name of one already in the saga, the app asks: Skip, Skip All, Duplicate or Duplicate All. Nothing is added until every question is answered, and cancelling a question imports nothing.

Importing an exported record

What travels with the record comes too, and everything imported gets new ids. Links to records that aren't in the file, such as a character's covenant, a laboratory's owner or a book's author, are matched by name to the one record of that kind and name in this saga, or dropped. The preview lists which.

A character's or laboratory's covenant is the exception when this saga has no covenant of that name. The file carries its name, aura and realm, and the import adds a covenant with just those, so the aura comes too. The preview lists it under Adds as having only its name and aura. Fill in the rest on its sheet.

A record with the same name as one already here is added beside it. Nothing already in the saga is changed, except that a laboratory with no owner, or a magus with no laboratory, can be linked to the imported partner the file names.

Exporting

Export, in a covenant's, laboratory's or character's Manage chapter, writes that record to a file another saga can import. Manage is the last chapter on its page, with Update from a File and Delete.

You type: the File to write, and for a covenant whether to include its laboratories and characters. The file starts in the exports folder, and .amm.json is added if you give no .json ending. The line above Export warns when the file exists and will be replaced.

What goes with it:

  • a character: their familiar, the enchanted devices they hold, their books and their Diary
  • a laboratory: its books and the devices kept in it
  • a covenant: its books and devices, and optionally its laboratories and characters with their own things
  • the saga's own spells and house rules that these use.

Season plans, season records and lab projects under way stay behind.

Pictures go too. An export whose records have pictures on this computer is written as a zip, .amm.zip, holding the same file and its pictures, so they reach the other computer. That's a character's portrait, and with Export Saga or a pack, a Tribunal's maps.

Import reads a .amm.zip as it reads a .amm.json. It copies the maps into the maps folder, keeping one already there, since a map is named by its picture's bytes. Each portrait goes under its character's new name. Only pictures are copied (PNG, JPEG, WebP, BMP or GIF), under plain file names. A picture whose name has a folder or drive in it, or a file that isn't a picture, is left behind, and its record comes in without it. A file sent to a browser is the JSON alone, without its pictures.

Export Saga, a button in the saga page's Saga Management, beside Import, writes the whole saga to one file in the same shape: every record and what it holds. Import it into another saga with Import, A Whole Saga. Export a Cult there writes one of the saga's own Mystery Cults to a file, for Import's A Mystery Cult.

Content packs

A content pack is part of a saga's world written to one file, to fill another saga with it or start a new saga from it. It holds Tribunals, covenants, characters, places, neighbours and calendar entries, with their links to one another.

Export Pack, a button in the saga page's Saga Management, writes one.

You choose:

  • the pack's name and file
  • an optional Introduction: a few paragraphs on what the pack sets up, a blank line between paragraphs, shown under the pack in Start from a pack
  • a tick for each Tribunal, covenant, place and neighbour it holds.

A Tribunal takes everything in it: its covenants, the places they sit in and the places round and inside those, whoever is in those places, and the neighbours that hold an attitude toward or a link to its covenants. A covenant of a ticked Tribunal isn't asked about. With their characters adds the covenants' characters and laboratories and each Tribunal's Praeco and Presiding Quaesitor. With the calendar adds the covenants' calendar entries and the saga's own. The line above Export says what the pack holds.

In Start from a pack a pack is listed by its Tribunal ("Rhine Tribunal: 10 covenants, …").

When its name doesn't name the Tribunal, its name comes first, as in "Dammërstein (Rhine Tribunal): 1 covenant, …". So give a pack a name of its own.

The book packs come first, then the saga starters: ready-made covenants and sagas shipped with the app, such as Dammërstein. A starter is a pack exported like any other and put in the app's data/saga_starters folder. Every pack there is listed. A starter may name the shipped book pack it's built on (its base, such as rhine). Start from a pack brings that in first, and a starter whose book pack the app doesn't have isn't offered. A pack's maps go in a zip, as Exporting says.

A Tribunal's meeting under way stays behind, and its Diary comes without what its entries changed.

Importing a pack (Import, A Content Pack) is Import a Content Pack. A pack carries its Tribunals' maps and the pins of the records it holds. Importing it adds them as the pack's. A pin goes in only where the saga has none of that record on that map, so a pin you moved stays where you put it, and one you took off stays off. A map of a Tribunal the saga already has joins it, or is matched to its map of the same name.

Starting a saga from a pack: the Create a New Saga form offers Start from a pack. It lists the packs shipped with the app, one per Tribunal sourcebook (see How to start a saga from a sourcebook), then any pack in the exports folder. The new saga begins with everything in it. A pack built from a sourcebook puts that book in play when it's imported.

On the desktop, a covenant's, laboratory's, character's or familiar's Manage chapter has Print to PDF. It asks a few options first, then where to save the file. It starts in the exports folder, named after the record. The options you choose are kept for next time, all but the copy.

  • Copy (asked only of someone who reads the whole saga, the host or a storyguide): Player copy, what the players may read, or Storyguide copy, everything, Secrets too. It starts at the Player copy every time, so nothing secret goes out by accident. Anyone else, a player signed in included, always gets the Player copy and isn't asked. A Player copy leaves off each Secret not yet revealed (a Storyguide Notes secret too) and anything the players don't know of. A player printing their own character still gets their own notes and goals.
  • Sheet (characters only): Play sheet, a page or two to play from, or Full record, everything.
  • Paper size: US Letter, or A4 outside North America.
  • Theme: Each in its House's colours (a magus, their laboratory and familiar in their House's theme; covenants, companions and grogs in Scriptorum), or any theme by name, for everything you print. The page takes the theme's colours, its paper and its House's mark beside the title and in the running head, with the mark large and faint behind the first page's title (the Order's sigil in Scriptorum).
  • Background: The theme's paper, or Plain white to save ink. A dark theme's paper takes a lot of ink. On plain white a dark theme prints in its light colours (Scriptorum Dark as Scriptorum; a dark House theme in Scriptorum's colours with its own mark, until it has a light version), so there is never pale ink on white. The faint mark is left off plain white.

A character prints as a sheet laid out for paper, not a picture of the screen. Their name is set in the title lettering, with a bound edge down the left of each page. Whatever the theme, nothing on the page carries meaning by colour alone.

The play sheet is about a page for a companion or grog and two for a magus. The first page has the Characteristics, the Virtues and Flaws by name, Personality Traits and Reputations, the Abilities and Combat & Condition. A magus's second has the Arts, Casting Scores, Raw Vis and the spells, a line each with their Arts and level, Range, Duration and Target, and Casting Total. It leaves off the description, biography, books and diary.

The full record has everything, in this order:

  1. The Characteristics, Personality Traits and Reputations, the Abilities and Combat & Condition.
  2. Whatever of Combat & Condition didn't fit, then the Virtues and Flaws, each with what it does, in two columns that end level.
  3. For a magus, the Hermetic Background and Wizard's Sigil, then the Arts, Casting Scores, Raw Vis and research goals. This follows on from the Virtues and Flaws, and starts a page of its own when little of the page is left.
  4. From a new page, the description and biography, the familiar in short (its own sheet prints from its own page), books, diary, the player's notes and goals, and the Secrets the copy may hold, each marked revealed or not.
  5. Last, from a new page, the Grimoire: the spells by Form, each with its full description. A spell is never split between pages: one that won't fit starts the next page, and only a spell longer than a whole page runs on, its name marked continued.

Nothing else is cut by the page edge:

  • A section runs on to the next page where the page ends: a table between its rows, with its header again.
  • A heading always stays with what it heads, and the Combat box with Weapons and Equipment.
  • Companions and grogs have no magic pages.
  • The Abilities are set in two columns by category, and the Arts in three, the Techniques beside the Forms. Each Art and Ability has its symbol beside it.
  • Anything taken more than once (a Virtue, Flaw, Boon or Hook) is printed once with its count, as Great Intelligence × 2. The screens still show each one.
  • Combat & Condition follows the published character sheet. It has a box for each Fatigue level and five for each Light, Medium and Heavy Wound, with the current ones ticked. It also has blank lines to pencil in weapons, armor and equipment, with the character's own already filled in.
  • Empty sections are left off, except Raw Vis, which keeps lines to pencil in what is gathered in play.

Covenants, laboratories and familiars print the same way, as a full record laid out for paper, real text you can search and copy:

  • A covenant: its aura and Charter figures, then the Overview (its description, Reputations, and the Boons beside the Hooks), the Charter and its clauses (a broken one marked Broken), People and Covenfolk, the Laboratories a line each, the Library shelf by shelf, the Treasury, the Inventory (vis sources, stores, every other possession and the enchanted devices), the Diary and the History, every entry of each. A Line or Sketch covenant prints what it is to the saga, its magi, What Matters, its Charter and Diary.
  • A laboratory: its Characteristics, its owner's Lab Totals, its Virtues and Flaws, Specializations, Features, magic items and rooms, its stores (raw vis with lines to pencil in, equipment, Arcane Connections, Lab Texts and books) and its Diary.
  • A familiar: its master, species, Characteristics and Might, the Cords and the binding, Bond Powers, Combat & Condition, natural weapons, Abilities, Virtues and Flaws and Personality Traits.

Seasons, Planning, Build and Manage are left off, since they're for the screen, and so are empty sections. A record's Secrets go at the end, as the copy may hold them. Nothing on paper carries meaning by colour alone: the Lab Totals are plain numbers with the five best in bold, a Specialization's bar is its points (struck through when it is turned off), a contested source keeps its ! mark and its standing in words, and income it doesn't give this year is struck through beside what it does.

Print the Troupe, on the saga page's The Troupe chapter, prints every player character into one PDF, in the order The Troupe lists them. Each starts on a fresh page, and the PDF has a bookmark for each, so a reader's side panel lists them by name. It asks the same options, with Sheet choosing play sheets or full records for all of them, and Theme each magus in their House's colours (companions and grogs in Scriptorum) or everyone in one theme: Scriptorum, Scriptorum Dark, or a House's, for a saga of one House. A player printing the troupe always gets Player copies.

The PDF can be printed or sent like any other.

Exporting a sheet as Markdown

Export as Markdown writes a character's, covenant's, laboratory's or familiar's sheet as a Markdown file (.md), plain text that any editor, wiki or notes app shows with its headings and tables: for your own notes, an Obsidian vault, or a message to the troupe. It is in the record's Manage chapter, beside Print to PDF.

It asks the same Copy as printing (only the host or a storyguide is asked; anyone else gets the Player copy) and, for a character, Sheet: a play sheet or the full record. Then the file, in the exports folder, named after the record.

The file holds what the printed sheet does, laid out for text: the Characteristics and facts as short tables, each list as a table, Fatigue and Wounds as a small table each with the current Fatigue level marked ◀ now, and the Grimoire's spells under their Form. What only paper needs is left off: the Art and Ability symbols, and the blank lines and boxes left to pencil in. See How to export a sheet as Markdown.

How to export a sheet as Markdown

  1. Open the record: a character, covenant, laboratory or familiar.
  2. Open its Manage chapter and click Export as Markdown.
  3. Choose the Copy (if you are asked): Player copy to share it, Storyguide copy for your own notes. For a character choose the Sheet: a play sheet, or the full record.
  4. Check the File: it starts in the exports folder, named after the record. Click Export.
  5. Open the .md file in any text editor, or drop it into a wiki or a notes app such as Obsidian, which shows its tables.

Giving to another record

Give hands what one record holds to another record of the saga. It acts on the chosen row of:

  • a Raw Vis list
  • a books list, a laboratory's Lab Texts too
  • Enchanted Devices
  • a character's Personal Gear
  • a covenant's Weapons, Armor or Items.

It's a Give button beside the list's Add, Edit and Delete, acting on the row last clicked.

It asks who gets it and, for vis and gear, how many. A book changes owner, and a device changes holder, its epitome going with it. Gear given in part is split, so both keep some. Vis goes to a covenant, a laboratory or a magus. A laboratory takes no gear or silver. A book bound in a codex takes its whole codex, and the form says so.

In the Armarium and the Custodia Mirabilium, Give hands any book or device on. That's one already held, as above, or one nobody holds (Unassigned) to its first holder, with only the receiver's Diary recording it.

Give Silver gives pounds of silver from a character's purse, on Personal Gear, or a covenant's Wealth to another character or covenant. So someone leaving a covenant can take silver with them. Both sides' Diaries record every gift. A covenant files it under Library for a book, else Purchases & Sales, with the pounds for silver. Only the storyguide can give.

Updating a record from a file

Update from a File, in a covenant's, laboratory's or character's Manage chapter, reads an export of that same record over it, for example after working on a character on another computer. Only the storyguide can use it.

You choose: the exported file. It must hold the same kind of record.

The app works out: what would change, field by field, such as "Abilities: 1 added, 2 changed" or "Name: Old → New". It also lists the links in the file it can't match here. Nothing changes until you choose Update, and a file that changes nothing says so.

It replaces the record's own contents and what travels with it in an export. For a character that's their familiar, devices and books, and for a laboratory or covenant its books and devices.

It keeps the record itself, so everything that points at it still does. It also keeps where the record sits in this saga, such as a character's covenant and laboratory, or a laboratory's covenant and owner. A covenant's file made with its laboratories and characters updates the covenant only. Update each of them from its own export.

See also: Import Spells, The Armarium, The saga, How to import and export