subspy
SubsPy - Διαχείριση Εσόδων & Εξόδων | Income & Expense Manager (Flet/Python, Cross-platform)
📖 Τεκμηρίωση (README)
SubsPy - Διαχείριση Εσόδων & Εξόδων
Αγγλική έκδοση του README υπάρχει στο english.md.
Εφαρμογή διαχείρισης εσόδων και εξόδων, κατασκευασμένη με Python και Flet.
Τρέχει σε Windows, macOS, Linux, Raspberry Pi και Android.
Χαρακτηριστικά
- 📋 Καταχωρήσεις — Προσθήκη, επεξεργασία και διαγραφή εσόδων/εξόδων.
- 📅 Επαναλαμβανόμενες κινήσεις — Συνδρομές, μισθοί και περιοδικές κινήσεις (π.χ. μηνιαίες ή ανά προσαρμοσμένο αριθμό ημερών).
- 📊 Αναφορές & Προοδευτικά Υπόλοιπα — Υπολογισμός προοδευτικών χρεώσεων και υπολοίπων για οποιοδήποτε χρονικό διάστημα.
- 📄 Εξαγωγή PDF — Έγχρωμη αναφορά σε PDF (πράσινο = έσοδα, κόκκινο = έξοδα) με ανάλυση υπόλοιπου.
- 🏷️ Κατηγορίες — Οργάνωση κινήσεων σε προσαρμοσμένες κατηγορίες.
- 💾 Backup & Restore — Εξαγωγή και εισαγωγή όλων των δεδομένων σε JSON.
- 🔎 Πλήρες & Άμεσο Zoom — Πλήκτρα άμεσου ζουμ (+ / - / κλικ για επαναφορά στο 100%), καθώς και αναλογικό zoom με
Ctrl+ ρόδα ποντικιού. - 📐 Δυναμικοί Πίνακες — Οι στήλες καταλαμβάνουν όλο το πλάτος της οθόνης, με μόνιμη οριζόντια μπάρα κύλισης στο κάτω μέρος όταν απαιτείται.
- ❔ Ενσωματωμένη Βοήθεια — Ευρύχωρο παράθυρο οδηγιών στα Ελληνικά και Αγγλικά.
- 🖼️ Native Splash Screen — Άμεση οθόνη έναρξης με το νέο λογότυπο ποδηλάτου με ρόδες νομισμάτων (€ / $).
- 🌍 Πολυγλωσσία — Πλήρες περιβάλλον στα Ελληνικά και στα Αγγλικά.
- 🖥️ Cross-platform — Υποστήριξη Windows, macOS, Linux, Raspberry Pi και Android.
Εκτέλεση Εφαρμογής (Release)
Για να εκτελέσετε την εφαρμογή, κατεβάστε το έτοιμο εκτελέσιμο αρχείο της πιο πρόσφατης έκδοσης (π.χ. subspy.exe για Windows) από τη σελίδα των Releases του αποθετηρίου και εκτελέστε το απευθείας, χωρίς καμία ανάγκη εγκατάστασης πρόσθετων βιβλιοθηκών.
Χρήση
📋 Καταχωρήσεις
- Πατήστε «+ Προσθήκη» στην επάνω μπάρα για νέα εγγραφή.
- Επιλέξτε Έσοδο ή Έξοδο από τον επιλογέα τύπου.
- Ορίστε ημερομηνία, περιγραφή, ποσό, κατηγορία και συχνότητα επανάληψης.
- Πατήστε σε οποιαδήποτε γραμμή του πίνακα για επεξεργασία ή διαγραφή.
- Επανάληψη:
0= μοναδική κίνηση,30= μηνιαία,365= ετήσια.
📊 Αναφορές
- Μεταβείτε στην καρτέλα «Αναφορές».
- Επιλέξτε ημερομηνίες έναρξης («Από») και λήξης («Έως»).
- Πατήστε «Δημιουργία» για εμφάνιση των κινήσεων και του προοδευτικού υπολοίπου.
- Πατήστε «Εκτύπωση PDF» για άμεση δημιουργία και προβολή του αρχείου αναφοράς.
🛠️ Εργαλεία
- Εξαγωγή: Αποθηκεύει το σύνολο των εγγραφών και κατηγοριών σε αρχείο αντιγράφου ασφαλείας JSON.
- Εισαγωγή: Επαναφέρει τις εγγραφές από προηγούμενο αρχείο JSON.
- Κατηγορίες: Προσθήκη νέων και διαγραφή υπαρχουσών κατηγοριών.
🔍 Χειριστήρια Zoom & Βοήθεια
- Zoom In / Out: Χρησιμοποιήστε τα κουμπιά + και - στην επάνω μπάρα ή κρατήστε πατημένο το πλήκτρο
Ctrlκαι περιστρέψτε τη ρόδα του ποντικιού. - Επαναφορά Zoom: Πατήστε απευθείας στο ποσοστό zoom (π.χ. 100%) για άμεση επαναφορά στην αρχική διάσταση.
- Οδηγίες: Πατήστε το εικονίδιο ? στην επάνω δεξιά περιοχή για αναλυτικές οδηγίες χρήσης.
Αποθήκευση Δεδομένων
| Πλατφόρμα | Τοποθεσία Βάσης Δεδομένων (subscriptions.db) |
|---|---|
| Windows | Δίπλα στο αρχείο subspy.exe |
| Linux / Raspberry Pi | ~/subscriptions.db |
| macOS | ~/Library/Application Support/SubsPy/subscriptions.db |
| Android | Εσωτερικός ιδιωτικός χώρος εφαρμογής |
Τεχνολογίες
- Python 3.10+
- Flet 1.0+ — Σύγχρονο Cross-platform UI Framework
- SQLite — Ενσωματωμένη τοπική βάση δεδομένων
- ReportLab — Μηχανή παραγωγής εγγράφων PDF
- Pillow — Επεξεργασία και βελτιστοποίηση γραφικών
Ιστορικό Εκδόσεων
v5.0.3 — Οκτώβριος 2026
- Αφαίρεση παλιών περιττών αρχείων εικόνων και βελτιστοποίηση μεγέθους του εκτελέσιμου αρχείου.
- Αναδιοργάνωση και εναρμόνιση της τεκμηρίωσης (README στα Ελληνικά και Αγγλικά).
v5.0.2 — Οκτώβριος 2026
- Καθαρό splash screen και ανανεωμένο εικονίδιο εφαρμογής με το ποδήλατο νομισμάτων (€ / $) χωρίς περιττό κείμενο.
- Βελτιωμένη ενσωμάτωση γραφικών στο εκτελέσιμο αρχείο.
v5.0.1 — Οκτώβριος 2026
- Νέο λογότυπο και εικονίδιο εφαρμογής με σχεδιασμό ποδηλάτου με ρόδες νομισμάτων (€ και $).
- Προσθήκη εγγενούς οθόνης έναρξης (native bootloader splash screen).
- Δημιουργία και διάθεση νέου εκτελέσιμου αρχείου release.
v5.0.0 — Οκτώβριος 2026
- Αναβάθμιση σε Flet 1.0.5 και εκσυγχρονισμός του περιβάλλοντος εκτέλεσης.
- Δυναμική προσαρμογή στηλών πινάκων ώστε να καλύπτουν πλήρως το πλάτος της οθόνης.
- Νέα άμεσα κουμπιά zoom (+ / - / κλικ για επαναφορά στο 100%) και αναλογικό zoom με Ctrl + ρόδα ποντικιού.
- Μόνιμη εμφάνιση οριζόντιας μπάρας κύλισης στο κάτω μέρος της οθόνης σε υψηλό zoom.
- Ευρύχωρο παράθυρο βοήθειας (800px) με ευανάγνωστη γραμματοσειρά και ανανεωμένη διάταξη.
v4.09 — Ιούλιος 2026
- Διορθώσεις συμβατότητας και εξάλειψη σφάλματος κατά την εκκίνηση του εκτελέσιμου αρχείου.
v4.08 — Ιούνιος 2026
- Προσαρμογή μεγέθους πινάκων DataTable για αξιόπιστο υπολογισμό scrollbars και αποφυγή αποκοπής γραμμών στο zoom.
v4.07 — Ιούνιος 2026
- Βελτιστοποίηση συμπεριφοράς διάταξης κατά την οριζόντια κύλιση.
v4.06 — Ιούνιος 2026
- Διόρθωση κάθετης κύλισης σε περιβάλλον zoom.
v4.05 — Ιούνιος 2026
- Εμφανείς μπάρες κύλισης στους πίνακες Καταχωρήσεων και Αναφορών.
v4.04 — Ιούνιος 2026
- Μεταφορά του κουμπιού + Προσθήκη στην επάνω γραμμή εργαλείων.
- Βελτίωση δυναμικού ορίου zoom.
v4.03 — Ιούνιος 2026
- Βελτιστοποίηση τοποθέτησης χειριστηρίων zoom και ασφαλούς περιθωρίου προβολής.
v4.02 — Ιούνιος 2026
- Ενσωμάτωση εικονιδίου οδηγιών και αναλογικού zoom.
v4.01 — Μάρτιος 2026
- Διορθώσεις απεικόνισης γραφικών και εικονιδίων.
v4.00 — Μάρτιος 2026
- Προοδευτικά υπόλοιπα στις αναφορές και στα παραγόμενα PDF.
- Υποστήριξη μηνιαίων επαναλήψεων ("Κάθε μήνα").
- Φορητή βάση δεδομένων subscriptions.db δίπλα στο εκτελέσιμο στα Windows.
- Layout και διορθώσεις σφαλμάτων.
v2.0 — Φεβρουάριος 2026
- Ολοκληρωμένη διαχείριση εσόδων και εξόδων.
- Cross-platform υποστήριξη (Windows, macOS, Linux, Android, Raspberry Pi).
- Ελληνικά DatePickers.
- Εξαγωγή PDF με χρωματική διάκριση εσόδων και εξόδων.
- Διαχείριση κατηγοριών και εισαγωγή/εξαγωγή JSON.
v1.0 — Δεκέμβριος 2025
- Αρχική έκδοση διαχείρισης συνδρομών.
Άδεια Χρήσης
MIT License
🇬🇧 English Documentation
SubsPy - Income & Expense Management
Greek version of the README is available at README.md.
An income and expense management application built with Python and Flet.
Runs on Windows, macOS, Linux, Raspberry Pi, and Android.
Features
- 📋 Entries — Add, edit, and delete income and expense records.
- 📅 Recurring Transactions — Subscriptions, salaries, and periodic entries (e.g., monthly or customized day intervals).
- 📊 Reports & Running Balances — Running balances and summaries for any selected date range.
- 📄 PDF Export — Color-coded PDF reports (green = income, red = expenses) with complete balance breakdown.
- 🏷️ Categories — Organize transactions into custom categories.
- 💾 Backup & Restore — Export and import all application data via JSON.
- 🔎 Instant & Analog Zoom — Direct zoom buttons (+ / - / click percentage to reset), plus smooth
Ctrl+ mouse wheel scaling. - 📐 Dynamic Table Layout — Columns automatically expand to fill 100% of the screen width, with a pinned bottom horizontal scrollbar when zooming.
- ❔ Built-in Instructions — Spacious, comfortable help window available in both Greek and English.
- 🖼️ Native Splash Screen — Instant startup screen featuring the currency bicycle emblem (€ and $ wheels).
- 🌍 Bilingual Support — Full UI support for Greek and English.
- 🖥️ Cross-platform — Native experience across Windows, macOS, Linux, Raspberry Pi, and Android.
Running the Application (Release)
To run the application, download the pre-built standalone executable of the latest release (e.g., subspy.exe for Windows) from the Releases page and run it directly without installing external dependencies.
Usage
📋 Entries
- Click "+ Add" in the top control group to create a new entry.
- Select Income or Expense from the type picker.
- Specify date, description, amount, category, and recurrence days.
- Click any table row to edit or delete that entry.
- Recurrence:
0= one-off entry,30= monthly,365= annual.
📊 Reports
- Switch to the "Reports" tab.
- Select start ("From") and end ("To") dates.
- Click "Generate" to compute running balances and list all matching transactions.
- Click "Print PDF" to create and view the printable PDF report.
🛠️ Tools
- Export: Exports all transactions and categories into a JSON backup file.
- Import: Restores records from a previously exported JSON backup.
- Categories: Create new or delete existing custom categories.
🔍 Zoom Controls & Help
- Zoom In / Out: Use the + and - buttons on the top bar or hold
Ctrland scroll the mouse wheel. - Reset Zoom: Click directly on the zoom percentage button (e.g., 100%) to immediately return to default scaling.
- Help: Click the ? button at the top right for detailed built-in guidance.
Data Storage
| Platform | Database Location (subscriptions.db) |
|---|---|
| Windows | Next to the subspy.exe file |
| Linux / Raspberry Pi | ~/subscriptions.db |
| macOS | ~/Library/Application Support/SubsPy/subscriptions.db |
| Android | Application internal private storage |
Technologies
- Python 3.10+
- Flet 1.0+ — Modern Cross-platform UI Framework
- SQLite — Embedded local database
- ReportLab — PDF generation engine
- Pillow — Image asset processing and rendering
Version History
v5.0.3 — October 2026
- Removed obsolete image assets from the repository to optimize release package size.
- Harmonized and structured user documentation (README in Greek and English).
v5.0.2 — October 2026
- Clean, text-free splash screen and refreshed currency bicycle icon (€ / $ wheels).
- Polished asset integration in the standalone executable.
v5.0.1 — October 2026
- New application icon and branding featuring a currency bicycle with Euro (€) and Dollar ($) wheels.
- Added native bootloader splash screen.
- Published updated release executable.
v5.0.0 — October 2026
- Upgraded to Flet 1.0.5 and modernized runtime dependencies.
- Table columns now dynamically expand to occupy the full width of the screen.
- Added direct zoom buttons (+ / - / click percentage to reset) and smooth Ctrl + mouse wheel zoom.
- Permanently visible bottom horizontal scrollbar when zooming beyond 125%.
- Enlarged instructions dialog (800px) with comfortable typography.
v4.09 — July 2026
- Compatibility fixes and resolution of executable startup errors.
v4.08 — June 2026
- Replaced transform-based zoom with true DataTable sizing for accurate scrollbar calculations.
v4.07 — June 2026
- Layout optimizations for horizontal scrolling stability.
v4.06 — June 2026
- Fixed vertical scrolling in zoomed view to prevent row truncation.
v4.05 — June 2026
- Visible horizontal and vertical scrollbars for Entries and Reports tables.
v4.04 — June 2026
- Relocated + Add button to the top toolbar with green highlight.
- Enhanced dynamic zoom boundary calculations.
v4.03 — June 2026
- Refined toolbar controls layout and safe screen margin constraints.
v4.02 — June 2026
- Integrated in-app instructions dialog and analog zoom support.
v4.01 — March 2026
- Icon and UI rendering fixes.
v4.00 — March 2026
- Running balances in Reports and PDF exports.
- Support for monthly recurrence intervals.
- Portable subscriptions.db database alongside executable on Windows.
- Layout enhancements and bug fixes.
v2.0 — February 2026
- Complete income and expense tracking.
- Cross-platform support (Windows, macOS, Linux, Android, Raspberry Pi).
- Greek DatePickers.
- Color-coded PDF export.
- Category management and JSON backup/restore.
v1.0 — December 2025
- Initial release for subscription management.
License
MIT License
🚀 Εκδόσεις & Releases
Published: 24 Oct 2026, 16:03
Release v5.0.3: Native PyInstaller splash screen, text-free currency bicycle icon, optimized binary package size, and updated documentation.
- ⬇️ subspy.exe (103.84 MB)