Journal entry bundles


Jump to: navigation, search
  This page is monitored by the OLPC team.
  Please copy/paste "{{Translationlist | xx | origlang=en | translated={{{translated}}}}}" (where xx is ISO 639 language code for your translation) to Journal entry bundles/translations HowTo [ID# 184371]  +/-  



Entries in the Journal are composed by opaque data stored in one file and metadata properties about that data. For retrieving entries from one XO's Journal to another, all that information about an entry needs to be bundled in a single file. This file is called a 'journal entry bundle'.


By bundling journal entries in single files, we can share entries between XO's and retrieve entries from the web (for example downloading from an http server that manages our backups).

Bundle Structure

The journal entry bundle is a directory named after the original entry ID. Each activity bundle must contain a file named "_metadata.json", and following a special format. For example:


Metadata is stored in this file as a JSON-encoded dictionary containing each property as a key-value pair:

 "title":"Paint Activity",

The preview property is an external property, and as such, its value is the name of a file inside a directory with the property name inside the bundle directory (preview/15b114ad-1eed-461f-9315-129bba41ce2d)


File named following the ID of the original journal entry. Contains data opaque to the Journal in the format specified by the mime_type metadata property.


Directory containing a single file that in turn contains the data for that property. This is meant for external properties, which can include an amount of data bigger than what can be stored in the _metadata.json file.


Journal entry bundles should be packaged as zip files with the ".xoj" extension. The mime type of the file is 'application/vnd.olpc-journal-entry'.

Personal tools
  • Log in
  • Login with OpenID
About OLPC
About the laptop
About the tablet
OLPC wiki