kayw / osmosmemo

Turn GitHub into a bookmark manager

Home Page:https://osmoscraft.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

image

About This Fork

What Modified

  • load files and tags from pre-generated manifest.json
  • support select which file to save links
  • support select page text to save (only work in chrome)

What ToDo

  1. improve extension debug experience
  1. improve ui/ux with a SPA framework

  2. use single div to get rid of popup.html iframe usage in content_script

  3. fix browser.tabs undefined in firefox (call it only in background.js)

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: visit chrome://extensions/shortcuts
  • Edge: visit edge://extensions/shortcuts
  • Firefox: visit about:addons as shown in this video.

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.

About

Turn GitHub into a bookmark manager

https://osmoscraft.org

License:MIT License


Languages

Language:TypeScript 74.9%Language:HTML 12.5%Language:CSS 8.0%Language:JavaScript 4.6%