Ko-fi Stats¶

A cross-platform desktop application that reads your Ko-fi transaction CSV export and generates detailed statistics, reports, and charts about your donations, subscriptions, and product sales.

Ko-fi Stats is an independent third-party application. It is not an official Ko-fi product and is not affiliated with, endorsed by, or sponsored by Ko-fi.

Features¶

Reports and Statistics¶

Summary Overview

• Total transaction count and date range covered
• Number of unique supporters
• Total received (income) and total given (expenses), tracked separately

Monthly Revenue

• Revenue broken down by year and month
• Three interactive chart modes:
  • Monthly Comparison — grouped vertical bar chart, one bar per year within each month
  • Monthly Trends — line chart showing revenue progression per year
  • Year Totals — vertical bar chart comparing total revenue per year

Top Supporters

• Top 20 supporters for the last 90 days, ranked by amount received
• Top 20 supporters of all time, ranked by amount received
• Both lists include transaction count per supporter

Product Sales (Shop Orders)

• Sales breakdown per product: units sold, total revenue, paid downloads, free downloads with percentages
• Unique user analysis per product: paid at least once, only free, also got free copies
• Monthly trend data table showing revenue per product across all months
• Four interactive chart modes:
  • Revenue — total revenue per product
  • Units — total units sold per product
  • Paid / Free — paid vs free download counts per product
  • Monthly Trend — chronological line chart with one line per product

Subscriptions

• Breakdown of Monthly Tip subscription tiers
• Count, received income, and expenses per tier
• Monthly trend line chart by tier across years using only non-expense subscription rows (Given = 0)

Currency Breakdown

• Transactions and totals grouped by currency
• Received income and expenses tracked per currency

Expenses

• Monthly expense amounts (outgoing money) for each year
• Year totals shown when expenses exist
• Three interactive chart modes matching the Monthly Revenue tab:
  • Monthly Comparison, Monthly Trends, Year Totals

Export¶

• Export all report data to a single Markdown file (.md)
• All sections from the app are included:
  1. Summary Overview
  2. Revenue by Transaction Type (with expenses)
  3. Revenue by Year and Month (with expenses column)
  4. Top Supporters — Last 90 Days and All Time
  5. Product Sales — units, revenue, paid/free breakdown, unique users, monthly trend data
  6. Subscription Tiers
  7. Currency Breakdown
  8. Monthly Expenses

General¶

• Preferences saved automatically (window size and position, last loaded CSV path)
• DPI-aware rendering for sharp display on high-resolution monitors
• Multi-year color coding across all charts for consistent visual identification

How to Use¶

1. Export your transaction history from Ko-fi:
   • Log in to Ko-fi → Payments and orders → Export CSV (click the CSV button above the list at the right)
2. Launch Ko-fi Stats
3. Use File → Load CSV file... and select your exported .csv file
4. Browse the report tabs to explore your data
5. Use File → Export report... to save a full Markdown report

Privacy and Data Security¶

Ko-fi Stats processes your CSV file locally on your computer.

• The application does not upload your CSV data anywhere
• The application does not connect to any online service to process reports
• No transaction data is shared with third parties
• Your CSV remains under your control on your local machine

Loading a CSV in Ko-fi Stats is an offline operation. Your financial data stays private and secure within your local environment.

Important Disclaimers¶

• Ko-fi Stats provides reporting and visualization features only. It does not provide accounting, tax, legal, or financial advice.
• Results depend on the CSV data exported from Ko-fi. Please verify critical totals before making business or tax decisions.
• Totals are shown per currency. Values from different currencies are not automatically converted and should not be interpreted as a single combined monetary value.
• The application stores only local preferences (for example window size/position and last CSV path). It does not upload report data to online services.
• Ko-fi is a trademark of its respective owner. The name is used only to describe compatibility with Ko-fi CSV exports.
• The software is provided "as is" without warranties; use it at your own risk.

Platform Support¶

Ko-fi Stats is built with Hollywood MAL and runs natively on:

CSV Format¶

The application expects a standard Ko-fi transaction CSV export (UTF-8 with BOM). It handles all Ko-fi transaction types:

• Tip — one-time donations
• Monthly Tip — recurring subscription payments
• Shop Order — digital product purchases, including multi-item orders

Author¶

Copyright © 2026 George Sokianos