Documentation

Guide complet pour utiliser StashFlow et analyser vos finances en toute simplicité

1. Introduction

StashFlow est un outil gratuit et local qui vous permet d'analyser vos transactions bancaires pour identifier vos charges fixes, suivre votre épargne et obtenir des projections précises sur votre situation financière.

Principaux avantages :

  • Toutes vos données restent sur votre ordinateur (aucune transmission vers des serveurs)
  • Détection automatique des charges fixes récurrentes
  • Reconstruction automatique de l'historique de votre solde
  • Projections détaillées sur 3 mois avec visualisation graphique
  • Suivi personnalisé de vos charges fixes validées

💡 Conseil : Commencez par importer vos données bancaires, puis suivez les étapes dans l'ordre pour une analyse optimale.

2. Import your CSV data

Step 1: Export your transactions

📖 Bank-specific guides →

The first step is to export your bank transactions from your online bank. Most banks allow exporting transactions in CSV format.

  • Log in to your online banking space
  • Access your transaction history
  • Select the desired period (recommended: minimum 3-6 months)
  • Export in CSV format (or Excel then convert to CSV)

💡 Tip: Not sure how to export from your specific bank? Check out our step-by-step guides for BNP Paribas, Société Générale, Crédit Agricole, and many more!

Step 2: CSV file format

StashFlow accepts CSV files with the following columns:

ColumnDescriptionExample
DateTransaction date2024-01-15 or 15/01/2024
LabelTransaction descriptionCARD PAYMENT SUPERMARKET
DebitOutgoing amount (optional)45.50
CreditIncoming amount (optional)2500.00

Note: Some banks use a single "Amount" column with negative/positive values. StashFlow automatically detects the format.

Step 3: Import into StashFlow

Once your CSV file is ready, import it into StashFlow:

1

Click the "Choose file" button in the "Import CSV" section

Select a CSV file

Accepted formats: .csv, .tsv, .txt

2

Select your CSV file from your computer

3

Wait for the file to be analyzed (a few seconds)

Transactions are automatically displayed in the chart

⚠️ Important: If you encounter an error during import, check that your file contains the Date and Label columns. You can open the file with a text editor to check its content.

3. Import from PayPal

If you use PayPal regularly, you can directly import your PayPal transactions to integrate them into your analysis. This feature allows you to combine your traditional bank transactions with your PayPal transactions.

Step 1: Access PayPal reports

1. Log in to your PayPal account

P
HomeSend and requestWalletActivityHelp
5
🔔
⚙️
LOGOUT

Click on "Activity" in the navigation bar (highlighted in blue)

2. Go to "All reports"

All reports

💬 Give us your feedback
🔍Search reports
FavoritesPaymentsRisksActivitiesPerformanceTax

Balance report

Detailed information on balances, transactions...

📄 Monthly statements and custom statements

Consolidated view of balances, payments, fees...

Select "Monthly statements and custom statements" or "Activity report"

3. Create a new activity report

← Back to all reports
💬 Give us your feedback

Activity Report ⭐

You can create and download a detailed report of all your transactions for a period of up to 12 months over the past 7 years.

Balance impact

Options: All transactions, Completed payments, Balance impact

Last 6 months

Options: Since last download, Today, Last 3 months, Last 6 months, or custom

CSV ✓
CSV
TAB
PDF
QuickBooks (IIF)
Quicken (QIF - USD only)

⚠️ Important: Select "CSV" to be able to import it into StashFlow

4. Download your CSV report

Activity reports (up to 12 reports)
Refresh
Report typeRequest datePeriodFormatAction
All transactionsDec 27, 2025Jun 1, 2025 - Nov 30, 2025CSV
Balance impactDec 27, 2025Jan 1, 2025 - Dec 27, 2025CSV

Click "Download" to save the CSV file to your computer. The file will be ready to import into StashFlow.

📝 Important note: Make sure to select the CSV format when creating the report. PDF, QuickBooks or Quicken formats are not compatible with import into StashFlow.

Step 2: Import into StashFlow

1

Click "Import from PayPal" in the interface

2

Select your PayPal CSV file

3

PayPal transactions will be automatically associated with your bank transactions

💡 Tip: The association between PayPal and bank transactions is done automatically by comparing dates and amounts. Unassociated transactions are displayed separately in the chart.

4. Enter your current balance

To reconstruct your balance history, StashFlow needs to know your current balance on the most recent day of your transactions. This balance serves as a starting point to go back in time and calculate past balances.

Illustration: Balance entry

Current Balance

This balance will be used to reconstruct the history by going back in time.

How to find your current balance?

  • Log in to your online banking space
  • Note your available balance on the day of the last transaction in your CSV export
  • Enter this amount in StashFlow (use a period as decimal separator)

💡 Important: Make sure that the entered balance corresponds to the day of the last transaction in your CSV file. If your transactions end on January 15th, enter the balance on January 15th, not the current balance.

5. Use the interactive chart

The interactive chart is at the heart of StashFlow. It allows you to visualize the evolution of your balance over time and interact with your transactions.

Chart features

Balance evolution (last 90 days)

Oct - Dec 2024
3000€
2000€
1000€
Oct 1Oct 15Nov 1Nov 15Dec 1Dec 15Dec 30
Reconstructed balance
Debits (fixed charges)
Credit (salary)

Example of displayed data:

Oct 1 - RENT-750.00 €
Oct 15 - SUPERMARKET-85.50 €
Nov 1 - Salary+2,500.00 €
Nov 15 - INSURANCE-45.00 €

🖱️ Click on a point

Click on a point in the chart to see the details of that day's transactions in the side panel.

👆 Hover over a transaction

Hover over a transaction bar in the stacked chart to see its label and amount.

🔍 Filter by period

Use the period filter to display the last 30, 60, 90 days or all data.

📊 Stack by label

Enable the "Stack by label" option to group similar transactions and better visualize your spending habits.

6. Analyze fixed charges

Automatic fixed charge detection is one of StashFlow's most powerful features. The tool analyzes your transactions to identify recurring payments.

Automatic detection

StashFlow uses algorithms to automatically detect potential fixed charges:

  • Recurrence: Transactions with the same or similar label that repeat regularly
  • Amount: Identical or very close amounts at each occurrence
  • Frequency: Monthly, weekly, or according to a regular pattern
  • Average amount: Automatic calculation of the average amount for each charge

Fixed charges table

LabelAverage amountOccurrencesActions
RENT750.00 €12
PHONE SUBSCRIPTION24.99 €12
HOME INSURANCE45.50 €6

Validate a fixed charge

Click "Validate" to confirm that a charge is indeed fixed. It will then be used for projections and tracking.

Add manually

Use the "Add a fixed charge" button to create a charge that would not have been automatically detected.

📄 Export to PDF

Generate a PDF report of all your validated fixed charges for your records or accounting.

7. Make projections

Projections allow you to forecast the evolution of your balance over the next 3 months taking into account your validated fixed charges and your salary.

How to use projections

  1. Validate your fixed charges in the "Fixed Charges" tab
  2. Click the "3-month projection" button
  3. Configure your monthly net salary and the day of the month you are paid
  4. Visualize the graphical projection of your balance

3-month projection chart

Projection: January - March 2025

Initial balance: 1,850.00 € • Salary: 2,500.00 €/month

4000€
3000€
2000€
1000€
Jan 1Jan 15Feb 1Feb 15Mar 1Mar 15Mar 31
Projected balance
Cumulative fixed charges
Salary payment

Projection details:

January

Starting balance: 1,850.00 €

Salary: +2,500.00 € (1st)

Charges: -820.00 €

End balance: 3,530.00 €

February

Starting balance: 3,530.00 €

Salary: +2,500.00 € (1st)

Charges: -820.00 €

End balance: 5,210.00 €

The chart shows the forecasted evolution of your balance over 3 months taking into account your validated fixed charges and your salary. The green vertical lines represent salary payments, while the red dashed line shows the cumulative fixed charges.

💡 Tip: Projections are based on your validated fixed charges and assume that your spending behavior remains stable. Use them as an indicator, not as a guarantee.

8. Track your validated fixed charges

Once your fixed charges are validated, you can track them on a dedicated page to mark each payment and track the evolution of your balance.

Access tracking

Click "View fixed charges tracking" in the "Fixed Charges" tab to access the dedicated tracking page.

Tracking features

📍 Mark a fixed charge

When one of your fixed charges is paid, you can mark it:

  1. Click "Mark" next to the charge in question
  2. Enter the actual amount paid (may differ from the average amount)
  3. Indicate your current balance after payment
  4. Optionally add a note
  5. Validate to save the marking

📊 Evolution chart

A chart shows the evolution of your balance over time as you mark charges, allowing you to visualize the impact of each fixed charge on your account.

⚙️ Salary configuration

Configure your monthly salary and the day of the month you are paid to improve the accuracy of projections in tracking.

Add a shortcut to the home screen

📱

Quick access from your phone

To mark your fixed charges quickly as soon as you make a payment, you can add the tracking page directly to your smartphone's home screen. This allows you to access it with a single click, without having to open the browser and enter the URL.

🍎 On iPhone/iPad (Safari)
  1. Open the fixed charges tracking page in Safari
  2. Tap the Share button (square icon with upward arrow)
  3. Scroll down and select "Add to Home Screen"
  4. Modify the name if you wish (for example: "Charge Tracking")
  5. Tap "Add" in the top right
  6. The icon now appears on your home screen
🤖 On Android (Chrome or other browser)
  1. Open the fixed charges tracking page in Chrome (or your browser)
  2. Tap the menu (3 dots) in the top right
  3. Select "Add to Home Screen" or "Install App"
  4. Modify the name if you wish
  5. Tap "Add" or "Install"
  6. The icon now appears on your home screen

💡 Tip: Once the shortcut is created, you can mark your fixed charges in seconds! Simply open the app from the home screen, select the charge in question, enter the amount and your balance, then validate. That's it!

📝 Shortcut advantages
  • Instant access without opening the browser
  • Mobile-optimized interface
  • Quick marking after each payment
  • Data stored locally on your device
  • Works even offline (once loaded)

9. Tips and best practices

📅 Export regularly

For accurate analysis, export your transactions regularly (every month or every quarter). The more data you have, the better the fixed charge detection will be.

✅ Validate carefully

Take the time to verify detected charges before validating them. Some transactions may be incorrectly detected as fixed charges (for example, regular purchases that are not actually fixed).

🔒 Privacy

All your data stays on your computer. StashFlow does not communicate with any external servers. Your bank information never leaves your machine.

🔄 Synchronization

If you use multiple devices, you will need to export your data manually because StashFlow works locally. To share your data, you can export your validated fixed charges to PDF.

📈 Interpreting projections

Projections are estimates based on your past data. They do not account for unexpected expenses or changes in behavior. Use them as a guide, not as an absolute guarantee.

Ready to get started?

Now that you know all of StashFlow's features, get started and analyze your finances with ease!