GithubHelp home page GithubHelp logo

bartoszkaminski / splitsheet Goto Github PK

View Code? Open in Web Editor NEW
6.0 3.0 2.0 303 KB

Splitsheet is an expense tracker Google Docs spreadsheet template with a script that pulls your data from Splitwise

License: MIT License

JavaScript 100.00%

splitsheet's Introduction

Splitsheet

Track your expenses and maintain personal budget using Splitwise!

Splitsheet is an expense tracker Google Docs spreadsheet template with a script that pulls data from Splitwise.

Splitsheet screenshot

Check out the template!

Idea

I was looking for a convenient way to maintain home budget for some time and soon realized that a good portion of my expenses (ones shared with my friends) is already tracked in Splitwise. I wanted to avoid duplicating these expenses into a "proper" budget app and decided to use Splitwise for personal expenses as well. While being a great expenses sharing app, Splitwise has its limitations when it comes to analyzing your spending. That's where Splitsheet comes in!

How to get started

Splitwise API key

You need Splitwise API key to use the script. Go to your Splitwise dashboard, open your account settings (Your account under your avatar) and find Your apps in Advanced features. Click Register your application and fill out the required fields:

Optional fields can remain blank.
Click Register and get API key to obtain your Consumer Key and Consumer Secret required in the next step.

Config

Open a template spreadsheet and make a copy. Once you have your own Splitsheet, open Config sheet and fill in previously obtained Splitwise Consumer Key and Consumer Secret. Also, choose a default currency by providing its code (USD, EUR, PLN etc).

Authorize Splitsheet

Open a month sheet, choose Splitwise -> Update from the menu. Follow link from the dialog to authorize Splitsheet in Splitwise. One you get "Success! You can close this tab" response, you are all set! Use Splitwise -> Update once again and your expenses should be visible.

Usage

There are some things you need to know before using Splitsheet.

Personal expenses

The most convenient way to track personal expenses in Splitwise is to create a group with you as the only member. Any expense you create there will be assigned to you.

General category

Unfortunately, Splitwise marks Settle all balances transaction with General category which messes up expenses summary. That's why Splitsheet filteres out all General transactions. Please use specific categories.

Currency

Splitsheet supports multiple currencies but all expenses are presented in user's currency which must be specified in Config sheet. Conversion rate from the date of the transacion is used.

Date range

You can choose a date range for each month in the upper right corner of the sheet. Provide a closed range, expenses from both endpoints dates' will be included.

Trips expenses

I decided that Dining out, Car or Groceries while on a trip is something different than at home. That's why the script changes category of all expenses that belong to groups of type Trip to a new category Entertainment/Trips


If you are unhappy with any customization I made, feel free to fork this repository and modify it to suit your needs ๐Ÿ˜‰

splitsheet's People

Contributors

bartoszkaminski avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

splitsheet's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.