Skip to content

Michaelihc/mun-timer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MUN Timer

A customizable GUI timer tailored for Model United Nations (MUN) sessions. Designed for single-client use by the chair, it enables hybrid MUN formats—seamlessly blending online and in-person participants—without requiring any network connectivity.

Features

  • Timeline to keep track of events over multiple sessions
  • Feature-rich Voting and Motioning System
  • Simple Roll Calls
  • Caucus timing
  • Flexible events
  • Visual alerts and audio cues

Screenshots:

image image image image image image image image 67

Save/Load JSON

  • Save JSON: Click "Save JSON" to download the current configuration (topics, events, delegates, chair) as a .json file. The filename includes a timestamp.
  • Load JSON: Click "Load JSON" and choose a previously saved .json file to restore the configuration. The file is validated for basic shape before applying.

Notes:

  • Loading JSON will reset the current event selection and re-render the UI.
  • The expected schema matches the appData object used by the app: { topics: Topic[], events: Event[], delegates: Delegate[], chair: { name: string } }.

JSON-configurable timers for all events

  • Any event can optionally include a timer property (number of seconds). When present and greater than zero, the center panel will show a single timer UI with Start/Pause/Reset controls and a quick input to adjust seconds on the fly.
  • This works for general events and also appears beneath the Voting UI if timer is set on a voting event.
  • Existing time fields still apply for specific event types:
    • Moderated caucus: totalTime and speakerTime
    • Unmoderated caucus: duration
    • Optional: timer can still be added if a separate single-timer is desired.

Example event snippet

{
	"id": 42,
	"type": "general",
	"title": "Announcements",
	"subtitle": "Logistics",
	"topicId": null,
	"timer": 300
}

About

A Customizable GUI timer designed for MUN.

Resources

License

Stars

Watchers

Forks

Packages

No packages published