bestlibre / FireflyMobile

Mobile Application for Firefly III written in Kotlin

Firefly III(Android)

Firefly Mobile is an unofficial Android client for Firefly III, written in Kotlin.

Disclaimer

This software is using Firefly III APIs. It is under heavy development and it might work in unexpected ways. In order to use this app, you must first setup a Firefly III instance. If you are not inclined to install, the demo works too.

Other alternative include this software written by mconway using Ionic framework.

Authentication

Check the wiki page for more info

Features

✔ Support Marshmallow and up!

✔ Offline: View and submit offline data

✔ Automation: Add data non-interactively allowing powerful automation. Read the wiki for more info.

✔ Reporting: Financial reports give you overview of your spending and income

Running the Software

Building

With your device plugged into your PC and ADB enabled

git clone https://github.com/emansih/FireflyMobile.git
cd FireflyMobile
./gradlew clean installDebug

Please note that assembleGithubRelease task requires you to have 3 system environment variables. They are FireflyKeystoreAlias, FireflyKeystoreFile and FireflyKeystorePassword

Pre-built APK

An APK is provided in the release page for convienent purposes. All APKs are signed with the same release key, this ensure that the APK comes from me and your financial data will not be exposed to nefarious actors. The APK SHA256 public key is 40:F2:02:B8:CC:D1:68:87:56:8A:F7:9E:27:44:5B:E1:82:51:CC:B9:1E:89:08:8B:04:3D:2F:35:A2:0D:C3:8F. All commits in this repo are signed with my GPG key and the public key can be found on keybase and Github

To get latest update notifications, add this RSS feed.

It's also available via F-Droid here. I have also added my own FDroid repo for users with Privileged Extension. For more info, take a look at the wiki

If there is enough interest, I might upload it to Google Play Store.

Screenshots

Dashboard	Piggy Bank	Adding Piggy Bank	Piggy Bank Details

Transactions	Bills	Login	Report	Bills Details

Thanks to Screener - Better Screenshots for the device frame!

Contributing

Reporting Bugs

Found a bug? Before reporting it, check the issue page to see if I am aware of it. If not, simply open up the issue form and fill it up. Please attach a stacktrace together with the bug report.

^^^ On MIUI devices, please enable Autostart by going to Settings -> Apps -> Manage apps -> Firefly III Mobile -> Toggle Autostart

Why is it needed?

XiaoMi blocks JobScheduler by default and ACRA, our bug reporting system, uses JobScheduler to open the email intent with attachment.

What can you as a user do about it?

1. Ask Google to add a test in the CTS and avoid these behaviours by the OEMs.
2. Ask XiaoMi to avoid this kind of breaking changes.

Please see this website for more info: https://dontkillmyapp.com/

Contributing

How do I join/contribute to Firefly Mobile? I am open to any kind of suggestions/feature request! Open an issue or drop me an email(Can be found on my Github profile).

Contributors

This project exists thanks to all the people who contributed. Icons in this app are taken from:

1. Flaticon
2. Material Design Icons
3. Android Iconics
4. App icon taken from Firefly III server(favicon). Original source

License

    Copyright (C) 2018 - 2019 Daniel Quah(emansih)

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU 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 General Public License for more details.

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