Repository navigation
Releases
4.6.1
One creator for every "+"
- Every + button opens the Quick creator in the inspector (toolbar buttons, right-click New… and Add … here entries, the overview buttons and the
New <type>commands), already filled in with what the button knew: type, name, date, places, people and groups. The full New note window is still one click away (Relationships, colour, logo and more…) and is used for a pin placed on a map, another calendar, and Map notes. - Object and Creature are in the overview's New buttons and in the command list (New object, New creature). The overview's buttons use the type names (New society).
- People have a Number and Nicknames (II, 3rd; The Bold) in the Quick creator and in the inspector's edit form. They are written as
number:andnickname:, and a nickname is also an alias, so a link written with it finds the note. - The typed line knows the new types: start it with
object:,item:,artifact:,relic:,creature:,beast:,monster:oranimal:(also astype: …). With no prefix, a name with a sword, crown, ring or ship in it reads as an Object, and one with a dragon, wolf or ghost as a Creature.
Smoother timeline and buttons
- Scrolling or zooming the timeline no longer replays its entrance animations. Every pan and zoom redraws the lanes, and each redraw wrote the titles out and faded the bars in again. They now animate on the first draw only.
- Buttons no longer play two animations at once: the hand-drawn outline stops while a button is pressed, so only the fill shows.
Plugin review
- The written-in titles, tabs and button fills, and the arrow-ended Tag tabs, are drawn with masks instead of
clip-path, and underlines use thetext-decoration-linefamily, so the review no longer flags those two browser features as partly supported.
Name forms, sorted and open-ended
- Forms are grouped by what they do (Titles before the name and Epithets after the name for people, Titles of rule and Empires, republics and unions for realms, and so on), and the built-in ones are general enough for any world: Federation of …, … City, Dr. …, Lost ….
- Every list ends with Custom…: write your own form (Free city of …, where … is the name). It is kept for next time, listed under Yours, and can be removed with its ×. Kinds have a Custom… too: a place or society kind in your own word (fleet, fort, coven) is written on the note.
- "The" is its own choice for societies: tick The … to put it in front of the whole name, with any form (The Kingdom of England). Typing it is read back the same way.
- More titles are recognised when a person's name is typed (Dr., Professor, General, President…).
- A prefix and a suffix can be ticked together (King … with … the Great gives King Henry the Great). Two that want the same side of the name replace each other.
- The preset forms are broad: a few general ones per kind, so anything more specific is yours to add under Custom….
Importance
- Importance is five named steps (Footnote, Minor, Normal, Major, Key event) instead of a bare 1–5 slider, in the New note window, the edit form and the library inspector. Each step says on hover what it does, and the default is marked. The names match the quick creator and the timeline filter.
Community files
- The repository now has a code of conduct, contributing guide, security policy (private reports through GitHub), issue forms for bugs, feature requests and translations, and a pull request template.
4.6.0
The New note window
- One button per type, with the kinds under it. Place has Place and Region; Society has Realm, House, People, Language, Faith, Organisation and Other. Object and Creature are there too. The window stays pinned near the top and keeps its height, so nothing jumps when you change type.
- Each kind asks what fits it. A language has no ruler, a realm has a liege, a house a head, a faith its head; dates and places use the kind's own words. The Relationships list drops ties that make no sense (a language has none; a people has no vassals).
- Colour is the first field, easy to reach.
- Name forms to tick: Kingdom of …, House …, The … people, Church of …, … Castle, Battle of … and more for every kind. The plain name is kept as an alias, so a link to
Englandstill finds Kingdom of England. - Typed names are read. Writing Kingdom of England on the Realm button, or House Whitmore on House, splits it into form and name. A name that reads as another kind offers to switch to it.
- People's names are shortened from context. King Henry I the Bold offers Henry I Whitmore the Bold: the title comes off (and stays an alias), and the surname comes from the house you chose or a parent, placed before the epithet.
Explanations and links
- "?" notes and tooltips across the New note window (about 45 questions), the inspector (tabs, bottom buttons, more sections) and every view's Options panel (about 40 options).
- Links into the settings from the places they belong: where new notes go, which relationships appear, calendars, and a More settings for this view… entry at the foot of each Options panel.
- All interface text now follows the Obsidian sentence-case rules, so the plugin review lints clean.
Ready for translations
- A translation layer (
src/i18n/): the interface text gets one key per sentence inen.ts, shown throught("key")in Obsidian's own language, with English for anything not translated yet. French (fr.ts) is started, to be proofread by a French speaker. TRANSLATING.md explains how to add or fix a language. Screens are moved over a part at a time, Settings and the dashboard tabs first; until then they show English.
Library clicks and hover card
- Choose what a click opens in the Library and in the Files panel (Settings): the dashboard note, the markdown note, the inspector, or the note or dashboard together with the inspector.
- Hover card with the Hand-drawn edge no longer shows bumps and broken frames down its sides.
New kinds of note
-
Objects (a crown, a sword, a relic):
made:/destroyed:dates, who held it (cultures:entries withfrom:andto:) and where it was kept (places:entries with dates). A Journey list follows the places it was kept and where each holder lived while holding it. The map's Trace a journey draws that path, numbered, up to the date shown. The timeline's Show > Objects layer draws the object and one bar for each holder. -
Creatures: no dates, so they never appear on the timeline. They list where they are found and who they belong to. A place's map popup lists its Creatures (those found in it or in any place inside it) beside its Cultures, Languages and Faiths.
-
Languages are a kind of group with a row of their own next to Culture and Faith:
language:,languages:orspeaks:on a person or place, or a group of kind "language" incultures:. -
The quick creator has Language, Object and Creature, and the batch list cycles through them.
-
The Library has a tile for each kind of group (peoples, languages, faiths) that filters the tree. Connections has Objects (hexagons) and Creatures (dashed circles) chips.
-
Everything above is in the example vault: English, Latin and Welsh, the red dragon, and the Bosworth Crown.
-
"Group" is now "Society" everywhere you read it (the type, tiles, tabs, columns, the default folder for new vaults). The saved names do not change:
type: culture,#Group_...tags and your folders keep working. -
Each kind of society has its own words and questions, because a spoken language is used and joined differently from a family, a culture, a faith, a realm or an organisation. Members are Subjects, Members of a house, People, Speakers, Followers or Members. Places are Lands, Seats, Homeland, Spoken in, Holy places or Based at. Branches are Divisions, Cadet branches, Dialects and descendants, Denominations or Sub-organisations. Dates read Founded / Fell, Founded / Died out, Emerged / Faded, First spoken / Last spoken, Founded / Ended or Founded / Disbanded.
-
The quick creator asks what fits the kind: a language has no "Led by" and no liege, a realm has both, a house has a Head of the house, a faith a Head of the faith.
Relationships
- Connections, Family tree and Organisation are one view with a mode switch; the dashboard tab is Relationships.
- Partners and former partners are one list, current first, each with the same wording (Spouse, Former spouse, Widowed, Ex-lover), in the Library, the inspector, the hover card and the links tab.
- Worked-out ties are dashed, say what they were worked out from, and have a tick to Keep them (write them into the note). A header button keeps every worked-out tie in a list at once, and Undo reverses it. This covers heirs, siblings and the like, and partnerships ended by a death.
Files panel and Library
- One view in two places. The files panel in the sidebar is the Library, opened as the tree alone. Turn on the summary or details and it is the whole Library, in the sidebar. Each has a button to open the other.
Themes, animations and sounds
- New themes and a theme maker, each theme with its own buttons, tabs, edges, icons, headings, fonts, roundness, selection colour and frame. Hover a theme card to preview its backdrop and button style. Save your own mix as a theme.
- How much the theme does: the whole of Obsidian too, UniverseView only, or colours and fonts only. Theme colours the maps is its own switch.
- Animations (one switch): titles written or typed out, buttons outlined and coloured in, tabs and rows drawn in, cards dealt, family and connection lines drawing themselves, maps fading in with pins dropping, and dialogs opening the way the theme would. Off when Motion is Off or your system asks for reduced motion.
- Sounds (Settings > Theme settings): typewriter, keyboard, retro, synth, bubble and thud sets for typing, written titles and button presses, with a volume and a place to try them. Silent until you pick one.
- Settings are regrouped: Views and panels is one page, Notes and families is one page.
Example vault
- The example vault is the Tudors alone. The invented world is gone.
Groups
- A group knows what it is a branch of. A group's panel shows its chain under the name, the group first and then each group it is a branch of (Cadet house, Main house, Realm), each a link. Under any group chip with nothing else to say, the groups above it are named.
- Members roll up from branches. Members has a button to show this group alone or with everyone in its branches, each marked "via" the branch they came from. Each branch lists its own member count, and a group's events include those of its branches.
- A seat is a seat: a group's
places:is listed as Seat, with each place's address. - The quick creator makes every kind of group with one click: Realm, House, Faith, People, Organisation or Group.
- "Cultures" no longer names groups. The full creator, the dashboard, the command list and new vaults' default folder say Groups. Culture is now only one kind of group (a people), as House and Faith are. Your notes and settings are untouched:
type: cultureandcultures:still read and write as before.
Map
- A realm shown whole looks like a realm. Zooming out used to change the names but leave the look as the smallest division's. A duchy made of counties lost its tier's edge (the band or double line) when its counties merged, while a duchy drawn as one area kept it. A merged realm now gets its tier's edge along its whole outline, and its fill and line follow the tier it shows as, on every zoom.
- A land ranks below the one it is under. A realm tagged
#Group_Realmunder a kingdom counted as a kingdom itself (and wore the kingdom look); it is now a duchy, one tier below the title above it. Titles on the regions' own scale are left alone. - The picked-land panel says what its buttons do: Zoom in (into the land's divisions), Zoom out to the realm above, Edit borders, Inspect and Open note. The old Split clashed with the Split tool that cuts a land along a line.
Right-click menus
- The file explorer's menu is shorter. Obsidian's own menu is long, so UniverseView now adds only Inspect, Show in, Find out and one More (relatives, an event for a place, change icon). A folder gets one Folder in UniverseView entry holding its five views instead of five lines.
- The Files panel and Library menu is fuller, in order: open it (Inspect, Open note, Open beside, Copy link); do something to it (Rename…, Move to…, Change icon…); look at it elsewhere (Show in, Find out, relatives or Add event here…); More (open in a new tab, copy path, make a copy); and Delete… last, in red, asking first and going to the trash. Plain notes and folders get the same shape.
- Click a note's icon to change it, in the Files panel and in Obsidian's file explorer. The icon darkens when the pointer is on it, and the rest of the row still opens or picks the note.
Border check
- Fix all goes round again while that helps (up to four rounds), because fixing one border can show the next: a closed gap leaves a neighbour's crossing, or a pocket. On a map with 21...
4.5.1
Long lives and unknown dates
- Set how long someone can live.
max-age: 750on a person (alsomax_age,life-limit,life-expectancy) replaces the built-in 110 years. An elf with a birth date and no death date, born within that many years of today, is drawn as still alive: an open bar fading out, not a dot. It also counts for widowed partners and other "were they alive then?" checks. - Dates with brackets for what you don't know.
]before a date means "that or earlier";[after a date means "that or later"; the other side is exact. Inlifespan:and in any date (born, died, founded, dissolved…):"]1800 - 1888 ["(neither known),"[1800 - 1888 ["(born 1800, died after 1888),"]1800 - 1888 ]"(born before 1800, died 1888). Quote the value in YAML, as it starts with a bracket. - A later-than end is an open end. Someone who lived to at least 1888 is drawn up to that year and on to a lifetime past their birth (or today, if sooner), fading out like someone still alive, not as a dot.
4.5.0
Places have an address
- A place knows everything it is inside. Write only
located-in:on each place; the whole chain is read from that: Oklahoma City, Oklahoma County, Oklahoma, United States. A place's panel shows it under the name, each name a link (a top place with no note yet shows dashed). - There is an order of kinds from galaxy and planet down through continent, empire, country, state or province, county, city or town, village or district, and buildings to rooms. Check data flags a bigger kind inside a smaller one (a county inside a city) and a place inside itself.
- Everything inside counts. A place's People, Events and Groups include everything in the places inside it, and it lists what is directly Inside. Under every place chip (an event's Where, a person's places, an organisation's seat) the two places above it are shown, and the pickers show a place's chain so two places with one name can be told apart.
- Only in a place: the timeline and the map can be narrowed to one place and everything inside it, from their Options menus. A chip says which, and clears it. The same filter now matches at every level in code blocks too.
- A person's Places been is one chip per place with why (born, lived, an event) and when, and buttons roll them up to the county, state or country.
Events
- Led by: an event takes
lead:(people who led it). Leads count as present, and the panel, the timeline card and the hover card show them first. - Members present: an event at a place lists who was there, and each of them counts as being at that place on those dates.
- Journeys, marches and voyages take
start-place:andend-place:(alsodeparts-from,arrives-at), with places between them inplaces:. The map draws the path, bending it along your roads, rivers and sea lanes where that is quicker than a straight line. While the time slider is inside the journey, a dot shows how far along it is. - Part of it:
participants: [[Anna]] (1066-1068)puts someone at only part of an event. - Kinds of event (battle, siege, coronation, journey, voyage, migration…) are offered in the creator.
Where people are
- Residences: a person takes
residences:(with dates if they moved), their default location. Where were they? on a person's panel takes a date and says where they were, and why: at an event, at home, or where they were born. - People at this date (map Options): each person on the slider's date, at an event, on the road along a journey, or at home. People in one spot share a numbered bubble. Journeys and people now move smoothly as the date plays, and a speed button (1×, 2×, 4×, ½×) sits beside play.
- Check data reports a person at two places at once, a gap between two events too short to ride, and homes that overlap in time.
Other names
- Aliases: Obsidian's
aliases:property is read everywhere. A link written with one finds the note (located-in: [[USA]]is the United States), the creator's name check and Tab completion know them, search finds them, and a note's panel says "Also called …". - Alias sweep: Check data spots a link with no note that looks like another note (initials like USA, a whole word of its name, a slip of the keys) and offers to make it that note's alias, with Undo, instead of offering to create a new note.
The creator
- More about it: both creators keep the main fields up front and fold the rest away. It adds also called, died at, lives at, partners, children, caused by, led to, part of, population, terrain, a picture and a colour, as the note's own properties.
- The quick creator's fields flow into columns as its pane gets wider, the one-line box can be dragged taller, and the full creator window can be dragged bigger from its corner. The line understands
aka …,also called …andknown as ….
Fixes and tidying
- The family tree's relationship tag no longer needs the
:hasselector (it was slow to restyle); a class does the same job. - One place chain reader replaces three separate walks up the tree (hover cards, the arc view, fog of war).
4.4.0
4.4.0 — 2026-11-13
Size, rank and level
- Sizes are named for what they size. The Size box says "Large duchy" or "Small county", and a line under it shows the rank it makes ("Rank 2.8: Large duchy. Lower ranks are bigger."), the same number the realm tree and map order by.
- Regions have levels too: Continent, Sub-continent, Region, Land, Locale and Spot. Choose one under What it is (or let the landform say) and the size works within that level.
- The Library's notes table has a Rank column that sorts lands biggest first, and the tick-boxes bar sets role, status, tier, level and size for many places at once (one undo step).
Realm chart
- Fold the tiers. Each card with branches has a button under it that folds them away ("+3" shows how many are hidden); an Options entry unfolds all.
- Layouts: Chart, Outline (the tiers as an indented, foldable list) and Over time (who held each tier, full size).
- Cards say what they are: "Place" or "Realm", and "6 places within" for lands inside a land.
Roles and statuses of places
- Roles and statuses are lists you edit in Settings → Maps: a name and an icon (any Lucide icon or an emoji) each, and a pin colour for roles. Few generic ones come built in (Capital, Port, Holy, Market; Ruined, Abandoned, Lost, Destroyed).
- In the inspector they are chips with icons, the first few shown and the rest behind "more". Your own adds one with an icon of your choice; right-click a chip to change its icon or remove it. A place with a role wears its icon and colour on the map.
- What it is saves as you change it, with no Apply button to miss.
Map and groups
- Several cultures or faiths show as stripes in the map's Culture and Faith colouring, one band of colour for each.
- The graph's filter says Groups, not "Cultures", for group notes.
Fixes
- Events drawn on an organisation's bar are no longer drawn again loose in their own lane, and hovering one names the event, not the organisation.
- The Options panel is no longer see-through with the tactile panel style, and its actions are flat rows like the rest.
- The calendar's header, month names and year buttons no longer take Obsidian's raised button look, and share one height.
- A relationship chip in a narrow panel keeps its name, and the pencil no longer sits over the Add box.
4.3.0
Realms: a title, a land and a people
- A ruler's title shows everywhere they do: on their family tree card as before, and now on their hover card ("Title: Queen of England · Her Majesty") and as a chip in the inspector. One rule for all three.
- A realm's people as a culture. Under a person's or place's Culture box, each of their realms that names its people offers it in one click ("+ English"). On the realm itself, Make a culture next to Its people starts a culture note of that name (kind: nationality), which Culture boxes then suggest.
- The About tab names a realm's own words as the edit form does: Its people and Ruler's title, not "Demonym" and "Ruler title".
- A realm with no tier and a title of its own no longer gives its ruler the lowest tier's form of address: there is none to go by, so none is shown.
- A realm's edit form has a section of its own that says what a realm is: its land (seat and borders), its people, and its crown (its ruler and the ruler's title).
- Its people (
demonym:, ornationality:): what its people are called, as England's are English. - Ruler's title (
ruler-title: King, Queen): what its ruler is called, for a man and a woman. Family tree cards use it ("Doge of Vael"), so a realm of a kind of its own, with no tier word for its ruler, still gives its ruler a title. Empty uses the tier's title as before. - The Realm, Culture and Faith boxes say what they mean, for people and for places: a person's Realm is the realm they are a subject of (their nationality), a place's is the realm that rules the land, and Culture is a people by language and custom, which can differ from the realm. Each says where the other meanings go (titles on the realm, a region under Located in).
Inspector
- The Realm, House, Culture and Faith boxes only suggest groups of that kind. A group of no particular kind (#Group_Other) was offered in every box, so a band of outlaws could be picked as someone's culture; it is now offered under Organisation only. A realm, house, culture or faith is suggested when its note says so (#Group_Realm, #Group_Culture…) or UniverseView finds it to be one (a realm with lands, a house with members). You can still type any name.
4.2.0
Clicks in the family tree and the timeline
- One meaning per click, every time. In the family tree (every layout), a click opens the person's note and a double-click only centres the tree on them. In the timeline and its lineage mode, a click picks an item (its card shows beside it) and a double-click opens its note, once.
- A double-click no longer opens a note and centres the tree: the click now waits a little longer for a second one, and the card is marked at once so you can see it was clicked.
- With Follow the active note on, clicking a card no longer moves the tree; notes opened elsewhere still do.
- In the timeline, a double-click on an item can no longer start a new event when its card opening moved the item out from under the second click. A double-click on empty timeline still starts one.
- Alt+click (Option-click on a Mac) opens the inspector on any card, bar or mark, as it does everywhere in UniverseView; the tooltips now say so, and an Alt+double-click no longer centres the tree or starts an event.
Relationships
- A tie only asks what fits its kind. In the tie window and the Add relatives window, the kind is now two steps: what it is (Parent; Married or Not married for partners), then which kind, as tabs under it (Birth, Adoptive, Step, Foster, Guardian; Spouse, Consort, Widowed, Former spouse; Betrothed, Lover, Concubine).
- A birth parent has no dates and no ending; an adoptive parent asks when they were adopted; step, foster and guardian parents ask when and how it ended. A widowed marriage asks when it began but not how it ended. Details a kind doesn't have are dropped when you save, so switching a step-parent to a birth parent clears the dates.
- A kind of your own (such as "annulled") stays as a tab in the group it belongs to.
4.1.0
Family tree
- Cards name a partner by the kind of tie. A lover shows as "Lover", a betrothed as "Fiancée", an ex or an annulled marriage as "Former wife", instead of "Wife" for everyone. Step and in-law words are kept for marriages; other ties say what they are ("lover's father", "former wife of a cousin"). "Wife of a uncle" now reads "wife of an uncle".
- Short relationship names (Settings → Views → Relationship names on family tree cards): "husband of a great-uncle" becomes "distant in-law", "second cousin once removed" "distant cousin", "3× great-grandfather" "ancestor". Hover a card's tag for the exact name.
- The relationship tag on a card fades when the pointer comes near the plus above it, so the plus is never hidden.
Add relatives
- Ghost and Noted tabs. Ghost adds people by name only (a "Not created yet" card, as before); Noted picks people who have a note and links them.
- The picked kind (Parents, Children, Partners, Siblings) now shows as selected.
Inspector
- The pencil on a relationship is easier to see, as a small button of its own.
- The tie window matches the rest of UniverseView: the kind is a row of chips, and the dates, how it ended and your own text are labelled fields. A kind of your own (such as "annulled") is kept and shown, where before the window showed it blank and could drop it on save.
4.0.3
Exports
- The right picture in a website or world book. Two pictures with the same name in different folders could swap: the export now finds each picture by its full path.
- Exports with many pictures are faster: a picture is found directly instead of by searching the whole vault.
- The website export writes its files through Obsidian's own file functions, like the other exports.
4.0.2
Inspector
- Adding a group, relative or relationship in the edit form now saves. A name picked from the suggestions with the mouse (or added, removed or edited with the pencil) used to leave the form looking changed while nothing was written until you left it, so a card elsewhere kept showing the old data.
- Autosave no longer writes a name you are still typing: a half-typed word is only added once you confirm it or leave the field.