{"id":25626665,"url":"https://github.com/dorianim/money-balancer","last_synced_at":"2025-04-14T12:31:30.203Z","repository":{"id":60623451,"uuid":"534720256","full_name":"dorianim/money-balancer","owner":"dorianim","description":"A simple application for managing debt with your friends!","archived":false,"fork":false,"pushed_at":"2023-02-02T15:20:18.000Z","size":1612,"stargazers_count":142,"open_issues_count":9,"forks_count":9,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-28T01:48:14.902Z","etag":null,"topics":["hacktoberfest","money","money-manager","moneytracker","pwa","react","rust","webapp"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dorianim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-09-09T16:28:10.000Z","updated_at":"2025-03-25T15:58:25.000Z","dependencies_parsed_at":"2023-02-17T21:31:01.405Z","dependency_job_id":null,"html_url":"https://github.com/dorianim/money-balancer","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorianim%2Fmoney-balancer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorianim%2Fmoney-balancer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorianim%2Fmoney-balancer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dorianim%2Fmoney-balancer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dorianim","download_url":"https://codeload.github.com/dorianim/money-balancer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248881359,"owners_count":21176836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["hacktoberfest","money","money-manager","moneytracker","pwa","react","rust","webapp"],"created_at":"2025-02-22T16:32:33.104Z","updated_at":"2025-04-14T12:31:30.177Z","avatar_url":"https://github.com/dorianim.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n    money-balancer\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/dorianim/money-balancer/actions/workflows/release.yml\"\u003e\n    \u003cimg src=\"https://github.com/dorianim/money-balancer/actions/workflows/release.yml/badge.svg\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://rust-reportcard.xuri.me/badge/github.com/dorianim/money-balancer\"\u003e\n    \u003cimg src=\"https://rust-reportcard.xuri.me/badge/github.com/dorianim/money-balancer\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nHave you ever been on a group trip and lost track of who paid for what and who owes money to whom? If so, money balancer is the perfect tool for you! It helps you to keep track of who paid for what and calculates your balance with all of your friends. A demo is available [here](https://money-balancer.gentlemeadow-7beeb17b.northeurope.azurecontainerapps.io/#/login) but it may be reset at any time.\n\n# Screenshots\n\n\u003ctable align=\"center\"\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\".github/media/screenshot-1.png\"\u003e\n        \u003cimg src=\".github/media/screenshot-1.png\" alt=\"Screenshot 1\" width=\"500px\" /\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\".github/media/screenshot-2.png\"\u003e\n        \u003cimg src=\".github/media/screenshot-2.png\" alt=\"Screenshot 2\" width=\"500px\" /\u003e\n      \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n# Usage\n\nUsing `docker-compose`:\n\n```yaml\nversion: \"3\"\nservices:\n  money-balancer:\n    image: ghcr.io/dorianim/money-balancer\n    restart: unless-stopped\n    ports:\n      - 8000:8000\n    volumes:\n      - ./data:/data\n    environment:\n      - MONEYBALANCER_JWT_SECRET=some_super_secret_secret\n```\n\nUsing `docker`:\n\n```bash\ndocker run -p8000:8000 -e MONEYBALANCER_JWT_SECRET=some_super_secret_secret -v $(pwd)/data:/data ghcr.io/dorianim/money-balancer\n```\n\nYou can then access money-balancer on [`http://localhost:8000`](http://localhost:8000). The API documentation can be found at [`http://localhost:8000/api/v1`](http://localhost:8000/api/v1).\n\n# Config options\n\n## General\n\n- `MONEYBALANCER_JWT_SECRET`: a random value for the JWT signature\n\n## Authentication\n\n### Local\n\n- `MONEYBALANCER_AUTH_LOCAL_ENABLED`: enable local username/password authentication\n\n### Proxy\n\nProxy authentication can be used with services like [Authelia](https://www.authelia.com/) and [Authentik](https://goauthentik.io)\n\n- `MONEYBALANCER_AUTH_PROXY_ENABLED`: enable proxy authentication\n- `MONEYBALANCER_AUTH_PROXY_HEADERS_USERNAME`: header containing the username (e.g. `X-authentik-username`)\n- `MONEYBALANCER_AUTH_PROXY_HEADERS_NICKNAME`: header containing the nickname (e.g. `X-authentik-name`)\n\nIf you want to use another sign on method, you may only protect the route `/api/v1/auth/proxy`.\n\nFor example in [Authentik](https://goauthentik.io), you may use this as the unauthenticated paths:\n\n```\n^([^p]|p(p|r(p|o(p|xp)))*([^pr]|r([^op]|o([^px]|x[^py]))))*(p(p|r(p|o(p|xp)))*(r(o?|ox))?)?$\n```\n\n(excludes everything that contains `proxy`, generated with [this tool](https://www.formauri.es/personal/pgimeno/misc/non-match-regex/?word=proxy))\n\n# How debts are split up:\n\n- amount / debtors\n- the potential rest is assigned to people who have to overpay\n- who has to overpay is determined by how often they have overpaid in the past in this specific group\n\n# Development\n\nYou need `cargo` and `yarn` installed on your system. You can build everything using\n\n```\ncargo build\n```\n\nThis will create a static binary in `target/debug/money-balancer` which you can run.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdorianim%2Fmoney-balancer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdorianim%2Fmoney-balancer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdorianim%2Fmoney-balancer/lists"}