Skip to content

albertasaftei/plumio

Repository files navigation

Header banner

plumio

Self-hosted markdown editor with live preview, document encryption, multi-user support, and multi-organization capabilities.

Demo   •   Docs

Introduction

plumio is a self-hosted markdown editor designed for individuals and teams who want a secure, private, and customizable note-taking solution. With features like live preview, document encryption, multi-user support, and multi-organization capabilities, plumio provides a powerful platform for managing your notes and documents.

Key Features

  • Markdown Editing: Write and format your notes using markdown syntax with a live preview.
  • Document Encryption: Keep your notes secure with end-to-end encryption.
  • Colorful Items: Organize your documents with customizable colors for easy identification.
  • Multi-User Support: Collaborate with team members by creating multiple user accounts.
  • Multi-Organization Support: Manage different groups or teams within the same instance.
  • Self-Hosted: Take full control of your data by hosting plumio on your own server or local machine.
  • Webhook support: Allow external services to receive real-time notifications for events such as document creation, updates, deletions, moves, and more.
  • API key management: Allow the users to authenticate and interact with the plumio API for various operations such as document management, search, and more.

Getting Started

To get started with plumio, check out our self-hosting guide for step-by-step instructions on how to set up your own instance. Once you have it up and running, you can start creating and organizing your notes right away!

Download desktop app

The desktop app is not signed with an Apple Developer ID or Microsoft certificate, so you may encounter warnings when trying to run it. This is expected for unsigned apps. To run the app, you will need to bypass these warnings:

macOS: Go to System Preferences > Security & Privacy > General, scroll down and click "Open Anyway" next to the warning about the app.

Windows: When you see the warning, click "More info" and then "Run anyway" to proceed.

You can download the desktop app for Windows and macOS from the releases page.

IMPORTANT

To connect to your remote server you must add to instance's ALLOWED_ORIGINS environment variable the URL of the desktop app: app://plumio

Documents folder change

The settings page allows the users to change the documents' saving directory. You will see an error popup but that is because the backend will restart after changing the path.

Backup System

plumio includes an optional automated backup system that runs daily to protect your documents. You can enable or disable this feature as needed, and it will create compressed backups of your data while managing retention automatically. Otherwise you can create manual backups at any time and view backup logs to keep track of your backup history. For more details, see the Backup System documentation.

Stack

plumio is built using the following technologies:

  • Frontend
    • SolidJS: A declarative JavaScript library for building user interfaces.
    • UnoCSS: An instant on-demand atomic CSS engine.
  • Backend
    • HonoJS (NodeJS): A small, fast, and lightweight web framework for building APIs.
  • Documentation
    • Docusaurus: A modern static website generator for building documentation websites.

Contributing

We welcome contributions from the community! If you'd like to contribute to plumio, please read our contributing guidelines for more information on how to get involved.

License

plumio is licensed under the AGPL-3.0.

About

A self-hosted markdown notes taking app with live preview, document encryption, multi-user support, multi-organization capabilities and more

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors