Skip to content
/ markob Public

Highlight your text and send it to your Obsidian vault. It automatically creates you a file with the name of the page.

License

Notifications You must be signed in to change notification settings

Rooyca/markob

Repository files navigation

markob - Web Highlighter for Obsidian

Docker image

While reading your favorite articles you can highlight your texts and send them to your Obsidian vault and it will automatically create a file with the name of the page. Saving what interests you has never been easier*.

highlighter

Extension Installation

Firefox

Firefox Browser Addons

  1. Go to Firefox browser addons
  2. Install the extension

Manual Installation

  1. Download the latest version from here
  2. Open about:debugging in Firefox
  3. Click on "This Firefox"
  4. Click on "Load Temporary Add-on"
  5. Select the Install.zip file

Running the server

Enviorment variables

Variable Description Default
OBSIDIAN_PATH Path to your Obsidian vault /code/obsi/
  • Befor running the server make sure you export the OBSIDIAN_PATH variable by running export OBSIDIAN_PATH=/path/to/your/obsidian/vault.

PIP

  1. Install the package
pip install markob
  1. Run the server
markob

Docker

If you dont have docker installed go here and follow the instructions.

  1. Pull the image
docker pull ghcr.io/rooyca/markob:main
  1. Run the image
docker run --rm -p 8888:8888 rooyca/markob:main

Where /home/USER/Documents/Obsidian/Highlights/ is the path to your Obsidian vault. Make sure to create your Highlights folder in your vault.

It's that simple!

Docker build

If you want to build the docker image yourself you can do it by:

  1. Clone the repo
git clone https://github.com/Rooyca/MarkOb
  1. Build the image
docker build -t markob .
  1. Run the image
docker run --rm -p 8888:8888 markob

Binary

Download the latest binary from the release page, make it executable and run it.

chmod +x markob.bin
./markob

Python (FastAPI Version)

  1. Clone the repo
git clone https://github.com/Rooyca/MarkOb
  1. Install the requirements
pip install -r requirements.txt
  1. Run the api
uvicorn server/server.old:app --bind 8888

Python (http.server Version)

  1. Clone the repo
git clone https://github.com/Rooyca/MarkOb
  1. Run the server
python server/server.py

Usage

  1. Highlight some text
  2. Right click on the text
  3. Select the option you want

You can also use the keyboard shortcuts:

  • ALT + J to send the highlighted text to Obsidian.
  • ALT + K to send the highlighted text + Tags.
  • ALT + L to send the highlighted text + Note.
  • ALT + P to send the highlighted text + Tags and a note.

Contributing

All contributions are welcome! If you find a bug or have a suggestion please open an issue. If you want to contribute code please open a pull request.