What is it?

FractalNote is online editor of hierarchical notes (or note trees) for Nextcloud/Owncloud server.

You can view/edit CherryTree (*.ctb) files with it in browser.

Current development phase is pre-alpha. Just nodes of plain text are editable, others are read-only.

See FractalNote in action

About Nextcloud/Owncloud

This is self-hosted Dropbox/Google Drive analog. It is able to synchronise your private files between all your devices. More about...

How to use FractalNote?

• Use CherryTree program for windows/linux desktop computers to create hierarchical notes.
• Save your hierarchical note tree as [filename].ctb with CherryTree program.
• Upload [filename].ctb to Nextcloud/Owncloud
• Edit uploaded file online: https://[your-cloud-server]/index.php/apps/fractalnote?f=[filename].ctb
• Install Nextcloud/Owncloud desktop synchronisation client.
• Put [filename].ctb under Nextcloud/Owncloud synchronisation folder of your desktop computer. From now the file will be uploaded into server automatically after every saving.
• In CherryTree program preferences keep checked autosave option and Edit->Preferences->Miscellaneous->Reload after external update to CT* file option. From now file changes made online will be downloaded automatically even while you navigating through the file with CherryTree program.
• [filename].ctb size should not be big (about <= 5MB), because for now the full file gets loaded with every page refresh in browser.

Installation

Server requirements

• PHP >= 5.6
• Nextcloud >= 12.0 OR OwnCloud >= 9.1

Steps

• Install into your web server Nextcloud/Owncloud.
• (This step is not required.) To open [filename].ctb from file list nextcloud/owncloud app you need:

Add ctb file type to the [(next|own)cloud install folder]/config/mimetypemapping.json like that:

{
    "ctb": ["application/cherrytree-ctb"]
}

Run in the command line:

cd [(next|own)cloud install folder]
./occ maintenance:mimetype:update-db --repair-filecache

• Place FractalNote in [(next|own)cloud install folder]/apps/fractalnote
• Install composer
• Run

cd [(next|own)cloud install folder]/apps/fractalnote
composer install

• Enable FractalNote in Nextcloud/Owncloud settings UI or by the command

cd [(next|own)cloud install folder]
./occ app:enable fractalnote

Running tests

After Installing PHPUnit run:

phpunit -c phpunit.xml

Tehnologies used

• JQuery jsTree plugin, that provides interactive trees: https://github.com/vakata/jstree
• Reponsive jsTree Twitter Bootstrap 3 Compatible Theme: https://github.com/orangehill/jstree-bootstrap-theme
• Handlebars.js https://github.com/wycats/handlebars.js/
• Inspired by awesome CherryTree: https://github.com/giuspen/cherrytree