Notorious

Offline-first note taking application for desktop and the web. Private, fast, notorious 😈

Getting Started • Development Setup • React API Docs • Landing Page • Download

Introduction

Stream	Status
Latest
Master

Note Context Menu

Global Search is mapped to Ctrl + G and allows search by title and note content

Notebook context menu options

Tag selection for notes

Getting Started

Step 1: Download the Desktop App

Go to the Github releases section and download the installer for your platform. For a web based alternative, use the notorious_web docker deployment (read on for more on that).

Initial Setup

You have two options:

• Set up your own backend for usage across multiple devices, including synchronisation and replication (for backups).
• Local data directory only: Use Notorious without a backend and store all data locally (not recommended, see Backing Up Data Directory).

Step 2: Get the Docker Compose Files

Notorious backend is a CouchDB database. I have included docker-compose.sample.yaml and .env.sample file to get you started quickly. Download and rename these files into a local folder. (You can clone this repository and run the commands below).

mv .env.sample .env
mv docker-compose.sample.yaml docker-compose.yaml

Step 3: Edit the defaults

Edit the contents of .env, providing long and secure passwords and changing the domain names and customise the docker labels to suit your Traefik setup. The backend server needs to be externally accessible (if you want to access Notorious from outside your home network.)

Step 4: Start the docker compose stack

You can start the stack using docker-compose up -d. There are 3 containers:

Step 5: Initialise the database

Before you can start using Notorious you must initialise the CouchDB server by opening this link in your browser:

http://admin:admin@hostname:5984/_utils#setup

You are now ready to start using Notorious.

Please consider supporting development (See Contributions).

Support my projects on GoFundMe

Support my projects via PayPal

Web deployment

The notorious_web container spins up a web server you can use to access your notes through a web browser on the go. Take special note of the volumes section, which passes in the .env file to the container because the DB_URL string is required in order to connect back to your server.

I recommend you put this behind some kind of basic authentication such as Traefik's basic auth middleware.

Deploying static assets

YOu can generate static assets for web deployment using the yarn build-web command. The compiled files are available in the web/dist directory.

Backing Up Data Directory

This is applicable only if you don't have a backend server. Backing up or restoring the data directory when data is being synced to a remote server is untested and may have nasty consequences.

Data is stored in C:\Users\<username>\AppData\Roaming\Notorious\data, backing up this directory will help avoid data loss. Make sure to close Notorious before any backup and restore operation to avoid data corruption.

Development Setup

After cloning the repository and running yarn to fetch dependencies, you can start the app for development using yarn dev. This starts the renderer process in hot-module-replacement mode and starts a webpack dev server that sends hot updates to the renderer process:

yarn dev

Running production version for debugging:

yarn start

Packaging for Production

To package apps for the local platform:

$ yarn package-win

Contributing

Contributions in any form are encouraged and happily merged back into the codebase. You can help by:

• star this repository,
• raising issues,
• helping new users with issues they may encounter,
• improving documentation,
• submitting pull request with your kickass new features and bug fixes (raise a discussion issue first),
• recommending the software to others (Spreading the word),
• donating spare change

There is an immense backlog of work to be done on this and I will not be able to do it by myself. If you are into React dev and would like to help me on this project please get in touch.

Donations

Donations will ensure the following:

• 🔨 Long term maintenance of the project
• 🛣 Progress on feature requests
• 🐛 Quick responses to bug reports and help requests

License GNU GPLv3

This license was chosen to ensure this project stays open source and contributor enhancements are made available to the public.

GNU GPLv3 Permissions of this strong copyleft license are conditioned on making available complete source code of licensed works and modifications, which include larger works using a licensed work, under the same license. Copyright and license notices must be preserved. Contributors provide an express grant of patent rights.

See COPYING for complete license text.