View on GitHub

neutriNote

download .ZIPdownload .TGZ

User Guide

[Japanese Edition]

  1. Getting Started
  2. Backup and Restore
  3. Search Tools
  4. Advanced Features
  5. Performance
  6. Log Tool
  7. Relocate Local Repository
  8. Known Issues
  9. FAQs
  10. Privacy Policy
  11. TODO
  12. About

Getting Started

Thank you for choosing neutriNote.

Right after installation, be sure to follow the onscreen instruction and choose a location for Local Repository.

If your repository is empty, you may add notes right away.

If you have installed neutriNote previously, you may pick the repository already on your device.

If you have settings backed up from your previous installation, you may also choose Restore App Data to restore settings.

To enable sync is easy, either install a third party app like Syncthing and register your repository with it or get neutriNote Connector+ – a Dropbox adapter designed just for neutriNote.

Even without add-ons, neutriNote is ready for use. Explore around to discover many features that would make neutriNote a highly integrated part of your note taking experience (for example, long tap metadata label to retrieve notes sharing similar label and tap the local find icon in the edit screen to jump to the next match). To extend it into a tool for personal information management, please do take a moment to go over the following sections. New users may also want to check out Backup and Restore for ways to preserve note data beyond the sync mechanism.

IMPORTANT: from v1.3.1, neutriNote supports Runtime Permissions in Android Marshmallow devices. Be sure to grant neutriNote permission to access external storage for its Local Repository to work properly. To enable previously denied permissions, go to neutriNote’s App Info under Android, renable the permissions and restart the app.

Backup and Restore

If you have already activated Local Repository, your notes will be sync seamlessly to the repository. You can replicate your notes remotely by sharing the folder with third party apps such as Syncthing. IMPORTANT: Do NOT use stale repositories since they could be out of sync. Always use the method described in the Getting Started section from above to initialize and assign repositories.

Incremental Backup is another way to copy your notes in non-intrusive fashion. To enable, simply do so from Settings. Then your notes and app settings will be backed up incrementally at least once daily to a internal storage folder called neutrinote_export. Note: exported app settings data are stored in regular notes with prefix .neutrinote so that they can be sync no differently from other notes.

When incremental backup is enabled, a task to conduct full backup when the device is idle will also be activated. A maximum of 10 most recent backups will be maintained. See Storage Saver section for more suggestions on how to manage backup storage space.

Search Tools

While notes can be retrieved based on modified time, accessed time, and location as providied by the user interface, neutriNote supports high precision text based search and regular expression. The syntax below are also highly reusable when they are included as part of the preset filters (under Settings).

Search by Fields It is possible to restrict search to a specified field. For example, at the main search bar over the note list, search can be limited to titles by using the prefix title: in the search string. A search string liketitle:log will return all notes with the substring log in the titles.

Search can also be limited to metadata by using the prefix meta: in the search string. A search string such as meta:personal will return all notes with the substring personal in the metadata (likewise meta: will return notes without metadata). It is also possible to use regular expression in metadata search, simply use the prefix metareg: in the search string.

To ensure metadata match when conducting multi-term search, one may use the following syntax at the main search bar: join:term1,term2,term3,...,termN and so on. Doing so will ensure at least one of the terms can be found in the metadata for each search hit. Such syntax can be used to simulate search within metadata/tags. Alternatively, fuzzy search can be conducted on metadata with syntax related:term1,term2,term3,...,termN and similar:term1,term2,term3,...,termN.

To search for multiple terms, the easiest way is to use Advanced Search. You can also specify boolean search queries with syntax like and:term1,term2,term3,...,termN to find notes containing all the terms (or:term1,term2,term3,..,termN to find notes containing one of the terms).

Custom Filters The power of the above syntax lies in that it can also be included in preset search filters so that users can easily deploy. Custom filters can be specified in Settings delimited by semi-colons. They are defaulted to be:

all;starred;A;B;C;D;E;F;G;H;I;J;K;L;M;N;O;P;Q;R;S;T;U;V;W;X;Y;Z

all is reserved for retrieving all notes, and starred reserved for retrieving starred notes. Single character filters are reserved for retrieving notes with titles beginning with said alphabets.

For searching within notes, neutriNote recognizes basic Perl style patterns: \d for digits, \s for whitespace, etc.

Advanced Features

Metadata

Metadata are general purpose text strings that exist outside note data. They are searchable and can be used as tags. To emulate filtering by tags, simply enter into the main search bar queries like tag:term1,term2,term3,...,termN, so that each term must be present in the metadata (in any order) for a note to be considered a match. On the other hand, if the presence of any one term is sufficient for a note to be considered a match, use tag*:term1,term2,term3,...,termN instead.

Markdown

neutriNote supports PHP Markdown Extra and LaTeX style mathematical expressions. The easiest way to enter mathematical expressions is to wrap them in $$. For inline math, use \\(...\\) as in the example below:

This expression \\(\sqrt{3x-1}+(1+x)^2\\) is an example of an inline equation.

To create in-document anchors/footnotes in PHP Markdown, use link syntax as in the following example:

# heading 1 {#header1}

## heading 2

* item 1:
    + sub item *1.1*
    + sub item *1.2*
* item 2
    + sub item *2.1*
    + sub item *2.2*
    + sub item 
    + [Link back to header 1](#header1)

To allow table of contents to be generated automatically, add a placeholder <span id='toc' />, tag each paragraph header with a unique ID by following the convention of PHP Markdown special attributes such as{#id}. Try the example below:

Table of Contents
=================

<span id='toc' />

## Header 1 {#header1}
    * Your paragraph here...
    
## Header 2 {#header2}
    * Your paragraph here...
    
## Header 3 {#header3}
    * Your paragraph here...

To create link between notes, simply use one of the following syntax (%20 denotes space):

[My File](file:///sdcard/neutriNote/my_file.txt)

[My File](./my_file.txt)

[My File](my_file.txt)

[GTD](get%20things%20done.txt)

Linking to an image under local repository, simply do:

![My Image](my_image.jpg)

Linking to notes from other apps that support hyperlinks, simply prefix note names with http://neutriNote.io. For example:

http://neutriNote.io/my_diary

http://neutriNote.io/my_diary?search=first%20headquarter%20visit

There is a conflict between Markdown italic symbol and LaTeX subscript symbol. To workaround this problem, either escape the subscript symbols or wrap the expression in script block. For example, instead of doing this:

$$k_{n+1} = n^2 + k_n^2 - k_{n-1}$$

do this:

$$k\_{n+1} = n^2 + k\_n^2 - k\_{n-1}$$

Or use script block with the desired type like this:

<script type="math/tex">k_{n+1} = n^2 + k_n^2 - k_{n-1}</script>

On the other hand, to allow line breaks within $$ segments, use \\\ instead of \\.

It’s easy to customize the style of Markdown with popular inline CSS. For more extensive styling needs, you can “swap out” built-in styling by declaring your CSS in ~neutrinote_styles.txt. If your style is based off an existing Markdown theme, this process is pretty much effortless. For example, to solarize your Markdown, simply copy and paste the following two lines into ~neutrinote_styles.txt.

<link href="http://thomasf.github.io/solarized-css/solarized-light.min.css" rel="stylesheet"></link>
<script src="https://cdn.rawgit.com/google/code-prettify/master/loader/run_prettify.js"></script>

Examples

An example of how neutriNote’s rendering component could be used to plot a graph using JSXGraph:

<div id="box" class="box" style="width:500px; height:500px;"></div>
<head>
<script type='text/javascript' src='http://cdnjs.cloudflare.com/ajax/libs/jsxgraph/0.98/jsxgraphcore.js'></script>
<script type='text/javascript'>
 var b = JXG.JSXGraph.initBoard('box', {boundingbox: [-10, 10, 10, -10], axis:true});
b.create('functiongraph', [function(x){return Math.sin(x);},-Math.PI,2*Math.PI]);
</script>
</head>

An example of how neutriNote’s rendering component could be used to draw a simple shape:

<canvas id="example" width="200" height="200">
</canvas>

<head>
<script>
var example = document.getElementById('example');
var context = example.getContext('2d');
context.fillStyle = 'red';
context.fillRect(30, 30, 50, 50);
</script>  
</head>

Draw a simple diagram in plain text is easy using yUML. Try this (note the single ticks):

<img src="http://yuml.me/diagram/scruffy/usecase/[Cms Admin]^[User], [Customer]^[User], [Agent]^[User]" >

<img src="http://yuml.me/diagram/nofunky/class/`[Customer]->[Billing Address]`">

Tabular data can be processed by custom codes (note the placeholder cells for outputs):

| Type A | Type B | Type C |
|--------|:------:|-------:|
|       1|       2|       3|
|       2|       2|       4|
|       3|       2|       5|
|        |        |        |

<head>
    <script
        src="https://code.jquery.com/jquery-3.3.1.slim.min.js">
    </script>
    <script>
        $(document).ready(function()
        {
            $('table thead th').each(function(i)
            {
                sumCol(i);
            });
        });

        function sumCol(index)
        {
            var total = 0;
            $('table tr').each(function()
            {
                var value = parseInt($('td', this).eq(index).text());
                if (!isNaN(value))
                {
                    total += value;
                }
            });
            
            $('table tr:last td').eq(index).text('Total: ' + total);
        }
    </script>
</head>

Automation

neutriNote can easily be integrated into existing Tasker automation. For example, to launch a third party Tasker plugin, it can be as simple as creating a Tasker profile to “observe” Local Repository events. Specifically, to trigger third party sync plugins, simply add a blank file ~neutrinote_noop.txt in Local Repository and have its modifications monitored by Tasker to piggyback a modification event corresponding to that file emitted by pull-to-refresh in neutriNote.

One of the most useful features of Tasker is its rich set of variables. One can easily maintain of log of the variables in neutriNote as well. Consider this example of keeping clipboard history in neutriNote: simply create a profile to monitor the setting of Tasker’s %CLIP variable, then add the following task (replace the path with that of your Local Repository):

A1: Variable Set [ Name:%NEWLINE To:Do Maths:Off Append:Off ] 
A2: Write File [ File:neutriNote/clipboard_events.txt Text:## %DATE %TIME %NEWLINE %CLIP %NEWLINE Append:On Add Newline:On ] If [ %clip neq %clip_prev ]
A3: Variable Set [ Name:%clip_prev To:%CLIP Do Maths:Off Append:Off ] 

Combined with other ways to extend neutriNote, there are essentially an infinite number of ways to automate the creation of richer note contents.

Text Expansion

neutriNote supports text expansion: simply highlight any shortcut word and tap the Text Expansion icon to expand the word. All shortcuts are saved in a file called ~neutrinote_shortcuts, with one definition per line in the format of shortcut label|expanded text (if you do not see the file, enable hidden files under Settings). Below are some examples:

cell|123-456-7890
email|john.smith@test.com

# Usage: select "highlight your_text" and expand, return "<mark>your_text</mark>".
highlight|<mark>???</mark>

Shortcuts can be defined for frequently used patterns for string replacements. For example:

# Usage: select "encode some_text_string" and expand, some_text_string will be returned with all blank spaces encoded.
encode|neutriNote#replace \s %20

To replace all occurrences of a specific pattern by line breaks, simply:

# Usage: select "eol some_text_string" and expand, some_text_string will be returned with all blank spaces replaced by linebreaks.
eol|neutriNote#linebreak \s

<nano:br> can also be used as placeholders for linebreaks in shortcut definitions. For example:

# Create a blank 3x2 table.

3x2|| | | |<nano:br>|---|---|---|---|<nano:br>| | | |<nano:br>|---|---|---|---|

An example to trim leading and trailing spaces from a body of text:

# Usage: select "trim some_text_string" and expand, leading and trailing spaces of some_text_string will be removed.
trim|neutriNote#trim

Shortcuts to obfuscate / defuscate a chunk of text:

# Usage: select "obfuscate some_text_string" and expand, some_text_string will be obfuscated.
obfuscate|neutriNote#encode

# Usage: select "defuscate some_text_string" and expand, some_text_string will be defuscated.
defuscate|neutriNote#decode

You can also use basic C style format specifiers to “morph” text snippets.

# Usage: select "addcomma some_numeric_string" and expand, some_numeric_string will be comma separated.
addcomma|neutriNote#morph ℅,d

These simple shortcuts make it easy to sort lines:

# Usage: select "sort some_lines" and expand, some_lines will be sorted.
sort|neutriNote#sort

# Usage: select "rsort some_lines" and expand, some_lines will be sorted in reverse order.
rsort|neutriNote#rsort

There is even a way to remove HTML tags from strings:

# Usage: select "notag some_text_string" and expand to remove HTML tags from some_text_string.
notag|neutriNote#removeHTML

To remove zero-width spaces, simply do:

# Usage: select "zero some_text_string" and expand to remove zero-width spaces from some_text_string.
zero|neutriNote#nohiddenspace

You can create shortcuts for simple shell commands as well. Give it a try by adding the prefix neutriNote$ to the commands just like below:

date|neutriNote$ date
ps|neutriNote$ ps

To emulate the behavior of to-do list, shortcuts can be defined to mimic checkbox toggling.

# Usage: place cursor next to any asterisk and expand.  To toggle checkboxes, tap expand again.

*|[▪]
[▪]|[✔]
[✖]|[▪]
[✔]|[✖]

Multitasking especially with floating apps is easier with shortcut like this:

# Usage: launch a terminal without leaving neutriNote by expanding the shortcut.

termfloat|neutriNote#launch com.termux.window

You can include basic parameters with the commands, just write them after the command shortcut and separate each parameter with space+commas like this: shortcut_label param1 , param2 , param3. Select the whole string and tap the expand icon to paste the output. Users of cURL can also simplify the definitons of their expansions with neutriNote? instead of neutriNote$ and trail that directly by a URL.

Batch Select

Special selection commands are available for better productivity.

Voice Memo

neutriNote is compatible with Google Now dictation. Simply say Ok Google note to self and pick neutriNote to capture what you say.

External Fonts

It’s easy to use external fonts such as those featured by Google Fonts in neutriNote (IMPORTANT: be sure to read their terms of use carefully):

  1. Create a folder called fonts under your Local Repository, download and save the font file (.ttf) in that folder. Note that external fonts will not be backup by neutriNote.
  2. Enable hidden files under Settings. Create a new note called ~neutrinote_fonts if one does not exist yet.
  3. Add a section in the note for the font (if there are multiple fonts, separate each section by a blank line) with a line dedicated to each of the following:
    • Font name (any meaningful name)
    • Font file name (.ttf)
    • Link information (see instructions from Google Fonts)
    • CSS style (see instructions from Google Fonts)
  4. The font is now ready for use in neutriNote.

For example, to use this font, just add this section to ~neutrinote_fonts:

Goudy Bookletter 1911
GoudyBookletter1911.ttf
<link href='https://fonts.googleapis.com/css?family=Goudy+Bookletter+1911' rel='stylesheet' type='text/css'>
font-family: 'Goudy Bookletter 1911', serif;

Ambient Glow

Ambient Glow is an experimental function that adjusts the color temperature of neutriNote to approximate the level of your current environment for a more atmospheric editing experience. It differs from blue light filtering apps in that it does not demand your location information – instead only light sensor data from Tasker will be used (to conserve battery). neutriNote Auto Theme is required for this function to work properly. Note that Ambient Glow will not be applied to Markdown and for users of blue light filters it is recommended that this function be disabled.

Keyboard

The following editor shortcuts are supported when connected to a physical keyboard:

Shortcuts Actions
Ctrl-S Save
Ctrl-F Local Find
F3 Find Next
Ctrl-H Replace
Ctrl-D Dictionary Lookup
Ctrl-W Web Search
Ctrl-M Markdown
Ctrl-Z Undo
Ctrl-Shift-Z Redo
Ctrl-] or Ctrl-I Indent
Ctrl-[ or Ctrl-Shift-I Un-indent

Gestures

Various user interface elements support gestures for better productivity:

Hacks

What follows are features that may conflict with the core functions of neutriNote. Use at your own discretion.

You can tinker with the variables found inside of ~neutrinote_settings_data (enabled by Show Hidden under Settings). After saving your changes, do Restore App Data for the changes to take effect. Note: altering the setting file could affect the stability of neutriNote.

Variable Names Values
com.appmindlab.nano.pref_open_in_markdown true: always open notes in markdown preview
com.appmindlab.nano.pref_markdown_trigger Specify a metadata substring pattern to open notes in Markdown by default
com.appmindlab.nano.pref_safe_mode_tag Specify a metadata substring pattern to disable internal Markdown parser
com.appmindlab.nano.pref_auto_toolbar_tag Specify a metadata substring pattern to enable auto show / hide toolbar (hint: tap screen to hide, double tap to re-display)
com.appmindlab.nano.pref_linkify_trigger Specify a metadata substring pattern to open notes linkified by default
com.appmindlab.nano.pref_latex_single_dollar true: use single dollar signs to signify math expressions
com.appmindlab.nano.pref_indent_char Specify the character(s) to use for indentation. Default: 4 spaces
com.appmindlab.nano.pref_append_custom_style true: Extend built-in styles with ~neutrinote_styles.txt, false: Replace built-in styles with ~neutrinote_styles.txt
com.appmindlab.nano.pref_show_toolbar true: always show edit toolbar (hint: tap screen to hide, double tap to re-display
com.appmindlab.nano.pref_toolbox_mode stateful: keep editor toolbox scroll position (default), stateless: always reset editor toolbox scroll position, pin_save: keep save button visible
com.appmindlab.nano.pref_oled true: dim screen elements for OLED screens
com.appmindlab.nano.pref_canvas_strokes Fixed width symbols supported by sketch tool delimited by semicolons, e.g., :;\;/;_;-;,;● (vertical bar and semicolon not allowed)
com.appmindlab.nano.pref_font_size_list Specify custom font size options delimited by semicolons. Default: 8;10;12;14;16;18;24;32;48
com.appmindlab.nano.pref_margin_list Specify custom margin options delimited by semicolons. Default: 8;16;24
com.appmindlab.nano.pref_excluded_buttons Selectively hide toolbar buttons via a semicolon delimited string, e.g., location;draw;replace will hide the location, draw, and replace buttons on the toolbar. The following buttons can be hidden: markdown, time, date, location, expand, draw, top, bottom, find, replace, barcode, image, ocr, define, calculate, search
com.appmindlab.nano.pref_custom_date_format Override system date stamp format with custom date format
com.appmindlab.nano.pref_custom_time_format Override system time stamp format with custom time format
com.appmindlab.nano.pref_preview_mode start: display the beginning of notes in preview, end: display the end, off: disable preview
com.appmindlab.nano.pref_star_at_top true: place starred notes above other notes in list view. Default: false
com.appmindlab.nano.pref_icon_behavior 0: animation off, 1: animation on, 2: snooze animation
com.appmindlab.nano.pref_keep_deleted_copies true: keep copies of deleted files under trash_bin folder
com.appmindlab.nano.pref_max_deleted_copies_age Specify maximum number of days deleted copies will be kept (pruning to occur during next backup). Default: -1 (unlimited)
com.appmindlab.nano.pref_max_sync_log_file_age Specify maximum number of days sync logs will be kept. Default: 7 (1 week)
com.appmindlab.nano.pref_max_sync_log_file_size Specify maximum size for each sync log file (factor of 200 KB). Default: 2 (400 KB)
com.appmindlab.nano.pref_local_priority_tag Specify a metadata substring pattern to prevent local copy from being overwritten by remote changes. Note that conflicts may occur if a note is being edited on multiple devices
com.appmindlab.nano.pref_remote_priority_tag Specify a metadata substring pattern to override local changes with remote changes when they occurred concurrently. Note that conflicts may occur if a note is being edited on multiple devices
com.appmindlab.nano.pref_eval_built_in_variables true: evalute built-in variables in search or shortcut definitions
com.appmindlab.nano.pref_low_space_mode true: turn on storage space saver
com.appmindlab.nano.pref_new_note_title_template Specify title template for new notes. Default: New Note
com.appmindlab.nano.pref_new_note_file_type Specify file type for new notes. Multiple type mode required (see below). Default: .txt
com.appmindlab.nano.pref_parse_python true: enable basic Python code interpretation. Default: false
com.appmindlab.nano.pref_lab_mode true: enable experimental features such as OCR, diff-tool

Advanced users may enable multiple text file types for neutriNote. To setup, please carefully follow all the steps below:

  1. Backup ALL app settings and notes.
  2. Add a blank file called ~neutrinote_multitype.txt to your Local Repository.
  3. Un-install neutriNote (or clear the app’s data under Android’s system settings).
  4. Re-install neutriNote.
  5. Once rescan finishes, file extensions will appear in note titles.
  6. Restore app data.

(To reverse the support of multiple file types, you would need to remove the file ~neutrinote_multitype.txt, then un-install/re-install neutriNote.)

To enable search history transfer across devices, simply add a note called ~neutrinote_search_history.txt. Search history can then be cloned when app data are restored by tapping Restore App Data on your other devices.

Note that neutriNote Connector will not handle files without .txt extension. To sync files without .txt extension with Dropbox you would have to install a third party app or install neutriNote Connector+. (If you have neutriNote Connector installed, you would need to remove it prior to launching neutriNote Connector+. If you have neutriNote Connector+ installed, you would need to re-install the app.)

Built-in Variables (v2.3.4)

Built-in variables may be used in search or shortcut definitions. For example, to find notes with tomorrow’s time stamp, simply type @tomorrow in the search box. You can even include built-in variables in Custom Filters, say, for listing notes containing tomorrow’s time stamp, or include them in shortcut definitions to generate text expansion snippets on the fly.

Variables Descriptions
@title Title of the current note.
@created Created time of the current note.
@modified Last modified time of the current note.
@accessed Last accessed time of the current note.
@clipboard Clipboard content.
@yesterday Yesterday’s date stamp.
@today Today’s date stamp.
@tomorrow Tomorrow’s date stamp.
@now Current time stamp.

See Hacks for information on how to enable the use of built-in variables.

Storage Saver

For devices equipped with SD cards, it is possible to store backups on SD cards to save space in internal storage.

  1. Tap Backup App Data.
  2. Add com.appmindlab.nano.pref_low_space_mode|true to ~neutrinote_settings_data.
  3. Tap Restore App Data.
  4. Future backups will be stored at /Android/data/com.appmindlab.nano/files/neutrinote_export under the SD card.

Notice that the backups will be automatically removed to reclaim storage space if neutriNote is uninstalled.

API

neutriNote’s Markdown engine is fully modular and swappable. If you are familar with compiler scripting and would like to integrate your own parser, you would need to use the following entry points in your code:

Methods Descriptions
init(document) Initialize the framework.
getData() Get raw content from a note.
prepare() Prepare for the rendering process.
setContent(html) Set view to rendering outcome.

Adopt this pattern of invoking neurtiNote in your script:

(function (){
  ////////////
  // Set up //
  ////////////
  neutriNote.init(document);

  //////////////////
  // Get raw data //
  //////////////////
  var str = neutriNote.getData();

  ///////////////////////////
  // Prepare for rendering //
  ///////////////////////////
  neutriNote.prepare();

  ///////////
  // Parse //
  ///////////
  
  ... <- Custom conversion logic goes here!

  /////////////////
  // Set content //
  /////////////////
  neutriNote.setContent(str)

})(window, document);

To illustrate, suppose you simply want to render everything in italics, all you need is to create ~neutrinote_script.txt and paste in the following code:

(function (){
  ////////////
  // Set up //
  ////////////
  neutriNote.init(document);

  //////////////////
  // Get raw data //
  //////////////////
  var str = neutriNote.getData();

  ///////////////////////////
  // Prepare for rendering //
  ///////////////////////////
  neutriNote.prepare();

  ///////////
  // Parse //
  ///////////
  str = '<i>' + str + '</i>';

  /////////////////
  // Set content //
  /////////////////
  neutriNote.setContent(str)

})(window, document);

Now go to your note and tap render to view the output of your custom parser.

More useful parsing can be achieved by following the same pattern. Take a look at this example of integrating org-mode into neutriNote.

To restore default PHP Markdown syntax, just remove ~neutrinote_script.txt.

Python Support (Experimental)

neutriNote can evaluate in-note Python code snippets. To enable this feature, simply set Python parsing flag to true as shown under Hacks section.

To see it in action, copy the code below and tap Markdown Preview button:

<script type="text/python">
    from browser import document
    document <= "Hello world !"
</script>

A slightly more complex example:

<script type="text/python">
    from browser import document

    # Sort a list
    aList = [5, 8, 7, 6, 2, 3]
    aList = sorted(aList)
    result = '\n'.join(str(i) for i in aList)

    # Print the output
    document <= result
</script>

(Note that the script tag is required to indicate the scope of Python code.)

Text Editor

Though outside the scope of note taking, neutriNote can be used as a lightweight text editor to supplement apps such as Dropbox or Google Drive across all folders. Changes committed will be sent back to original locations of edited files instead of storing in Local Repository, if the files are located outside Local Repository. (Note that files not stored in Local Repository will not be cataloged by neutriNote’s search engine.)

Snooze (Experimental)

With neutriNote’s non-intrusive visual reminders, it is easy to set aside notes for editing later, or build a habit of reviewing saved notes. Simply enable snooze animation by appending the following to ~neutrinote_settings_data:

com.appmindlab.nano.pref_icon_behavior|2

Then add special snooze strings such as +1h (“snooze for an hour”) or +2d (“snooze for two days”) to the metadata of selected notes. By doing so a non-intrusive animation will remind you to view the notes if they have not been visited long enough. The visual reminders would be dismissed as soon as the notes were opened. To de-activate the snooze, simply remove the snooze string from the note’s metadata.

Units Examples
m for minutes +30m: snooze for 30 minutes
h for hours +8h: snooze for 8 hours
d for days +3d: snooze for 3 days
w for weeks +2w: snooze for 2 weeks
M for months +3M: snooze for a quarter
y for years +10y: snooze for a decade

To transfer snooze to another device, be sure to tap Backup/Restore App Data. Even more useful is that snooze strings are also fully searchable, they work just like regular metadata!

Miscellaneous

neutriNote comes with many goodies for capturing text based data without switching away such as the built-in barcode scanner. Another is a handy calculator for solving mathematical expressions based on Math.js (network connection required). To see how that works, try one of the following examples in your notes:

  1. Select the expression.
  2. Tap the calculator button from the toolbar.
  3. View the answer with the option to paste it back into your note.
sin(45 deg) ^ 2

cos(45 deg)

5.08 cm to inch

det([-1, 2; 3, 1])

log(10000, 10)

Performance

When editing a long note, hide the title bar to reduce lags.

In general, using default font style can help reduce the time in opening long notes.

For users who do not use mathematics expressions, mathematics rendering can be disabled by entering a . under Mathematics in Settings. Markdown rendering should be faster with mathematics disabled.

Log Tool

neutriNote provides a simple log mechanism to monitor Local Repository changes caused externally. This is useful especially when cross-platform sync is in use. To activate logging, create a directory called log under Local Repository and add a file called ~neutrinote_sync.log (for devices equipped with SD cards, ~neutrinote_sync.log can instead be placed under /Android/data/com.appmindlab.nano/files/log). Once the log file is detected, recording of remotely initiated data changes, such as inserts, deletes, or in-place updates will take place automatically. Furthermore, log attributes such as sizes and recycle frequencies can be specified via pref_max_sync_log_file_age and pref_max_sync_log_file_size settings (see Hacks section).

Note that logging may have impacts on overall performance and battery consumption. Simply delete ~neutrinote_sync.log from log folder to stop logging.

Relocate Local Repository

While generally not recommended, there may come a time when Local Repository has to be relocated. Please handle the following steps with care:

  1. Backup ALL app settings and notes.
  2. For pre-Android 9 devices, copy Local Repository folder to its new location. For Android 9 or above, Local Repository can only be located anywhere under /Android/data/com.appmindlab.nano/files.
  3. Un-install neutriNote (or clear the app’s data under Android’s system settings).
  4. Re-install neutriNote.
  5. Point Local Repository to its new location.
  6. Restore app data.

Known Issues

Anytime a note is accessed from widget, if there is a note already being edited, the note originally being edited will exit without saving. neutriNote does not distinguish between opening a note from widget or from the note list, the currently opened note will be closed to make way for the newly opened note. It is thus highly recommended that important changes be saved right away.

If a note needs to be renamed, do so within neutriNote. Certain cloud sync would also change the case of note titles. neutriNote would detect those changes and be case insensitive accordingly. However, neutriNote would not delete notes unless their titles match exactly. Therefore it is so crucial that notes be renamed from the end of neutriNote.

To improve app stability in lower-end devices, neutriNote supports note size up to 1.5 MB. Notes beyond the size will automatically be moved to a folder called import_errors. To bring them back into neutriNote, you would need to split the notes into files below 1.5 MB and move them into the repository folder.

FAQs

No folder support? neutriNote is designed to provide a flat, hierarchy-free, “low cognitive load” note taking experience so that the number of taps can be minimized, folder navigation would require a nested UI and more taps to get to notes beyond the root level. On top of that, offline search would need to traverse levels of folders in such a way that turnaround time could vary perceivably. Metadata used together with custom filters provides more general organization than folders (a note can match multiple metadata simultaneously).

Story behind the name? This came up when trying to conjure up something that conveys unclutterness.

Privacy Policy

This app does not gather personal information. Location data can always be disabled via Settings. A menu option is also provided to clear search history.

TODO

Keep the app as crash-proof as possible.

About

Every effort has been made to ensure that all third-party software used be properly acknowledged (see license information in the About dialog). Please feel free to contact by email anytime should such information be found incomplete or inaccurate.

You can also visit Product Page for development updates regarding the app.

To further support neutriNote’s development, please visit developer’s Ko-fi page. .