{"id":31923673,"url":"https://github.com/fletcher/simplenotesync","last_synced_at":"2025-10-13T23:56:20.867Z","repository":{"id":666299,"uuid":"309435","full_name":"fletcher/SimplenoteSync","owner":"fletcher","description":"perl routine to sync folder of text files with your notes on Simplenote","archived":false,"fork":false,"pushed_at":"2016-12-17T05:02:40.000Z","size":107,"stargazers_count":58,"open_issues_count":1,"forks_count":7,"subscribers_count":7,"default_branch":"master","last_synced_at":"2023-04-18T19:50:37.804Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://fletcherpenney.net/other_projects/simplenotesync/","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fletcher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2009-09-17T03:15:13.000Z","updated_at":"2023-04-18T19:50:37.805Z","dependencies_parsed_at":"2022-08-16T10:35:25.986Z","dependency_job_id":null,"html_url":"https://github.com/fletcher/SimplenoteSync","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/fletcher/SimplenoteSync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fletcher%2FSimplenoteSync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fletcher%2FSimplenoteSync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fletcher%2FSimplenoteSync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fletcher%2FSimplenoteSync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fletcher","download_url":"https://codeload.github.com/fletcher/SimplenoteSync/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fletcher%2FSimplenoteSync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279017193,"owners_count":26086017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-13T23:55:44.232Z","updated_at":"2025-10-13T23:56:20.861Z","avatar_url":"https://github.com/fletcher.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Name #\n\nSimplenoteSync.pl --- synchronize a folder of text files with\nSimplenote.\n\nOf note, this software is not created by or endorsed by Cloud Factory,\nthe creators of Simplenote, or anyone else for that matter.\n\n\n# Configuration #\n\n**UPDATE** --- Notational Velocity now has built in synchronizing with\nSimplenote. I have not fully tested it, and can't vouch for or against it's\nquality. But, for anyone who is using Simplenotesync just so that their NV\nnotes and Simplenotes stay in sync, it is probably a *much* easier way to\naccomplish this. Most of the support questions I get are from people who are\nnot very experienced with the command-line --- Notational Velocity's built in\nsupport requires nothing more than your Simplenote user name and password.\nAdditionally, I am now primarily using WriteRoom, and am not actively working\non SimplenoteSync anymore. For more information, please visit:\n\n\u003chttp://fletcherpenney.net/2010/01/status_update_on_simplenotesync\u003e\n\n**WARNING --- I am having an intermittent problem with the Simplenote server\nthat causes files to be deleted intermittently. Please use with caution and\nbackup your data**\n\n**BACKUP YOUR DATA BEFORE USING --- THIS PROJECT IS STILL BEING TESTED.\nIF YOU AREN'T CONFIDENT IN WHAT YOU'RE DOING, DON'T USE IT!!!!**\n\nCreate file in your home directory named \".simplenotesyncrc\" with the\nfollowing contents:\n\n1. First line is your email address\n\n2. Second line is your Simplenote password\n\n3. Third line is the directory to be used for text files\n\n4. Fourth (optional line) is a file extension to use (defaults to \"txt\"\nif none specified)\n\nUnfortunately, you have to install Crypt::SSLeay to get https to work.\nYou can do this by running the following command as an administrator:\n\n\tsudo perl -MCPAN -e \"install Crypt::SSLeay\"\n\n\n# Description #\n\nAfter specifying a folder to store local text files, and the email\naddress and password associated with your Simplenote account,\nSimplenoteSync will attempt to synchronize the information in both\nplaces.\n\nSync information is stored in \"simplenotesync.db\". If this file is lost,\nSimplenoteSync will have to attempt to look for \"collisions\" between\nlocal files and existing notes. When performing the first\nsynchronization, it's best to start with an empty local folder (or an\nempty collection of notes on Simplenote), and then start adding files\n(or notes) afterwards.\n\n\n# Warning #\n\nPlease note that this software is still in development stages --- I\nSTRONGLY urge you to backup all of your data before running to ensure\nnothing is lost. If you run SimplenoteSync on an empty local folder\nwithout a \"simplenotesync.db\" file, the net result will be to copy the\nremote notes to the local folder, effectively performing a backup.\n\n\n# Installation #\n\nDownload the latest copy of SimplenoteSync.pl from github:\n\n\u003chttp://github.com/fletcher/SimplenoteSync\u003e\n\n\n# Features #\n\n* Bidirectional synchronization between the Simplenote web site and a\nlocal directory of text files on your computer\n\n* Ability to upload notes to your iPhone without typing them by hand\n\n* Ability to backup the notes on your iPhone\n\n* Perform synchronizations automatically by using cron\n\n* Should handle unicode characters in title and content (works for me in\nsome basic tests, but let me know if you have trouble)\n\n* The ability to manipulate your notes (via the local text files) using\nother applications (e.g. [Notational Velocity](http://notational.net/)\nif you use \"Plain Text Files\" for storage, shell scripts, AppleScript,\n[TaskPaper](http://www.hogbaysoftware.com/products/taskpaper), etc.) -\nyou're limited only by your imagination\n\n* COMING SOON --- The ability to attempt to merge changes if a note is\nchanged locally and on the server simultaneously\n\n\n# Limitations #\n\n* Certain characters are prohibited in filenames (:,\\,/) - if present in\nthe title, they are stripped out.\n\n* If the simplenotesync.db file is lost, SimplenoteSync.pl is currently\nunable to realize that a text file and a note represent the same object\n--- instead you should move your local text files, do a fresh sync to\ndownload all notes locally, and manually replace any missing notes.\n\n* Simplenote supports multiple notes with the same title, but two files\ncannot share the same filename. If you have two notes with the same\ntitle, only one will be downloaded. I suggest changing the title of the\nother note.\n\n\n# Faq #\n\n* When I try to use SimplenoteSync, I get the following error:\n\n\t\tNetwork: get token\n\t\tError logging into Simplenote server:\n\t\tHTTP::Response=HASH(0x1009b0110)-\u003econtent\n\n\tThe only time I have seen this error is when the username or\n\tpassword is entered into the configuration file incorrectly. Watch\n\tout for spaces at the end of lines.\n\n* Why can I download notes from Simplenote, but local notes aren't being\nuploaded?\n\n\tDo the text files end in \".txt\"? For documents to be recognized as\n\ttext files to be uploaded, they have to have that file extension.\n\t*Unless* you have specified an alternate file extension to use in\n\t\".simplenotesyncrc\".\n\n\tText files can't be located in subdirectories - this script does not\n\t(by design) recurse folders looking for files (since they shouldn't\n\tbe anywhere but the specified directory).\n\n* When my note is downloaded from Simplenote and then changed locally, I\nend up with two copies of the first line (one shorter than the other) -\nwhat gives?\n\n\tIf the first line of a note is too long to become the filename, it\n\tis trimmed to an appropriate length. To prevent losing data, the\n\tfull line is preserved in the body. Since Simplenote doesn't have a\n\tconcept of titles, the title becomes the first line (which is\n\ttrimmed), and the original first line is now the third line\n\t(counting the blank line in between). Your only alternatives are to\n\tshorten the first line, split it in two, or to create a short title\n\n* If I rename a note, what happens?\n\n\tIf you rename a note on Simplenote by changing the first line, a new\n\ttext file will be created and the old one will be deleted,\n\tpreserving the original creation date. If you rename a text file\n\tlocally, the old note on Simplenote will be deleted and a new one\n\twill be created, again preserving the original creation date. In the\n\tsecond instance, there is not actually any recognition of a \"rename\"\n\tgoing on - simply the recognition that an old note was deleted and a\n\tnew one exists.\n\n\n# Troubleshooting #\n\nIf SimplenoteSync isn't working, I've tried to add more (and better)\nerror messages. Common problems so far include:\n\n* Not installing Crypt::SSLeay\n\n* Errors in the \"simplenotesyncrc\" file\n\nOptionally, you can enable or disable writing changes to either the\nlocal directory or to the Simplenote web server. For example, if you\nwant to attempt to copy files to your computer without risking your\nremote data, you can disable \"$allow_server_updates\". Or, you can\ndisable \"$allow_local_updates\" to protect your local data.\n\nAdditionally, there is a script \"Debug.pl\" that will generate a text\nfile with some useful information to email to me if you continue to have\ntrouble.\n\n\n# Known Issues #\n\n* No merging when both local and remote file are changed between syncs -\nthis might be enabled in the future\n\n* the code is still somewhat ugly\n\n* it's probably not very efficient and might really bog down with large\nnumbers of notes\n\n* renaming notes or text files causes it to be treated as a new note -\nprobably not all bad, but not sure what else to do. For now, you'll have\nto manually delete the old copy\n\n\n# See Also #\n\nDesigned for use with Simplenote for iPhone:\n\n\u003chttp://www.simplenoteapp.com/\u003e\n\nThe SimplenoteSync homepage is:\n\n\u003chttp://fletcherpenney.net/other_projects/simplenotesync/\u003e\n\nSimplenoteSync is available on github:\n\n\u003chttp://github.com/fletcher/SimplenoteSync\u003e\n\nA Discussion list is also available:\n\n\u003chttp://groups.google.com/group/simplenotesync\u003e\n\n\n# Author #\n\nFletcher T. Penney, \u003cowner@fletcherpenney.net\u003e\n\n\n# Copyright And License #\n\nCopyright (C) 2009 by Fletcher T. Penney\n\nThis program is free software; you can redistribute it and/or modify it\nunder the terms of the GNU General Public License as published by the\nFree Software Foundation; either version 2 of the License, or (at your\noption) any later version.\n\nThis program is distributed in the hope that it will be useful, but\nWITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General\nPublic License for more details.\n\nYou should have received a copy of the GNU General Public License along\nwith this program; if not, write to the Free Software Foundation, Inc.\n59 Temple Place, Suite 330 Boston, MA 02111-1307 USA\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffletcher%2Fsimplenotesync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffletcher%2Fsimplenotesync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffletcher%2Fsimplenotesync/lists"}