{"id":17026252,"url":"https://github.com/kevboh/note-server","last_synced_at":"2026-05-03T16:33:47.761Z","repository":{"id":143161211,"uuid":"141072502","full_name":"kevboh/note-server","owner":"kevboh","description":"Put your notes in your new tabs! Maybe!","archived":false,"fork":false,"pushed_at":"2018-07-16T11:41:23.000Z","size":234,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-22T19:15:33.490Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kevboh.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-07-16T01:37:18.000Z","updated_at":"2023-01-05T07:47:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"a51ba3f6-005c-4215-85e7-b5e4601bd8bb","html_url":"https://github.com/kevboh/note-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kevboh/note-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fnote-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fnote-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fnote-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fnote-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kevboh","download_url":"https://codeload.github.com/kevboh/note-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kevboh%2Fnote-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32577122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":"2024-10-14T07:31:21.176Z","updated_at":"2026-05-03T16:33:47.742Z","avatar_url":"https://github.com/kevboh.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A note server\n\n![An example of a note in a browser tab](/img/note-example.png)\n\n\u003cblockquote class=\"twitter-tweet\" data-lang=\"en\"\u003e\u003cp lang=\"en\" dir=\"ltr\"\u003eI have been meaning to do this FOREVER and I finally did: a local service that populates new browser tabs with random selections from my very large database of notes. The idea is to keep the stew circulating. Aerate the deeper layers. Maybe it will drive me mad. We\u0026#39;ll see. \u003ca href=\"https://t.co/t6c9JT5uju\"\u003epic.twitter.com/t6c9JT5uju\u003c/a\u003e\u003c/p\u003e\u0026mdash; Robin Sloan (@robinsloan) \u003ca href=\"https://twitter.com/robinsloan/status/1017202162219143168?ref_src=twsrc%5Etfw\"\u003eJuly 12, 2018\u003c/a\u003e\u003c/blockquote\u003e\n\nHere, you'll find the hacky work of an afternoon packaged up for macOS and... odds are good you *won't* be able to get it to run on your computer! I'm sharing this only in the spirit of not _totally_ hogging the code for myself.\n\nIf you want to give it a shot, here's what you should do.\n\nFirst, clone this project, install the requirements, and tell your computer it's okay to run the script that launches the server.\n\n```\ngit clone https://github.com/robinsloan/note-server\ncd note-server\ngem install rack\ngem install bundler\nbundle install\nchmod +x serve_note_server.sh\n```\n\nNow, get your notes together in however many directories you desire. The two supported formats are:\n\n1. a bunch of plain text files, each containing the text of one note, and\n2. one or more YAML files, each containing one unnamed array with one note per line.\n\nNext, specify the paths to those directories in `directories.yml`. I'm using relative paths that point to subdirectories within the `notes-server` directory, but you can point elsewhere if you prefer, e.g. `/Users/robin/Documents/All\\ My\\ Thoughts\\ And\\ Feelings/` or `~/Dropbox/my_directory_full_of_notes/`\n\n**Here is a fiddly but important step.**\n\nStill in the directory that contains this project, find its absolute path on your particular computer:\n\n```\npwd\n```\n\nThen, open the file `com.robinsloan.note_server.plist` with a text editor and replace the string `PATH_TO_NOTE_SERVER_DIRECTORY_HERE` with the absolute path you just printed out.\n\n**This has been the fiddly but important step.**\n\nHaving fiddled with that successfully, you can register the ✨LaunchAgent✨ that will automatically start this server when you log into your computer:\n\n```\nbash install.sh\n```\n\nAfter you restart, you should be able to reach this server at `http://localhost:9988` in your browser and see that it loads a random note each time you visit. If that's not the case... whew, I don't even know.\n\nIf it *is* the case, that's fine, but the idea here is to encounter these snippets of text whenever you create a new tab. Here's how to set that up.\n\n* If you're using Safari, go to Preferences \u003e General and set new tabs to open with a Homepage, which you'll specify as `http://localhost:9988`.\n* If you're using Chrome, install the [New Tab Redirect extension](https://chrome.google.com/webstore/detail/new-tab-redirect/icpgjfneehieebagbmdbhnlpiopdcmna) and, in its preferences, specify the URL as `http://localhost:9988`. **Importantly,** also check the \"Always update tab\" option or I guarantee it will drive you insane.\n\nThat's it! Good luck!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevboh%2Fnote-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkevboh%2Fnote-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkevboh%2Fnote-server/lists"}