https://github.com/karlicoss/hypexport

Export/access your Hypothes.is data: annotations and profile info
https://github.com/karlicoss/hypexport

backup data-liberation export hypothesis takeout

Last synced: about 1 month ago
JSON representation

Export/access your Hypothes.is data: annotations and profile info

• Host: GitHub
• URL: https://github.com/karlicoss/hypexport
• Owner: karlicoss
• License: mit
• Created: 2019-09-23T00:41:37.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-03-13T01:01:34.000Z (9 months ago)
• Last Synced: 2024-08-02T12:44:52.891Z (4 months ago)
• Topics: backup, data-liberation, export, hypothesis, takeout
• Language: Python
• Homepage:
• Size: 42 KB
• Stars: 38
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - karlicoss/hypexport - Export/access your Hypothes.is data: annotations and profile info (others)

README

        
#+begin_src python :dir src :results drawer :exports results

import hypexport.export as E; return E.make_parser().prog

#+end_src

#+RESULTS:

:results:

Export/takeout for your personal [[https://hypothes.is][Hypothes.is]] data: annotations and profile information.

:end:

* Setting up

1. The easiest way is =pip3 install --user git+https://github.com/karlicoss/hypexport=.

   Alternatively, use =git clone --recursive=, or =git pull && git submodules update --init=. After that, you can use =pip3 install --editable=.

2. Follow [[https://hypothes.is/account/developer][these]] instructions to set up the token

* Exporting

#+begin_src python :dir src :results drawer :exports results

import hypexport.export as E; return E.make_parser().epilog

#+end_src

#+RESULTS:

:results:

Usage:

*Recommended*: create =secrets.py= keeping your api parameters, e.g.:

: username = "USERNAME"

: token = "TOKEN"

After that, use:

: python3 -m hypexport.export --secrets /path/to/secrets.py

That way you type less and have control over where you keep your plaintext secrets.

*Alternatively*, you can pass parameters directly, e.g.

: python3 -m hypexport.export --username  --token 

However, this is verbose and prone to leaking your keys/tokens/passwords in shell history.

You can also import ~hypexport.export~ as a module and call ~get_json~ function directly to get raw JSON.

I *highly* recommend checking exported files at least once just to make sure they contain everything you expect from your export. If not, please feel free to ask or raise an issue!

:end:

# TODO FIXME api limitations 10000 annotations?