About
SplitPro is a self-hosted, open source way to share expenses with friends. It is designed as a replacement for Splitwise.
Quick start
- Use Docker Compose from docker/prod/compose.yml.
- Copy
.env.example to .env and configure auth, database, and uploads.
- Start the stack and log in to create your first account.
See docker/README.md and docs/CONFIGURATION.md for the full setup steps.
Core features
- Add expenses with a friend or a group.
- Split methods: equal, percentage, share, exact, adjustments, and settlements.
- Categories, currencies, dates, and receipt attachments (stored locally).
- Negative expenses are supported for refunds and corrections.
- PWA support with push notifications.
- Activity feed with edits and deletions.
- Detailed balances per person and per group.
UI preview
Usage overview
1) Expenses, balances, and activity
Create expenses with categories, currencies, dates, and receipt attachments. SplitPro supports negative expenses for refunds and corrections. View per-person balances, detailed group balances, and an activity feed that includes edits and deletions.
2) Application info
SplitPro is a PWA and that is the recommended way to use the app. It supports push notifications for new expenses and updates, but push delivery requires additional configuration. See docs/CONFIGURATION.md.
3) Groups
Groups are the primary way to use SplitPro. You can invite friends by email, or add them directly if they are already in your friends list. Group debt simplification is optional, and the group balance view provides a detailed breakdown.
4) Data utilities
Splitwise import supports friends and groups (partial import). Expenses themselves are not imported yet. You can export data from the balances view and account settings.
5) Translations
Translations are managed in Weblate. When a language reaches 100%, it is enabled in the next update.
6) Authentication
SplitPro uses NextAuth. At least one provider must be configured.
- Email sign-in (magic link)
- OAuth (Google)
- OIDC (Authentik, Keycloak, or custom OIDC)
Username/password login is not supported. You can lock down an instance by disabling signups and invites. See docs/CONFIGURATION.md and docs/AUTHENTICATION.md for details.
7) Currency conversions
SplitPro can display balances in a single currency, convert expense amounts, and convert group balances. Provider availability and rate limits depend on the configured rate provider. See docs/CURRENCY_CONVERSIONS.md.
8) Recurring transactions
Recurring expenses require a PostgreSQL database with the pg_cron extension. We publish a prebuilt Postgres image with pg_cron; example usage is in docker/prod/compose.yml. If you use another database, you must enable the extension and adjust configuration. A non-superuser database role is supported when pg_cron is preinstalled; see docker/README.md#external--managed-postgresql-non-superuser and docs/CONFIGURATION.md#external-postgresql-prerequisites-pg_cron. See docs/RECURRING_TRANSACTIONS.md.
9) Bank transaction integration
Bank integration allows you to load transactions from providers like Plaid and convert them into expenses. This feature was provided by @alexanderwassbjer, who is currently maintaining related issues. See docs/BANK_TRANSACTIONS.md.
Limitations and notes
- SplitPro computes balances from expenses on the fly using database views. Expenses are the source of truth, which keeps balances consistent and trustworthy. For self hosted deployments the efficiency of database aggregations is entirely sufficient, but please do report any performance issues.
- Recurring transactions require
pg_cron, which does not support cron ranges or lists.
- Currency conversion accuracy and coverage depend on the selected provider.
- Receipts are stored on local disk; make sure your uploads volume is persistent.
Supporting docs
Versions
SplitPro is for self hosting. To get the most recent features, build an image from source. Stabilized changes (GitHub releases) are available as Docker images on DockerHub and GHCR. The hosted instance at https://splitpro.app is managed in oss-apps/split-pro-cloud.
Why
Splitwise is one of the best apps to add expenses and bills.
We understand that every app needs to make money, after all, lots of effort has been put into Splitwise. The main problem is how they implemented this.
Monetising on pro features or ads is fine, but asking money for adding expenses (core feature) is frustrating.
We were searching for other open-source alternatives (Let's be honest, any closed-source product might do the same and we don't have any reason to believe otherwise).
We managed to find a good app spliit.app by Sebastien Castiel but it's not a complete replacement and didn't suit my workflow sadly. Check it out to see if it fits you.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
