Git Product home page Git Product logo

smartreceiptsios's Introduction

Smart Receipts

Save time tracking expenses and get back to what matters

SmartReceipts

Build Status

Turn your phone into a receipt scanner and expense report generator with Smart Receipts! With Smart Receipts, you can track your receipts and easily generate beautiful PDF and CSV reports.

Download Smart Receipts on the Apple AppStore:

  • Smart Receipts. The free version of the app, but it also supports an in-app purchase subscription.

The free and plus versions versions are identical, except the plus version offers the following enhancements:

  • The paid version has no ads
  • The paid version supports automatic backups to Google Drive
  • The paid version automatically processes exchange rate conversions
  • The paid version allows you to automatically break down prices by category/payment method in your reports
  • The paid version allows you to edit/customize the pdf report footer (by default, it is "Report Generated with Smart Receipts")

Table of Contents

Guide

Curious about how Smart Receipts works? Check out our usage guide:

Or watch out YouTube video series.

Features

  • Create expense report "folders" to categorize your receipts
  • Take receipt photos with your camera's phone
  • Import existing pictures on your device
  • Import PDF receipts
  • Save receipt price, tax, and currency
  • Tag receipt names, categories, payment method, comments, and other metadata
  • Create/edit/delete all receipt categories
  • Track distance traveled for mileage reimbursement
  • Automatic exchange rate processing
  • Smart prediction based on past receipts
  • Generate PDF, CSV, & ZIP reports
  • Fully customizable report output
  • Automatic backup support via Google Drive
  • OCR support for receipt scans
  • Graphical breakdowns of spending per category
  • Cross-organization setting standardization

Install

To install, clone or pull down this project. Once you the code on your machine, be sure to install cocoapods and then run the following commands:

pod repo update
pod install

Please note that that in order to use this project fully, you will need to replace the following place holder files:

  • SmartReceipts/Service Account.json. This is is used for Firebase crash reporting.
  • SmartReceipts/GADConstants.m. This is required to display AdMob advertisments. Replace this with an empty string to prevent ads from loading successfully.
  • SmartReceipts/Supporting Files/Secrets.swift. This is used for low usage "secret" keys that are secret enough that I do not wish to place them in GitHub but are not so secret that they need to be removed from the compiled IPA entirely.

It is recommended to run the following commands after cloning this project in order to avoid accidentally pushing changes to these files:

  • git update-index --assume-unchanged SmartReceipts/Ads/GADConstants.m
  • git update-index --assume-unchanged SmartReceipts/Supporting Files/Secrets.swift
  • git update-index --assume-unchanged SmartReceipts/ServiceAccount.json

This will prevent git from tracking these changes against your local secrets.

Donate

If you like our project, please consider donating:

Contribute

Contributions are always welcome! Please open an issue to report a bug or file a feature request to get started.

Continuous Integration

We currently use Travis-CI for our continuous integration in order perform tests against new commits, allowing us to avoid potential regressions. You can monitor the current build status here:

All repository secrets have been replaced with placeholder files, so Travis should be able to build properly for all requests.

License

The GNU Affero General Public License (AGPL)

Copyright (c) 2012-2017 Smart Receipts LLC (Will Baumann)

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

smartreceiptsios's People

Contributors

azamat163 avatar bananafish911 avatar dependabot[bot] avatar evsenevdev avatar ixrevo avatar jaanussiim avatar mcslim avatar tomgranot avatar tomgs avatar wbaumann avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

smartreceiptsios's Issues

Feature Request: Pinch and Spread Ability During Image Preview

After taking a picture, could we have the ability to zoom in to see the image on the preview screen? Sometimes, it is difficult to see line item details in the preview to make sure they are readable; and having a zoom feature would help determine whether or not to use the photo or retake it. Currently, I have to select "Use Photo", finish creating the receipt entry, view the image and zoom in there. If it turns out it wasn't a good pic, have to retake. It would be much more convenient and faster to be able to zoom in on the preview.

Is your OCR local or do you do the processing online?

I want to make a simple receipt tracker for myself, none of the ones on the App Store provide the level of granularity that I need, as far as OCR.

As a starting point, I'm looking for receipt scanning OCR libraries that are open source. Is yours? I couldn't seem to find it after a few minutes of digging in the source code.

Pod Folder Missing

Where is the Pods File Folder? I can see the Pods file but its missing the folder to run the app opening the workspace.

Feature request: Tips tracking

Would it be possible to get a feature added to keep track of tips left as a part of a transaction? On my Android, I set it up as another tax field, but I don't see the ability to do this on iOS, hence this request :).

Automatic backups not working on iOS

Automatic backups appear to not be working on iOS. I saw with the latest 1.22.2 release notes that it should be fixed, but for me at least it doesn't appear to be backing up. The cloud icon on all of my expense reports isn't crossed out, however, it does not show the checkmark like it would if it was backed up.

Feature Request: Multiple Image Support for Single Receipt

I often have long receipts and trying to take a single picture of it can be a daunting task. It would be nice to have the ability to store multiple images on a receipt entry and be able to page through them easily (possibly by swiping) when viewing. This way, I can break down the long receipts by taking two or more pictures.

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.