/SmartReceiptsLibrary

A customizable, easy-to-use receipt scanner for Android

Primary LanguageJavaGNU Affero General Public License v3.0AGPL-3.0

Smart Receipts

A Better Receipt Scanner

SmartReceipts

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 Google Play Store:

  • Smart Receipts. The free version of the app, but it also supports an in-app purchase subscription.
  • Smart Receipts Plus. A 'paid' app from back before Google supported in-app purchases.

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

  • The plus version has no ads
  • The plus version supports automatic backups (Android only - coming to iOS in the next update)
  • The plus version automatically processes exchange rate conversions (with the newest version)
  • The plus version allows you to edit/customize the pdf footer

Table of Contents

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

Smart Receipts is broken into a few core modules:

  • app. All common application code for both the free and plusFlavor flavors of the application are defined here. In practice, all development work should occur in this module
  • wBMiniLibrary. A few legacy items that haven't been moved into the Library module, but it's otherwise unused.

To install, clone or pull down this project. Please note that it will NOT work out of the box, so you will need to add the following files to ensure it will compile:

  • google-services.json. This needs to be added to both the free and plus favors at the root level in order for Firebase to function. Please refer to the Firebase documentation for more details:
  • app/src/free/google-services.json
  • app/src/plusFlavor/google-services.json
  • app/src/main/res/values/secrets.xml. You can copy the secrets.xml.sample file and rename the keys inside to achieve this behavior. This is used for low usage keys
  • app/src/free/res/values/ads.xml. The ads file in smartReceiptsFree. You can add adUnitId and classicAdUnitId to enable support for AdMob Native and Classic Ads, respectively.
  • app/src/free/res/xml/analytics.xml. The analytics file in smartReceiptsFree. You can add a key here if you wish to enable Google Analytics.

Generally speaking, it's easier to test against SmartReceiptsPlus (ie Smart Receipts PlusFlavor), since there are less secrets that have been explicitly git ignored to avoid key leaks.

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.

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/>.