Skip to content

An open source web note taking / highlighter software - Please star if you like this project

License

Notifications You must be signed in to change notification settings

notelix/notelix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

notelix

logo

An open source web note taking / highlighter software (with backend).

demo demo2

Notelix features:

  • Powerful and reliable web highlighting (powered by MIT-licensed @notelix/web-marker)
  • Adding notes to highlights
  • A search engine for your highlights and notes (powered by MeiliSearch)
  • An app to manage your highlights and notes in one place
  • Optional client-side encryption (and an optional agent that runs on user's machine if they have client-side encryption enabled and want features such as the search engine)
  • Use as a chrome plugin (download a zip and install it to try), or use it as a service and integrate it into your website / project without requiring users to install a plugin (try it)
  • Works well with darkreader
  • More features coming soon...

building and running chrome extension

cd chrome-extension
./build-extension.sh

Then Load unpacked from chrome://extensions/

building and running backend

cd ./server
echo "DB_PASSWORD=$(echo $RANDOM$RANDOM$RANDOM | md5sum | head -c 32)" > .env.dev
docker network create notelix

# start server in dev mode

docker build . -f ./Dockerfile.dev -t notelix:dev
docker-compose -f docker-compose.dev.yml --env-file .env.dev -p notelix-dev up -d 

Architecture

Running notelix agent (only necessary when client-side encryption is enabled)

cd server
echo "DB_PASSWORD=123456" > .env.agent
docker network create notelix
docker build . -f ./Dockerfile.agent -t notelix:agent
docker-compose -f docker-compose.agent.yml --env-file .env.agent -p notelix-agent up -d

Wait a bit, refresh a tab in Chrome, then wait a bit for data to sync.

After successful data sync, you will be able to use advanced features such as searching, with client-side encryption enabled.

Public DEV server

https://public-dev.notelix.com/

Note: this server is free-to-use, but doesn't provide any guarantee regarding availability or data safety.

In fact, this database will be reset when there is major Notelix API change. (expected every year).

Only use this dev server when you are trying out Notelix.

For production use, please host your own server (see building and running backend), and use cron + pg_dump or https://github.com/wal-g/wal-g to backup your database.

Using Notelix Embedded to add it to your website without requiring users to install a browser extension

Try here. See chrome-extension/embedded.html for the code.

A note about LICENSE: If you want to integrate Notelix into your project using the above method, it's okay not to disclose source code of your project. You only need to disclose source code for any changes made directly to Notelix.

Contact me if you have questions regarding LICENSE / for custom licensing.