Rather than manually exporting my book notes from Moon+ Reader and importing them into Obsidian, I'd like to automate the process. Readwise has an API that can be used for this purpose, that is supported by both Moon+ Reader and Obsidian, however I'd like to keep my data private. So this is a partial reimplementation of the Readwise API in Go, supporting just the endpoints I need.

1. Only a few of the endpoints are implemented.
2. Only a few of the fields are supported.
3. Only category "book" is supported.

Open any book and go to "Bookmarks". Click on the settings icon at the bottom and enable "Share new highlights and notes to Readwise automatically". In the settings, enter the Token and server URL.

I'm using my own fork of the the Obsidian Readwise (Community Plugin) to import my highlights into Obsidian: corani/obsidian-readwise. This allows to set the API server location in the settings and supports the "chapter" property for highlights.

You can install the plugin via BRAT.

The application includes a web-based user interface for browsing books and highlights. Access the UI at http://localhost:3123/ui/ (or your configured address).

• Browse all books in your library
• View highlights for any selected book
• Search and filter books and highlights
• Copy highlights to clipboard
• Edit highlights (text, note, chapter, and location)
• Delete highlights
• Responsive two-pane layout

The UI requires basic authentication. The default username is admin and the password is your API token (configured via the TOKEN environment variable). You can customize the username using the UI_USER environment variable.

To populate the database with sample books and highlights for testing, use the provided SQL script:

sqlite3 /tmp/unwise.db < scripts/init_test_data.sql

Run the following command:

$ ./build.sh -b
[INFO] Building unwise version dev/371e928027a8c9f03dccf5b59acd07640c52e4ea
[CMD ] go build -o bin/unwise ./cmd/unwise/
[TIME] took 0m0.186s

$ ./bin/unwise

16:13:41 INFO generated new token token=68ef286d-c71a-4225-aba4-1e4cd6633fc4

 ┌───────────────────────────────────────────────────┐
 │                   Fiber v2.51.0                   │
 │               http://127.0.0.1:3123               │
 │       (bound on host 0.0.0.0 and port 3123)       │
 │                                                   │
 │ Handlers ............ 10  Processes ........... 1 │
 │ Prefork ....... Disabled  PID ............. 28732 │
 └───────────────────────────────────────────────────┘

The following environment variables can be used to configure the server (you can also add them to a .env file):

Note: if you don't provide a TOKEN, the application will generate one and print it to the console during startup.

$ docker run --rm -it -p 3123:3123  \
    -e TOKEN=my-token               \
    ghcr.io/corani/unwise:latest

Or using docker compose:

$ docker-compose -f docker/docker-compose.yml up
...

I'm running the app behind Traefik, so I can use Let's Encrypt for SSL. Here is an example:

services:
  unwise:
    image: "ghcr.io/corani/unwise:latest"
    container_name: "unwise"
    user: "${MY_UID}:${MY_GID}"
    env_file:
      - "./unwise/unwise.env"
    volumes:
      - "./unwise/data:/data"
    restart: "unless-stopped"
    networks:
      - "proxy"
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      # Replace with your own domain name.
      - "traefik.http.routers.unwise.rule=Host(`unwise.example.com`)"
      # The 'websecure' entryPoint is basically your HTTPS entrypoint.
      - "traefik.http.routers.unwise.entrypoints=websecure"
      - "traefik.http.routers.unwise.service=unwise"
      - "traefik.http.services.unwise.loadbalancer.server.port=3123"
      - "traefik.http.routers.unwise.tls=true"
      # Replace the string 'letsencrypt' with your own certificate resolver
      - "traefik.http.routers.unwise.tls.certresolver=letsencrypt"
      - "traefik.http.routers.unwise.middlewares=unwisecors"
      # The part needed for CORS to work on Traefik 2.x starts here
      - "traefik.http.middlewares.unwisecors.headers.accesscontrolallowmethods=GET,PUT,POST,HEAD,DELETE"
      - "traefik.http.middlewares.unwisecors.headers.accesscontrolallowheaders=accept,authorization,content-type,origin,referer"
      - "traefik.http.middlewares.unwisecors.headers.accesscontrolalloworiginlist=app://obsidian.md,capacitor://localhost,http://localhost"
      - "traefik.http.middlewares.unwisecors.headers.accesscontrolmaxage=3600"
      - "traefik.http.middlewares.unwisecors.headers.addvaryheader=true"
      - "traefik.http.middlewares.unwisecors.headers.accessControlAllowCredentials=true"

The application uses a local SQLite database (/data/unwise.db) to persist the data.