{"id":15389099,"url":"https://github.com/splitbrain/thecashster","last_synced_at":"2025-04-15T18:30:50.386Z","repository":{"id":136753593,"uuid":"109390295","full_name":"splitbrain/TheCashster","owner":"splitbrain","description":"Simple Expense Tracking App for Android with Google Sheets Sync","archived":false,"fork":false,"pushed_at":"2018-09-14T23:02:45.000Z","size":2936,"stargazers_count":15,"open_issues_count":1,"forks_count":10,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-29T00:33:59.121Z","etag":null,"topics":["android","android-app","expense-tracker","foursquare-api","google-sheets"],"latest_commit_sha":null,"homepage":"https://play.google.com/store/apps/details?id=org.splitbrain.thecashster","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/splitbrain.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2017-11-03T11:57:05.000Z","updated_at":"2024-11-26T12:35:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"f16abb26-89f2-48a9-95d8-69812e070e4a","html_url":"https://github.com/splitbrain/TheCashster","commit_stats":{"total_commits":47,"total_committers":1,"mean_commits":47.0,"dds":0.0,"last_synced_commit":"decbe2772a1b607fde3c49c4deea5f00a4297169"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splitbrain%2FTheCashster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splitbrain%2FTheCashster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splitbrain%2FTheCashster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/splitbrain%2FTheCashster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/splitbrain","download_url":"https://codeload.github.com/splitbrain/TheCashster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249128910,"owners_count":21217241,"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":["android","android-app","expense-tracker","foursquare-api","google-sheets"],"created_at":"2024-10-01T14:59:27.394Z","updated_at":"2025-04-15T18:30:48.986Z","avatar_url":"https://github.com/splitbrain.png","language":"Java","readme":"# TheCashster\n\nTheCashster is a simple Expense tracking software for Android. It is meant as a companion to [TheBankster](https://github.com/splitbrain/TheBankster) but should work fine alone.\n\nThe goal is to keep expense tracking as simple as possible:\n\n1) pick the place you're at\n2) enter the amount you spent\n3) click *Done* - because you are\n\nThere are no categories to pick, no budgets to create or anything complicated. All your expenses are logged to a Google Sheets spreadsheet - that's where you can do whatever complicated reporting you want.\n\nTheCashster is available on [Google Play](https://play.google.com/store/apps/details?id=org.splitbrain.thecashster) and on [Github](https://github.com/splitbrain/TheCashster).\n\n## Permissions\n\nThe application needs a few permissions. Here's what they are used for.\n\n* `ACCESS_FINE_LOCATION` You will be asked for permission to \"access this device's location\" when you start the app. It is required to locate where you are and suggest nearby places.\n* `GET_ACCOUNTS` You will be asked to allow to \"access your contacts\" when you save your first expense. This is required to access your phone's Google account which is used to authenticate at the Google Sheets API.\n* `INTERNET` This permission is granted on installation and allows the app to access the internet to talk to Foursquare and Google.\n* `VIBRATE` This enables the haptic feedback when clicking the number buttons. The permission is granted on installation.\n\n## Places\n\nWhen starting up the app, a list of nearby places will appear automatically based on your current location. The places are provided by [FourSquare](https://foursquare.com).\n\nSelect the place you're at and you're ready to submit an expense. Places that have been used by you are stored on your device and will be suggested at the top next time you're near. You can recognize those places by the little star ★ symbol.\n\nYou can delete locally stored ★ places by long pressing on them and confirm the deletion.\n\nIf you can't find what you're looking for, use the search at the top of the screen. It is used to request places matching what you entered. You will also get the opportunity to simply create a local ★ place based on your input.\n\nBy default the search for places is restricted to nearby locations. Swipe down the list to increase the search radius. Repeat to further increase the radius.\n\n## Google Sheets\n\nThe moment you save your first expense, TheCashster will create a new [Google Sheets](https://docs.google.com/spreadsheets/) spreadsheet for you. Your installation is then associated with this spreadsheet and all expenses will be logged to it.\n\nBecause the spreadsheet is identified by an internal ID you're free to rename or move it. You can also edit the formatting, rename the column headers or add additional sheets. You can safely remove rows if you accidentally tracked a wrong expense.\n\nYou should however not change the order of the columns and you have to keep in mind that data is tracked on the very first sheet of the document.\n\nThere is currently no way to associate TheBankster with an existing spreadsheet. This means whenever you reinstall the app it will create a new spreadsheet and there is no way to have the app on two devices track to the same spreadsheet. Support for that might come later.\n\n## License\n\nTheCashster is Open Source and licensed under the MIT License\n\nCopyright 2017 Andreas Gohr\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n## Privacy Policy\n\nThis App uses the Google Play Services to access your device's last location and to connect to your Google Sheets account. This app has no access to any other private information.\n\nCrash and usage data may be transferred to Google.\n\nYour location is sent to Foursquare to get a list of nearby places. No personal information is sent with that request.\n\nNone of your personal identifiable data is transferred to to me, the author of the application. I may receive anonymous usage statistics through Google.\n\nPlease refer to the privacy policies of\n\n  * [Google](https://www.google.com/policies/privacy/)\n  * [Foursquare](https://foursquare.com/legal/privacy)\n\nThis policy will be updated when necessary.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplitbrain%2Fthecashster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsplitbrain%2Fthecashster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsplitbrain%2Fthecashster/lists"}