https://github.com/alanjumeaucourt/firefly-iii-synchro

Python-based solution for managing and synchronizing financial data between Kresus, Firefly III and local excel
https://github.com/alanjumeaucourt/firefly-iii-synchro

excel-import finance firefly-iii kresus personal-finance python

Last synced: about 2 months ago
JSON representation

Python-based solution for managing and synchronizing financial data between Kresus, Firefly III and local excel

• Host: GitHub
• URL: https://github.com/alanjumeaucourt/firefly-iii-synchro
• Owner: AlanJumeaucourt
• Created: 2024-01-13T10:13:24.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2024-08-07T16:12:21.000Z (5 months ago)
• Last Synced: 2024-08-07T20:07:33.962Z (5 months ago)
• Topics: excel-import, finance, firefly-iii, kresus, personal-finance, python
• Language: Python
• Homepage: https://alanjumeaucourt.github.io/firefly-iii-synchro/
• Size: 6.17 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Firefly III Synchronization Tool

This project provides a comprehensive Python-based solution for managing and synchronizing financial data between Kresus - a personal finance management tool, and Firefly III - an open-source personal finance manager. It's designed to streamline the process of financial data handling, offering seamless integration and data synchronization capabilities.

A python documentaion is available [here](https://alanjumeaucourt.github.io/firefly-iii-synchro/)

## Features

Firefly III API Integration: Utilizes a custom-built wrapper around the Firefly III API, enabling efficient interactions such as fetching, creating, updating, and deleting financial records.

- Kresus Data Processing: Handles data obtained from Kresus, effectively parsing and preparing it for synchronization with Firefly III.

  Kresus offer automatically synchro with a lots of bank accounts

- Data Synchronization: Offers functionalities to sync accounts and transactions from Kresus to Firefly III, ensuring data consistency across platforms.

- Local Data Management: Supports reading and processing local financial data, providing a bridge between local data sources (excel) and Firefly III.

- CSV Export: Includes utility functions for exporting financial data to CSV files, aiding in data backup and reporting.

- Logging and Configuration: Features a robust logging system for monitoring and debugging, along with .env based configuration management for enhanced security and customization.

## Usage

The tool's main module orchestrates various components, including API interactions, data processing, and synchronization tasks. It's designed for ease of use and can be adapted to different user requirements.

## Getting Started

1. Clone the repository.

1. Set up your .env file with necessary API keys and endpoints. (.env.template is here to help you so)

1. build and lauch the container `docker build --pull --rm -f "Dockerfile" -t fireflyiiisynchro:latest "." && docker run -it fireflyiiisynchro`