NAME

simplenotesync

VERSION

version 0.2.1

SYNOPSIS

simplenotesync [options] [pathname]

Options:
  --help     -h           brief help message
  --man                   full documentation
  --version -v            display program and library version
  --debug   -d            write debug output to a logfile in current dir
  --quiet   -q            log nothing
  --email                 email used for simplenote account
  --password              password used for simplenote account
  --no_server_updates     don't modify notes on server
  --no_local_updates      don't modify notes locally
  --edit                  edit a note, preserving xattrs
  --editor                override $ENV{EDITOR}

 [pathname] is the local notes folder to syncronise with. Defaults to $HOME/Notes.
 
 Everything is optional and can be specified in the config file. See manual.

DESCRIPTION

simplenotesync provides bidirectional synchronization between the http://simplenoteapp.com// website and a local directory of text files on your computer

WARNING

Please note that this software is still in development stages --- I STRONGLY urge you to backup all of your data before running to ensure nothing is lost. If you run simplenotesync on an empty local folder without the net result will be to copy the remote notes to the local folder, effectively performing a backup.

CONFIGURATION

TODO x-platform!

simplenotesync can optionally use a config file. Create a file called simplenotesync.ini in your config dir, usually ~/.config.

It is an ini file, supporting the following keys:

email, password, notes_dir, no_server_updates, no_local_updates, editor

KNOWN ISSUES

  • No merging when both local and remote file are changed between syncs - this might be enabled in the future

  • Renaming a note filename, then changing the contents remotely, will result in two copies of the same note. Also, chaging the notes title remotely will cause it to be downloaded with again with the new name.

    For now, you'll have to manually delete the old copy

  • Certain characters are prohibited in filenames (:,\,/) - if present in the title, they are stripped out.

  • Simplenote supports multiple notes with the same title, but two files cannot share the same filename. If you have two notes with the same title, only one will be downloaded. I suggest changing the title of the other note.

FAQ

Why can I download notes from Simplenote, but local notes aren't being uploaded?

Do the text files end in .txt or .mkdn? These are currently the only two extensions considered.

Text files can't be located in subdirectories - this script does not (by design) recurse folders looking for files (since they shouldn't be anywhere but the specified directory).

TROUBLESHOOTING

Running with --debug will put a log in the current directory with lots of useful information. If your filing a bug report, I'd like to see that log!

You can disable writing changes to either the local directory or to the Simplenote web server with "--no_local_updates and --no_remote_updates to protect your data.

SEE ALSO

Designed for use with Simplenote:

<http://www.simplenoteapp.com/>

Based on SimplenoteSync:

<http://fletcherpenney.net/other_projects/simplenotesync/>

AUTHORS

  • Ioan Rogers <ioanr@cpan.org>

  • Fletcher T. Penney <owner@fletcherpenney.net>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2021 by Ioan Rogers.

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991

BUGS AND LIMITATIONS

You can make new bug reports, and view existing ones, through the web interface at https://github.com/ioanrogers/App-SimplenoteSync/issues.

SOURCE

The development version is on github at https://github.com/ioanrogers/App-SimplenoteSync and may be cloned from git://github.com/ioanrogers/App-SimplenoteSync.git