{"id":13435061,"url":"https://github.com/tannercollin/standardnotes-fs","last_synced_at":"2025-03-18T02:30:51.614Z","repository":{"id":50820802,"uuid":"107294098","full_name":"tannercollin/standardnotes-fs","owner":"tannercollin","description":"Mount your Standard Notes as a filesystem.","archived":true,"fork":false,"pushed_at":"2021-12-15T21:32:28.000Z","size":103,"stargazers_count":149,"open_issues_count":2,"forks_count":12,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-04T21:37:48.185Z","etag":null,"topics":["encrypted","fuse","fusepy","notes","secure","standard-file","standard-notes","standardnotes"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tannercollin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-17T16:16:12.000Z","updated_at":"2025-01-04T12:43:12.000Z","dependencies_parsed_at":"2022-09-12T09:21:28.800Z","dependency_job_id":null,"html_url":"https://github.com/tannercollin/standardnotes-fs","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tannercollin%2Fstandardnotes-fs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tannercollin%2Fstandardnotes-fs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tannercollin%2Fstandardnotes-fs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tannercollin%2Fstandardnotes-fs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tannercollin","download_url":"https://codeload.github.com/tannercollin/standardnotes-fs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244143894,"owners_count":20405294,"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","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":["encrypted","fuse","fusepy","notes","secure","standard-file","standard-notes","standardnotes"],"created_at":"2024-07-31T03:00:31.805Z","updated_at":"2025-03-18T02:30:51.335Z","avatar_url":"https://github.com/tannercollin.png","language":"Python","readme":"# standardnotes-fs\n\n:warning: **Project archived**: Due to changes in the Standard Notes API and encryption, this program will no longer work.\n\n## Description\nMount your [Standard Notes](https://standardnotes.org/) account as a filesystem and edit your notes as plain text files.\n\nThis allows you to edit your notes in your favorite text editor, use standard \\*nix programs and Bash scripts to manipulate them, or back them up with rsync.\n\nThis is an _unofficial_ Standard Notes client.\n\n**Important:** standardnotes-fs only works with protocol version 003 accounts. It's unlikely I'll add 004 support, so don't upgrade your account if you want to use this.\n\n## Example\n\n```text\n$ snfs notes/\nPlease enter your Standard Notes username: tanner@example.com\nPlease enter your password (hidden): \nEnter your two-factor authentication code: 123456\n\n$ tree --dirsfirst notes/\n/home/tanner/notes\n├── archived\n│   └── old_notes.txt\n├── tags\n│   ├── lists\n│   │   ├── Shopping.txt\n│   │   └── Todo.txt\n│   └── projects\n│       └── standardnotes-fs.txt\n├── trash\n│   ├── loveletter.txt\n│   └── renovations.txt\n├── Accounts.txt\n├── Books.txt\n├── Checklists.txt\n├── Shopping.txt\n├── standardnotes-fs.txt\n├── Todo.txt\n└── Wifi.txt\n5 directories, 13 files\n\n$ cat notes/Todo.txt\nV Get groceries\nV Laundry\nX Replace kitchen light\nO Write standardnotes-fs readme\nO Release standardnotes-fs\n\n# Editing:\n$ vim notes/Shopping.txt\n$ vim notes/tags/lists/Todo.txt\n\n# Tags:\n$ mv notes/Checklists.txt notes/tags/lists/\n$ rm notes/tags/projects/standardnotes-fs.txt\n\n$ rsync -Wa notes/ notes_backup/\n```\n\n### When finished\n\nUnmount the directory:\n```text\n$ snfs -u notes/\n```\n\nLogout to switch accounts:\n```text\n$ snfs --logout\n```\n\n## Usage\n```text\nusage: snfs [-h] [--username USERNAME] [--password PASSWORD]\n            [-v] [--foreground] [--sync-sec SYNC_SEC]\n            [--sync-url SYNC_URL] [--ext EXT]\n            [--no-config-files] [--config CONFIG]\n            [--creds CREDS] [--allow-other] [--logout] [-u]\n            [mountpoint]\n\npositional arguments:\n  mountpoint           local mountpoint folder\n\noptional arguments:\n  -h, --help           show this help message and exit\n  --username USERNAME  Standard Notes username to log in with\n  --password PASSWORD  Standard Notes password to log in with\n                       NOTE: It is NOT recommended to use this option!\n                             The password may be stored in history, so\n                             use the password prompt instead.\n  -v, --verbosity      output verbosity -v or -vv (implies --foreground)\n  --foreground         run standardnotes-fs in the foreground\n  --sync-sec SYNC_SEC  how many seconds between each sync. Default: 30\n  --sync-url SYNC_URL  URL of Standard File sync server. Defaults to:\n                       https://sync.standardnotes.org\n  --ext EXT            file extension to add to note titles. Default: .txt\n  --no-config-files    don't load or create config / cred files\n  --config CONFIG      specify a config file location. Defaults to:\n                       /home/tanner/.config/standardnotes-fs/standardnotes-fs.conf\n  --creds CREDS        specify a credentials file location. Defaults to:\n                       /home/tanner/.cache/standardnotes-fs/standardnotes-fs.conf\n  --allow-other        allow other system users access\n  --logout             remove config files and user credentials\n  -u, --unmount        unmount [mountpoint] folder\n\n```\n\n## Installation\n### For Debian/Ubuntu based systems\n\nInstall dependencies:\n```text\n$ sudo apt install fuse python3 python3-pip\n```\n\n#### With Sudo\n\nInstall standardnotes-fs and login:\n```text\n$ sudo pip3 install --upgrade git+https://github.com/tannercollin/standardnotes-fs\n$ snfs ~/notes\nPlease enter your Standard Notes username: tanner@example.com\nPlease enter your password (hidden): \n```\n\n#### Without Sudo\n\nInstall standardnotes-fs and login:\n```text\n$ pip3 install --user --upgrade git+https://github.com/tannercollin/standardnotes-fs\n$ python3 -m snfs ~/notes\nPlease enter your Standard Notes username: tanner@example.com\nPlease enter your password (hidden): \n```\n\nNote: if you don't want to use the `python -m` prefix, you'll need to add python's local bin directory to your `$PATH`.\n\n### For OS X systems\n\nInstall dependencies:\n\nhttps://osxfuse.github.io/\n```text\n$ brew install python3\n```\n\nInstall standardnotes-fs and login:\n```text\n$ pip3 install --upgrade git+https://github.com/tannercollin/standardnotes-fs\n$ snfs ~/notes\nPlease enter your Standard Notes username: tanner@example.com\nPlease enter your password (hidden): \n```\n\n## Notes\n* Important: standardnotes-fs has not been tested vigorously yet. Before you use it, please make a backup of your notes by selecting `Account \u003e Download Data Archive` in the official Standard Notes client.\n* Your account password is not stored and the Python variable is deleted after your encryption keys are generated with it.\n* Your account's encryption keys are stored in a config file on disk. This can be disabled with `--no-config-file`.\n* By default the client syncs with the Standard Notes server every 30 seconds and after any note modifications are saved.\n* If connection to the server is lost, it will keep trying to sync periodically.\n* Creating hidden files (names beginning with a period) is disabled to prevent junk file creation.\n* Notes with identical names are deduplicated by adding a number to the end.\n* On the filesystem, notes will have the '.txt' extension appended to their name. Change this with the `--ext` argument. Example: `--ext '.md'`.\n* neovim/nvim users have had errors about nvim being \"unable to create backup file\" when writing. This is a bug with neovim. Executing `mkdir ~/.local/share/nvim/backup` might fix it.\n\n## Development\n\nInstall dependencies:\n```text\n$ sudo apt install fuse python3 python3-pip python-virtualenv python3-virtualenv\n$ sudo python3 -m pip install --upgrade setuptools\n```\n\nClone repo, create a venv, activate it, and install:\n```text\n$ git clone https://github.com/tannercollin/standardnotes-fs.git\n$ cd standardnotes-fs\n$ virtualenv -p python3 env\n$ . env/bin/activate\n(env) $ pip install --upgrade --no-cache-dir .\n```\n\nStandardnotes-fs is now installed in the virtual environment. Run it:\n```text\n(env) $ mkdir test\n(env) $ snfs -vv --no-config-file --username standardnotes-fs@domain.com --password testaccount test/\n```\n\nExit with ctrl-c or unmount as instructed above.\n\nTo make changes, edit the files and re-install it with pip:\n```text\n(env) $ vim standardnotes_fs/standardnotes_fs.py\n(env) $ pip install --upgrade .\n```\n\nIt's now ready to be ran again with your changes.\n\n## License\nThis program is free and open-source software licensed under the GNU GPLv3. Please see the `LICENSE` file for details.\n\nThat means you have the right to study, change, and distribute the software and source code to anyone and for any purpose as long as you grant the same rights when distributing it. You deserve these rights. Please take advantage of them because I like pull requests and would love to see this code put to use.\n\n## Acknowledgements\nThanks to all the devs behind Standard Notes, Udia, Python, libfuse and FUSE.\n","funding_links":[],"categories":["Tools","Python","HarmonyOS"],"sub_categories":["Command Line","Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftannercollin%2Fstandardnotes-fs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftannercollin%2Fstandardnotes-fs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftannercollin%2Fstandardnotes-fs/lists"}