/Bookmark-Manager_TIL-Journal-Memo_2ndBrain_chuanqisun_osmoscraft-osmosmemo

Turn GitHub into a bookmark manager. A personal knowledge base, a Today I Learned (TIL) journal, A Second brain. Automated with osmos::memo (https://osmoscraft.org/). (( Keywords: knowledgebase til foam zettelkasten roam digitalgarden ))

Primary LanguageTypeScriptMIT LicenseMIT

image

osmos::memo

A browser bookmark manager optimized for capture and retrieval speed.

  • Extract page title and url into a short markdown snippet.
  • One-click to insert the snippet to README.md hosted on GitHub.
  • Add new tags or reuse the ones from previous snippets.
  • Instant search from snippets with the "find on page" utility built into browsers.

Screenshot

image

My memo since 2018 image

Get started

Install

Connect to GitHub

  • When you active the extension from browser toolbar for the 1st time, click the button to connect to GitHub.
    image
  • Provide your GitHub username and repo.
    • If you don't have a repo yet, it's easiest to create from the template.
    • You can set the visibility of your repo to either Public or Private. The extension works in both cases.
  • Create a new personal access token for the extension to add content on behalf of you. Make sure you select the repo scope.
    image
  • Use README.md as the storage filename. Other filenames work too but GitHub will not automatically render it as the home page for your repo.
  • Click Connect and make sure you get a success message.
    image
  • Now navigate to any page and re-open the extension. You will be able to save new content.
    image

Contributions

My current focus is to bring the entire osmos::craft project online. Until then, I have no bandwidth for new feature requests or PRs. However, issues and bug reports are always welcome. I'll keep track of issues and address them once I have more time. Thank your for being patient.

FAQ

How to open the extension with keyboard shortcut?

By the default, Alt+Shift+D opens the extension. You can customize it with browser extensions settings.

  • Chrome and Edge: visit chrome://extensions/shortcuts
  • Firefox: visit about:addons as shown in this video.

How long does it take for a new release to reach my browser?

  • Firefox: from a couple hours to a day
  • Chrome: 1-3 days

Ecosystem

osmos::memo is part of the osmos::craft ecosystem. If you enjoy this tool, you might also like:

  • osmos::feed: A web-based RSS reader running entirely from your GitHub repo.
  • osmos::note: A web-based text editor for networked note-taking, self-hostable on any Git repository.