{"id":50885949,"url":"https://github.com/kbennett2000/soap-journal","last_synced_at":"2026-06-15T17:01:43.418Z","repository":{"id":360573827,"uuid":"1250753159","full_name":"kbennett2000/soap-journal","owner":"kbennett2000","description":"Self-hosted, offline-first SOAP Bible journaling app with a built-in Bible reader and 13 bundled translations.","archived":false,"fork":false,"pushed_at":"2026-06-03T11:39:35.000Z","size":93009,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-03T13:14:09.944Z","etag":null,"topics":["bible","bible-journal","bible-reader","bible-study","christian","christianity","devotional","docker","fastapi","homelab","journaling","offline-first","privacy","python","react","scripture","self-hosted","soap","sqlite","typescript"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kbennett2000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-27T00:02:26.000Z","updated_at":"2026-06-03T11:39:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kbennett2000/soap-journal","commit_stats":null,"previous_names":["kbennett2000/soap-journal"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kbennett2000/soap-journal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fsoap-journal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fsoap-journal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fsoap-journal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fsoap-journal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kbennett2000","download_url":"https://codeload.github.com/kbennett2000/soap-journal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kbennett2000%2Fsoap-journal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34372130,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-15T02:00:07.085Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bible","bible-journal","bible-reader","bible-study","christian","christianity","devotional","docker","fastapi","homelab","journaling","offline-first","privacy","python","react","scripture","self-hosted","soap","sqlite","typescript"],"created_at":"2026-06-15T17:01:40.614Z","updated_at":"2026-06-15T17:01:43.409Z","avatar_url":"https://github.com/kbennett2000.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/images/soap-journal-banner-morning-light.png\" alt=\"SOAP Journal — Scripture · Observation · Application · Prayer. A quiet, self-hosted place to read Scripture and journal what you hear.\" width=\"820\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-green.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/kbennett2000/soap-journal/releases/latest\"\u003e\u003cimg alt=\"Latest release\" src=\"https://img.shields.io/github/v/release/kbennett2000/soap-journal\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nsoap-journal is a self-hosted journaling app built around the SOAP method\n(**S**cripture, **O**bservation, **A**pplication, **P**rayer), with a full Bible\nreader built in. It runs on your own Windows PC, Mac, or Linux server — your\nentries never leave your machine, and once it's installed it works completely\noffline. No accounts to sign up for, no subscription, no internet required.\n\n![The soap-journal dashboard, showing recent entries and an \"On this day in previous years\" panel](docs/screenshots/usage-dashboard-populated.png)\n\n---\n\n## Get started\n\nSetting it up takes about 20 minutes. **You don't need any technical\nexperience** — pick the kind of computer you'll run it on, and the guide walks\nyou through every step with screenshots:\n\n- 🪟 **[Windows](docs/install/windows.md)** — run it on your Windows PC\n- 🍎 **[Mac](docs/install/macos.md)** — run it on your Mac\n- 🐧 **[Linux / home server](docs/install/ubuntu-server.md)** — run it 24/7 on an\n  always-on machine for the whole household\n\n📱 **On an Android phone or tablet?** There's a separate, standalone app —\n**[SOAP Journal for Android](https://github.com/kbennett2000/soap-journal-mobile)** —\nthat runs entirely on your device, no server or computer needed.\n\nNot sure which to choose, or want the overview first? Start at the\n**[install guide](docs/install/README.md)**.\n\nAlready have it running? The **[usage guide](docs/usage/README.md)** is a friendly\ntour of everything it can do.\n\n---\n\n## What you can do\n\n- **Journal with the SOAP method** — write your Observation, Application, and\n  Prayer; the Scripture text is pulled in for you automatically.\n- **Read the Bible** — 13 translations included, side-by-side comparison, a quick\n  \"jump to a passage\" bar, and verse or paragraph layouts.\n- **Highlight verses** in six colors — across multiple verses, with optional notes.\n- **Search everything** — your journal entries, and the full Bible text.\n- **Find your way back** — tag entries, filter and browse them, see them on a\n  calendar, and revisit \"on this day in previous years.\"\n- **Optional NET Bible** with inline translator's notes and tappable\n  cross-references (you supply the source — see [Bibles](docs/bibles.md)).\n- **Share with your household** — multiple users, each with their own private\n  journal, managed by an admin.\n- **Yours and private** — works on phones and computers alike, light and dark\n  themes, and 100% offline with no telemetry once installed.\n\n\u003cdetails\u003e\n\u003csummary\u003e📸 A look around\u003c/summary\u003e\n\n\u003cbr\u003e\n\n![The Bible reader showing John chapter 3 with the controls bar](docs/screenshots/usage-reader-john-3.png)\n\n![A new entry form pre-filled from clicking John 3:16 in the reader](docs/screenshots/usage-entry-form-from-verse.png)\n\n![An entry detail page showing the saved verse text, Observation, Application, Prayer, and tags](docs/screenshots/usage-entry-detail.png)\n\n\u003c/details\u003e\n\n---\n\n## Documentation\n\n- **[Install guide](docs/install/README.md)** — step-by-step setup for Windows,\n  Mac, and Linux.\n- **[Usage guide](docs/usage/README.md)** — how to read, journal, tag, search, and\n  more.\n- **[Configuration](docs/configuration.md)** — the handful of optional settings.\n- **[Bibles](docs/bibles.md)** — what's included and how to add your own.\n- **[Backups \u0026 updates](docs/usage/09-backups-and-updates.md)** — keep your\n  journal safe.\n- **[Troubleshooting](docs/install/troubleshooting.md)** — if something doesn't\n  look right.\n\n---\n\n## For developers\n\nsoap-journal is a Python/FastAPI backend serving a React/TypeScript frontend,\npackaged with Docker. Contributions that keep it small and self-hostable are\nwelcome.\n\n\u003cdetails\u003e\n\u003csummary\u003eQuick start (if you're comfortable with Docker)\u003c/summary\u003e\n\n\u003cbr\u003e\n\n```bash\ngit clone https://github.com/kbennett2000/soap-journal.git\ncd soap-journal\ncp .env.example .env        # Windows PowerShell: Copy-Item .env.example .env\ndocker compose up -d\n```\n\nThen open `http://localhost:8045`. The first user to register becomes the admin.\nFirst boot loads the 13 bundled translations and takes a few minutes.\n\n\u003c/details\u003e\n\n- **Running without Docker:** [Linux / macOS](docs/install/manual.md) ·\n  [Windows](docs/install/windows-manual.md)\n- **Contributing:** [`CONTRIBUTING.md`](CONTRIBUTING.md) — dev setup, tests,\n  branch conventions, and the project's philosophy on scope.\n- **Design:** [`SPEC.md`](SPEC.md) (the full specification),\n  [`CLAUDE.md`](CLAUDE.md) (engineering conventions), and\n  [`docs/adr/`](docs/adr/README.md) (architecture decision records).\n- **Release notes:** [`CHANGELOG.md`](CHANGELOG.md).\n\n---\n\n## License\n\nMIT — see [`LICENSE`](LICENSE). Third-party software notices live in\n[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbennett2000%2Fsoap-journal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkbennett2000%2Fsoap-journal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkbennett2000%2Fsoap-journal/lists"}