1# Nextcloud Cospend ��
2
3Nextcloud Cospend is a group/shared budget manager. It was inspired by the great [IHateMoney](https://github.com/spiral-project/ihatemoney/).
4
5You can use it when you share a house, when you go on vacation with friends, whenever you share money with others.
6
7It lets you create projects with members and bills. Each member has a balance computed from the project bills. This way you can see who owes the group and who the group owes. Ultimately you can ask for a settlement plan telling you which payments to make to reset members balances.
8
9Project members are independent from Nextcloud users. Projects can be accessed and modified by people without a Nextcloud account. Each project has an ID and a password for guest access.
10
11[MoneyBuster](https://gitlab.com/eneiluj/moneybuster) Android client is [available in F-Droid](https://f-droid.org/packages/net.eneiluj.moneybuster/) and on the [Play store](https://play.google.com/store/apps/details?id=net.eneiluj.moneybuster).
12
13[PayForMe](https://github.com/mayflower/PayForMe) iOS client is currently being developped!
14
15## Features
16
17* ✎ create/edit/delete projects, members, bills, bill categories, currencies
18* ⚖ check member balances
19* �� display project statistics
20* ♻ display settlement plan
21* �� automatically create reimbursement bills from settlement plan
22* �� create recurring bills (daily/weekly/monthly/yearly)
23* �� optionally provide custom amount for each member in new bills
24* �� link bills with personal files (picture of physical bill for example)
25* �� guest access for people outside Nextcloud
26* �� share projects with Nextcloud users/groups/circles
27* �� import/export projects as csv (compatible with csv files from IHateMoney)
28* �� generate link/QRCode to easily import projects in MoneyBuster
29* �� implement Nextcloud notifications and activity stream
30
31This app is tested on Nextcloud 20+ with Firefox 57+ and Chromium.
32
33This app is under development.
34
35�� Help us to translate this app on [Nextcloud-Cospend/MoneyBuster Crowdin project](https://crowdin.com/project/moneybuster).
36
37⚒ Check out other ways to help in the [contribution guidelines](https://gitlab.com/eneiluj/cospend-nc/blob/master/CONTRIBUTING.md).
38
39## Documentation
40
41* [User documentation](https://github.com/eneiluj/cospend-nc/blob/master/docs/user.md)
42* [Admin documentation](https://github.com/eneiluj/cospend-nc/blob/master/docs/admin.md)
43* [Developer documentation](https://github.com/eneiluj/cospend-nc/blob/master/docs/dev.md)
44* [CHANGELOG](https://github.com/eneiluj/cospend-nc/blob/master/CHANGELOG.md#change-log)
45* [AUTHORS](https://github.com/eneiluj/cospend-nc/blob/master/AUTHORS.md#authors)
46
47## Known issues
48
49* it does not make you rich
50
51Any feedback will be appreciated.