mirador-annotation-editor-video

1.1.5 • Public • Published

Mirador Annotation Editor - Apache edition

Presentation

Generalities

mirador-annotation-editor-video(also known as "MAEV") is a Mirador 4 plugin that adds annotation creation tools to the user interface. It support both image and video annotation.

Copyrights

Originally forked from https://github.com/ARVEST-APP/mirador-annotation-editor-video

Licence

This plugin is released under the GPL v3 license unlike MAE and the original plugin.

Please acknowledge that any modification you make must be distributed under a compatible licence and cannot be closed source.

If you need to integrate this code base in closed source pieces of software, please contact us, so we can discuss dual licencing.

Authors

The authors of this software are :

  • Clarisse Bardiot (concept and use cases)
  • Jacob Hart (specifications)
  • Tétras Libre SARL (development):
    • David Rouquet
    • Anthony Geourjon
    • Antoine Roy

Contributors (updated february 2024)

  • AZOPSOFT SAS
    • Samuel Jugnet (especially code for the Konvas part)

General functionalities

  • Activate a panel with tools to create annotations on IIIF documents (manifests) containing images and videos with MAEV
  • Spatial and temporal targets for annotations
  • Overlay annotations (geometric forms, free hand drawing, text and images)
  • Textual/semantic annotations and tags
  • Annotation metadata (based on Dublin Core)
  • Annotation with another manifest -> network of IIIF documents

Technical aspects

  • Update to Material UI 5 and React 18 to follow latest Mirador upgrades (We support mirador": "4.0.0-alpha.2",
  • The paperjs library has been replaced with Konvas
  • Major refactoring since the original [mirador-annotations](https://github.com/ProjectMirador/mirador-annotations/) plugins
  • Works with the original Mirador 4 if you need only image annotation

Use in npm projects

npm install mirador-annotation-editor

Use in existing npm project with previous plugins

You can override existing annotation plugin with your own versions by using npm. We support React 18 and MUI 5.

Update your package.json file to include the following dependencies and devDependencies:

"mirador-annotations"
:
"npm:mirador-annotation-editor-video@^1.0.10",

You need also to use the custom version of Mirador 4.

"mirador"
:
"npm@mirador-video@^1.0.17",

If you encounter this error :

Install (local)

This method requires nvm, npm.

git clone git@github.com:SCENE-CE/mirador-annotation-editor.git
cd mirador-annotation-editor
nvm use
npm install

Run a demo with Mirador and the MAE plugin :

npm start

Use MAE with video annotation support

Persisting Annotations

Persisting annotations requires implementing a IIIF annotation server. Several examples of annotation servers are available on iiif-awesome.

mirador-annotation-editor currently supports adapters for annotot and local storage. We welcome contributions of adapters for other annotation servers.

Contribute

Our plugin follow the Mirador guidelines. Development, design, and maintenance is driven by community needs and ongoing feedback and discussion. To suggest features, report bugs, and clarify usage, please submit a GitHub issue.

Readme

Keywords

Package Sidebar

Install

npm i mirador-annotation-editor-video

Weekly Downloads

54

Version

1.1.5

License

Apache-2.0

Unpacked Size

636 kB

Total Files

167

Last publish

Collaborators

  • geourjoa
  • drilio