BigCal
A borderless floating calendar window showing month, week, and year views with note management. BigCal’s height caps at the browser viewport. When the calendar grid has too many rows to fit on screen, the content area scrolls while the header stays fixed. The window re-constrains on browser resize.
Opening BigCal
Section titled “Opening BigCal”- Double-click the HUD or MiniCal
- Call the API:
CALENDARIA.api.showBigCal() - Click the scene controls button when enabled
- Open it automatically on world load when enabled
Display Modes
Section titled “Display Modes”Switch between views using the dropdown in the header.
Month view
Section titled “Month view”The default view displays a monthly grid:
- Weekday headers with rest-day highlighting
- Day cells showing notes, moon phases, and festival indicators
- Multi-day events rendered as horizontal bars spanning weeks
- Previous and next month days shown in faded style, clickable to navigate
- Intercalary days in a separate row appended after the regular weeks, below the grid
Week view
Section titled “Week view”7-day layout with hourly time slots:
- 24-hour time grid with current hour highlighted
- All-day events displayed at the top of each column
- Timed events positioned by start hour and duration
- Recurring notes render on every matching day within the visible week
- Multi-day events split into a timed start block, all-day middle days, and a timed end block; continuation edges drop their rounded corners so the bars read as contiguous across days
- In week view, click the ”+” button on a time slot to create an event at that hour
- Each day-hour time cell has its own ”+” button for quick note creation at that hour
Year view
Section titled “Year view”A multi-year overview grid:
- Current year and current month highlighted with visual emphasis
- Click any month to jump directly to that month view
- Move between year ranges with the previous and next buttons
Header
Section titled “Header”Two-row layout:
Row 1: previous navigation arrow, Open Note Viewer button, compact toggle, calendar title, optional Chronicle button (only when the Chronicle button is enabled), settings, close button, next navigation arrow.
Row 2: dropdown view selector (Month/Week/Year), indicators, Today button, and Set Current Date button (GM only).
| Button | Action |
|---|---|
| Previous/Next | Navigate by month, week, or year depending on view |
| View Selector | Dropdown to switch between Month, Week, Year views |
| Today | Jump to current date |
| Note Viewer | Open the Note Viewer |
| Settings | Open settings panel |
| Compact | Switch to MiniCal |
| Close | Close BigCal |
| Set Current Date | Set world time to selected date (GM only) |
Equivalent dates
Section titled “Equivalent dates”The header shows an extra row whenever one or more equivalent calendars are selected in the Equivalent Date Calendars setting. For each selected calendar the row shows the current date converted to that calendar, linking to its Secondary Calendar Viewer.
Indicators
Section titled “Indicators”Below the header, contextual indicators show:
- Weather. Current conditions with icon and temperature. You can click it to open the weather picker.
- Season. Current season with icon and color
- Era. Current era name when the calendar has eras configured
- Cycle. Current cycle values when the calendar has cycles configured
Day cells
Section titled “Day cells”Each day cell in month view shows:
| Element | Description |
|---|---|
| Day number | Date, with today and the selected day each shown by a tinted cell background |
| Festival star | Indicates a festival day |
| Moon icons | Up to 3 visible, hover “+N” badge for additional moons; clickable for radial moon picker when >3 moons |
| Note indicators | Custom icons and colors for each note |
| Weather pill | Icon + temperature + wind direction for the day’s weather |
| Add button | Quick note creation, appears on hover |
Weather pills
Section titled “Weather pills”Day cells show weather as pills:
- Today. Current weather at full opacity
- Past days. Historical weather from the weather history
- Future days. Dimmed forecast weather
Each pill shows weather icon, temperature, and wind direction.
When you hover a day cell, a tooltip shows:
- Full date with era
- Festival name when applicable
- Season name
- Sunrise and sunset times
- Weather conditions
- Equivalent dates from other calendars when configured
- Note listing. Festivals listed first with a star icon, then notes with colored dots matching each note’s color. A “+N more” overflow indicator appears when the list exceeds its cap.
Interactions:
- Click a day to select it; click again to deselect
- Right-click for a context menu listing the day’s notes sorted alphabetically with inline edit and delete icons, plus BigCal-specific items. A “+N more” item opens the Note Viewer pre-filtered to that date when the day has more notes than the menu shows.
- Right-click the BigCal window header to also open the context menu
- Click a grayed-out day from another month to navigate there
Multi-day events
Section titled “Multi-day events”Events with duration span multiple days, rendered as horizontal bars across the grid:
- Color-coded with the note’s custom color
- Show note icon and title
- Arrow indicators mark events continuing from previous weeks
- When multiple events overlap, bars condense to thin lines. On hover, they expand to full height showing icon and title.
- Click any bar to open the note
- Optional bookend markers indicate the start and end days of the event
- Bars for timed multi-day events trim to the start hour on the first day and end hour on the last day, scaled against the active calendar’s hours and minutes per day. All-day notes and interior weeks of multi-week spans fill their cells edge to edge.
Display styles
Section titled “Display styles”Multi-day events render differently depending on their display style:
| Style | Rendering |
|---|---|
| Icon | Default. Event bar shows the note’s icon and title text across its duration |
| Pip | Dot indicator. A colored bar with reduced height |
| Banner | Full-width bar. A colored bar spanning the event’s entire duration |
Events sort by start date, then by display priority: banners first, then icons, then pips. Festival notes sort above other notes.
Viewing notes
Section titled “Viewing notes”Clicking a note indicator or event bar opens the note with edit mode forced, overriding the Note Open Mode setting. Owners open the note directly in edit mode; non-owners are downgraded to view mode.
Creating notes
Section titled “Creating notes”- Click the + button on any day cell, which appears on hover
- Use the right-click day context menu’s Add Note item
- In week view, click the + button on a time cell to create an event at that hour
- In week view, select a time slot to highlight it, then use a cell’s + button: BigCal honors the selected slot and creates the note at the selected hour. Without a prior selection, the + button creates a note at that cell’s own hour.
Searching notes
Section titled “Searching notes”The header book-open button opens the separate Note Viewer. BigCal has no built-in search panel. All note searching happens in the Note Viewer: type two or more characters in its search bar to filter notes in real time, with a clear-search button to reset.
Navigation
Section titled “Navigation”| Action | Result |
|---|---|
| Arrow buttons | Move by month, week, or year range depending on view |
| Today button | Return to current date |
| Click other-month day | Navigate to that month |
| Click month in year view | Jump to that month in month view |
| Double-click calendar header | Switch to MiniCal |
Double-clicking the calendar header switches to MiniCal. Double-clicking day cells, the grid body, events, notes, or buttons does not.
GM controls
Section titled “GM controls”GM-only controls:
- Set Current Date. Updates world time to the selected or viewed date
- Weather Picker. Click the weather indicator to change weather
- Show to All Players / Hide from All Players. Context menu toggle for BigCal visibility across connected players
- All time controls. Players cannot modify world time
The day context menu’s BigCal-specific items are: Settings (jumps to the BigCal settings tab); an Open entry whose submenu lists every Calendaria app (BigCal, MiniCal, HUD, TimeKeeper, StopWatch, SunDial, Chronicle); the GM-only Show to All Players / Hide from All Players toggle; and Close.
Intercalary days
Section titled “Intercalary days”Special days that don’t count toward the normal weekday cycle appear in a separate row appended after the regular weeks, below the calendar grid. These are usually festival days that exist outside the regular calendar.
Monthless calendars
Section titled “Monthless calendars”For calendars without months, the month view shows a three-week sliding window:
- Shows previous week, current week, and next week
- Navigation moves by week instead of month
- Header displays the week and year instead of a month name