Importing Calendars

Calendaria imports calendars from other modules and websites to migrate existing setups.

Supported sources

Source	Live	JSON
Calendaria JSON		✓
Obsidian.MD		✓
Fantasy-Calendar.com		✓
Mini Calendar	✓	✓
Seasons & Stars	✓	✓
Simple Calendar	✓	✓
Simple Timekeeping		macro¹

¹ Simple Timekeeping uses a macro-based export flow. See Simple Timekeeping below.

Missing your calendar source? Request a new importer.

Import process

Open Settings > Module Settings > Calendaria > Calendaria Settings
The Home tab is selected by default
In the Active Calendar section, click Open Importer to open the import dialog
Select your import source from the dropdown
Upload a JSON file or click Import from Installed Module for live import
If the source contains multiple calendars, select which calendar to import from the dropdown
Review the import preview
For each detected note or event, choose how to import:
- Skip. Do not import this item
- Festival. Import as a recurring festival day
- Note. Import as a calendar note (journal entry)
Click Import

The imported calendar opens in the Calendar Editor for review. Make any needed adjustments, then click Save.

Import preview

The import preview displays:

Calendar Summary. The calendar name as a header, with weekday count, month count, moon count, season count, days per year, and the current date
Detected Notes. Events and notes found in the source data with their dates

Current date preservation

Calendaria extracts and preserves the current date from source calendars during import:

The source calendar’s current date appears in the import preview
After import, the world time is set to match the source calendar’s date

For each detected note, use the radio buttons to choose:

Skip. Do not import this item
Festival. Import as a festival (fixed calendar event)
Note. Import as a calendar note (linked to a journal entry)

Use the Set All buttons to quickly mark all notes as Skip, Festival, or Note.

Simple Timekeeping

STK requires a two-step macro export because date conversion has to happen inside STK’s environment, not Calendaria’s.

Select Simple Timekeeping in the importer and click Copy Macro. Paste it into a new script macro and save.
Disable Calendaria, ensure Simple Timekeeping is enabled, reload the world.
Run the macro. It downloads stk-export-*.json.
Re-enable Calendaria, reload, then upload the JSON through the importer.

Post-import

After importing:

Review the calendar in the Calendar Editor
Make any needed adjustments to months, weekdays, seasons, and moons
Click Save to create the calendar
Check Set as active calendar to switch immediately

Festivals detected during import are not listed on the Festivals tab until you save. The tab shows a notice with the count of imported festivals that will be created on save. Save the calendar, then reopen it to edit them.

Undated events

Some importers encounter events without specific dates. These migrate to Foundry journal entries organized in the folder structure:

Calendaria Imports/[Calendar Name]/Undated Events/

Access these journal entries and manually assign dates if needed.

Troubleshooting

Import fails

Verify the JSON file is valid
Check that it comes from a supported source
Try re-exporting from the source application

Missing data

Some source-specific features may not have direct equivalents:

Complex recurrence patterns may simplify to basic yearly or monthly recurrence
Custom fields unique to the source may not transfer
OR-based conditions from Fantasy-Calendar are split into separate notes
Ordinal recurrence from Seasons & Stars imports as the first of the month with a warning
Month-only conditions from Fantasy-Calendar import as a festival spanning that entire month
Multi-day events keep their duration on import

Notes not appearing

After import, notes belong to the imported calendar. Verify:

The imported calendar is set as active
Notes are assigned to dates within the displayed range

Still having trouble? Report an issue with an importer.