Skip to main content

Caroline open-source Python framework for interactive web/HTML-based science presentations

Project description

Caroline logo

Caroline is open-source Python framework for interactive web/HTML+JS based science presentations. With Caroline you can show and annotate everything. Interface is minimalistic and focus is on content, as we stick to the principle that the best software is the one that you don't realize is there. Caroline blurs distinction between slides and whiteboard, between demonstration and derivation, and smoothly even crosses from one way lecturing to interacting with the audience, allowing real-time note-taking, quizzes and even all-to-all collaboration. With Caroline making flow of ideas smooth, we can now reimagine how lectures can look! Caroline is made specifically not just to impress the audience but to allow you to do everything you possibly can to reach "aha!" moment of understanding and inspiration, thanks to

  • Simple input: supports full markdown support, LaTeX, code highlighting, zoomable figures; shows blinking pointer when mouse/pen pressed...

  • Annotations textual or by drawing during lecture over anything (text, video, figure...)

  • Camera support: for lecturer view; multiple camera for experimental demonstrations

  • Interactive elements: interactive figures, 3D objects, movies, JavaScript simulations and other IFrames

  • Audience engagement: quizzes, Roundtable discussions and feedback, audience slide-copy supports annotations and exploration in parallel with a lecture

  • Simple portability, and a decluttered interface focused on really necessary: Works in any web browser (from PC to smart fridge), even offline (assuming that no online materials are added in IFrames). Presentation is defined with a human readable plain text file that can be easily versioned with git.

Example presentation that highlights Caroline's capabilities is available here. The link opens lecturer copy. To see audience copy, follow the link on the first opened slide, but keep lecturer copy open to control presentation and see audience-submitted responses.

Example of stand-alone Roundtable - surface for collaborative feedback - which is part of is available at https://roundtable.researchx3d.com as a public demo server. Roundtable can be accessed from within the Caroline framework also. When used as support during meetings (in-person, video conference or mixed), it is ideally viewed opened on horizontal tablet surface while keeping vertical surface for direct view of collaborators, keeping the usual geometry of in-person meetings.

PyPI version

Get started in 5 minutes

Start by installing Caroline package from calling Python pip (install Python first if you don't have it) from the command line :

pip install caroline-presentation

In the folder where you want to make your presentation run

python -m caroline.template

This creates a template presentation in the folder. Edit presentation by changing presentation_code.py in your favorite code editor. Save changes and run

python presentation_code.py

To open/preview a presentation open presentation.html (or just refresh the page if it is already opened).

Alternatively, if you want to start from one full example of presentation, run

python -m caroline.example

To see other methods to start presentation that has support for interaction with the audience, or that is automatically pre-filled with material you have provided in a folder, please check ways to start a new presentation.

Name and logo

Caroline is named after Caroline Herschel (1750-1848) who was a pioneering astronomer and scientist. She had independent scientific career as a creator of New General Catalogue and discoverer of several comets, in addition to her work with her brother William Herschel (1738 -1822) early in her career. She was the first woman to receive a salary as a scientists, the first woman to hold a government position in England, the first woman to publish scientific findings in the Philosophical Transactions of the Royal Society.

The arrow and the line below Caroline name in the package's logo illustrate the aim of the package to show and annotate everything.

Roundtable is part of the Caroline framework, inspired by collaborative feedback sessions during supervision meetings. It is named after famous Round table of King Arthur, where everyone is equal, since when using Roundtable everyone can contribute, manipulate and annotate the content equally.

Authors & contributing

Developed by Nikola Šibalić, with encouragement, constructive feedback and early testing by Charles S. Adams.

If you like the Caroline, or Roundtable sub-project, please spread the word!

If you want to contribute to the project check contributing guidelines. Caroline is open-source, build with open-source stack of tools with aim to be flexible and adjustable.

License

All the files distributed with this program are provided subject to the BSD-3-Clause license. A copy of the license is provided.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Caroline-presentation-0.3.1.tar.gz (42.2 MB view details)

Uploaded Source

File details

Details for the file Caroline-presentation-0.3.1.tar.gz.

File metadata

  • Download URL: Caroline-presentation-0.3.1.tar.gz
  • Upload date:
  • Size: 42.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for Caroline-presentation-0.3.1.tar.gz
Algorithm Hash digest
SHA256 4a9f9f680f231c1aa1e7567cbc88c1d6630a61bb760bb70ffeb5a412188ec68d
MD5 390f9cde3fbe8d17cb9fb262c2a63f9b
BLAKE2b-256 d8f1e74fee6dedcc171e98a0335c82f110dbe7f884e441f6be65fc82021add2b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page