Flask based microframework to generate virtual escape room.
Escape rooms are a game form where the objective is to complete the mission and “escape” from a locked room. A successful escape involves finding hidden clues and solving puzzles spread through out the room in a pre-determined amount of time.
Virtual escape rooms, take this experience and put it online for groups of people not geographically co-located to still enjoy it as a group. These have become popular especially now given the pandemic and stay at home orders.
This package provides a simple command to take a escape room configuration and host it as a virtual experience for you and your family/friends to enjoy.
Simple CLI interface.
No complicated setup.
No coding knowledge required.
Design your own escape room experience for your friends and family to enjoy!
pip install escaperoomgit clone https://github.com/csurfer/escaperoom.git
python escaperoom/setup.py installPre-requisites:
Have your escaperoom configuration ready. Something along the lines of examplecampaigns.
escaperoom --helpJSON file provided is validated against the jsonschema file for type and key correctness.
escaperoom validation <path_to_json_file># To run with default host and port.
escaperoom run <path_to_json_file>
# To run with specific host and port.
escaperoom run <path_to_json_file> --host <customhost> --port <customport>This is the only detail you need to worry about. A JSON file in a specific format contains details of the escape room you want to host and this section throws light on the different components of the configuration file.
Each configuration file has two main components.
(required) A narrative to start your experience with. A tale of mystery and thrill.
(required) List of puzzles designed by you which is what your friends would solve during the event.
Story itself has following components.
(required) An interesting title to your story.
(required) Narrative of the story or text of the story.
(optional) Set of images you might want to show to have a dramatic effect. NOTE: Each image should either be a URL or absolute path to an image stored on your device.
Each puzzle in the list of puzzles has the following components.
(required) An interesting title to your story.
(required) Narrative of the story or text of the story.
(optional) Set of images you might want to show to have a dramatic effect. NOTE: Each image should either be a URL or absolute path to an image stored on your device.
(optional) Set of hints you might want to give to your friends to help them understand/solve the puzzles you have set.
(requied) Answer to your puzzle. Keep it as a word or a number to avoid confusions.
You can find some example campaigns in examplecampaigns. We use https://python-jsonschema.readthedocs.io/en/stable/ to validate the correctness of the config file. The schema we validate it against can be found at jsonschema.
Please use issue tracker for reporting bugs or feature requests.
Pull requests are most welcome. New and fun campaigns are always eagerly awaited.
If you found this package fun/useful you can buy me a cup of coffee using
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
