Update GUI with dropdown time periods and backwards compatibility

- Replace spinbox with dropdown for time periods (All time, Last month, Last year) - Add backwards compatibility for both old and new database formats - Detect database schema automatically and use appropriate queries - Fix compatibility with newer transfers.db format (StateDescription vs State)
2025-07-17 15:39:04 +02:00
commit f21c75adb0
2 changed files with 722 additions and 0 deletions
@@ -0,0 +1,122 @@
+# slskd Transfer Statistics
+
+A tool to analyze upload and download statistics from your slskd transfers database with both command-line and GUI interfaces.
+
+## Features
+
+- Analyzes uploads and downloads stored in the transfers.db database(s)
+- Automatically finds and combines data from multiple database files
+- Calculates total transfers, data transferred, and unique users
+- Shows average transfer speed and duration
+- Lists top users by data transferred
+- Shows statistics by file type
+- Filter statistics by date range
+- Graphical user interface for easier analysis
+- Maintains full command-line functionality
+
+## Requirements
+
+- Python 3.6+
+- SQLite3
+- PyQt5 (for GUI version)
+
+## Installation
+
+1. Clone or download this repository to your local machine
+2. Ensure Python 3 is installed
+3. Place your `transfers.db` file in the same directory as the script, or specify database paths using the `--db` option
+
+## Usage
+
+### Command Line Interface
+
+```bash
+# Basic usage (uses transfers.db in current directory)
+# Shows both upload and download stats by default
+./slskd_stats.py
+
+# Show only upload stats
+./slskd_stats.py --uploads
+
+# Show only download stats
+./slskd_stats.py --downloads
+
+# Explicitly show both upload and download stats (same as default)
+./slskd_stats.py --all
+
+# Specify single database file
+./slskd_stats.py --db /path/to/transfers.db
+
+# Specify multiple database files
+./slskd_stats.py --db /path/to/transfers.db --db /path/to/another-transfers.db
+
+# Only show transfers from the last 30 days
+./slskd_stats.py --days 30
+
+# Show top 15 entries in each category
+./slskd_stats.py --top 15
+
+# Combine options
+./slskd_stats.py --all --days 7 --top 20 --db /path/to/transfers.db
+```
+
+### GUI Interface
+
+```bash
+# Launch the GUI version
+./slskd_stats_gui.py
+
+# Launch GUI even when providing command line arguments
+./slskd_stats_gui.py --gui
+```
+
+With the GUI, you can:
+- Select one or more database files using the file browser
+- Choose to show upload stats, download stats, or both
+- Filter by time period (last X days)
+- Set the number of top entries to display
+- View statistics in a user-friendly tabbed interface
+
+## Example Output
+
+```
+=== UPLOAD STATISTICS ===
+
+Total Uploads: 8583
+Total Data Uploaded: 241.97 GB
+Unique Users: 650
+Average Upload Speed: 8.50 MB/s
+Average Upload Duration: 10.02 seconds
+
+--- Top Users by Data Uploaded ---
+1. username1: 279 files, 18.01 GB
+2. username2: 494 files, 12.29 GB
+3. username3: 378 files, 11.05 GB
+...
+
+--- Top File Types ---
+1. .flac: 8456 files, 241.00 GB
+2. .mp3: 105 files, 830.71 MB
+3. .m4a: 22 files, 165.58 MB
+
+=== DOWNLOAD STATISTICS ===
+
+Total Downloads: 357
+Total Data Downloaded: 10.94 GB
+Unique Users: 36
+Average Download Speed: 2.03 MB/s
+Average Download Duration: 26.21 seconds
+
+--- Top Users by Data Downloaded ---
+1. username1: 6 files, 1.45 GB
+2. username2: 58 files, 1.33 GB
+...
+```
+
+## About
+
+This tool is designed to work with the `transfers.db` SQLite database created by [slskd](https://github.com/slskd/slskd), a Soulseek client daemon. It helps you understand your sharing patterns and track transfer statistics.
+
+## License
+
+MIT