eteaching.plone.nostrmetadatasync 1.0.0b1

Nostr integration for Plone 6.

eteaching.plone.nostrmetadatasync

Nostr integration for Plone 6.

eteaching.plone.nostrmetadatasync synchronises metadata of Plone contents with Nostr. This is done on the basis of subscribers (event handlers). When content is created, deleted or modified on the Plone website, corresponding Nostr events are created, signed and sent to predefined relias in the Nostr network. Two control panels are also provided. One is for settings, where you can specify which content types and filters should be used to select the content affected by synchronization. The second control panel can be used to create all events in the Nostre relays for the entire content selected using the settings, or to send delete events.

Features

• Synchronizes metadata of event based objects (e.g. plone.app.event) with Nostr Time-Based Calendar Event (NIP-52)
• Synchronizes metadata of objects with Nostr AMB Event (NIP-AMB)

Installation

Prerequisites ✅

• An operating system that runs all the requirements mentioned.
• Python 3.10, 3.11, 3.12, or 3.13
• uv
• Make
• Git
• Docker (optional)

Install eteaching.plone.nostrmetadatasync from source with git 🔧

1. Clone this repository, then change your working directory

   git clone [e-mail]:e-teachingorg/eteaching.plone.nostrmetadatasync.git
   cd eteaching.plone.nostrmetadatasync
   

2. Create environment

   python3 -m venv .
   bin/pip install uv
   source bin/activate
   

3. Create an .env file

   vi .env
   

   to set NOST_KEY as an environment variable:

   NOSTR_KEY=MyPrivateNostrKey
   

4. Install the code base

   make install
   

5. Create the Plone site

   make create-site
   

6. Start

   make start
   

Install eteaching.plone.nostrmetadatasync via buildout

1. Use zc.buildout >=5, e.g. using the following requirements.txt:

   horse-with-no-namespace==20251105.1
   packaging==25.0
   pip==25.3
   setuptools==80.9.0
   wheel==0.45.1
   zc.buildout==5.1.1
   

2. Install Python venv and requirements:

   bin/python3 -m venv .
   bin/pip install -r requirements.txt
   

3. Add the following to buildout.cfg:

   [buildout]
   
   ...
   
   eggs =
       eteaching.plone.nostrmetadatasync
   

4. Run buildout

   bin/buildout	
   

5. Start

   bin/instance fg
   

Contribute

• Issue tracker
• Source code

License

The project is licensed under the GPLv2.