Skip to content

Standalone demo v0.2.0 (experimental) [superseded]

Pre-release
Pre-release

Choose a tag to compare

@dsblank dsblank released this 14 Aug 23:59

Gramps Connect -- standalone demo (experimental)

A single downloadable app to try out this project -- no separate install, server, or database setup. Starts with an empty tree; import your own Gramps XML (.gramps) or GEDCOM (.ged) file via the app's own Family Trees -> Import... screen once it's running.

This is an early-stage research prototype, not a finished product. See the main README for what this project actually is.

Log in as admin / admin once it's running.

Windows

  1. Download gramps-connect-demo-windows.zip below and unzip it (right-click -> Extract All).
  2. Open the extracted folder and double-click gramps-connect-demo.exe.
  3. Windows will likely show a SmartScreen warning ("Windows protected your PC") because this isn't a signed executable. Click More info, then Run anyway.
  4. A browser tab should open automatically to http://127.0.0.1:5050. If it doesn't, open that address yourself.

macOS

  1. Download gramps-connect-demo-macos.zip below and unzip it (double-click, or right-click -> Open, depending on your Mac's settings).
  2. Open a Terminal, cd into the extracted folder, and run ./gramps-connect-demo.
    • Double-clicking the executable directly from Finder will likely be blocked by Gatekeeper ("cannot be opened because the developer cannot be verified") since it isn't signed/notarized -- running it from Terminal avoids that dialog, or you can right-click the file -> Open -> Open Anyway if you'd rather not use Terminal.
  3. A browser tab should open automatically to http://127.0.0.1:5050. If it doesn't, open that address yourself.

Linux

  1. Download gramps-connect-demo-linux.zip below and unzip it.
  2. Open a terminal, cd into the extracted folder, and run ./gramps-connect-demo.
  3. A browser tab should open automatically to http://127.0.0.1:5050. If it doesn't, open that address yourself.

Notes

  • First run creates a small data directory in your home folder (.gramps-connect-demo) with an empty tree. Later runs reuse it. Delete that folder to reset back to a blank slate.
  • The app only listens on 127.0.0.1 (your own machine) -- it's not reachable from other devices on your network.
  • These builds are unsigned and not notarized, hence the OS warnings above -- expected for an experimental build like this, not a sign anything is wrong.

What's new since v0.1.0

  • No longer auto-imports Gramps' example.gramps sample tree on first run -- starts empty instead, now that the client has a real Import screen (Family Trees -> Import...) to bring in your own data.
  • Backend now tracks gramps-web-api's master branch (its query endpoints this client relies on are merged upstream) instead of a fork branch.