.TH TIKKER-AGGREGATOR 1 "2024-11-28" "Tikker 2.0" "User Commands"
.SH NAME
tikker-aggregator \- generate keystroke statistics and summaries
.SH SYNOPSIS
.B tikker-aggregator
[\fIOPTIONS\fR]
.SH DESCRIPTION
Aggregates keystroke data into statistical summaries. Provides daily, hourly,
weekly, and weekday breakdowns. Supports multiple output formats.
.SH OPTIONS
.TP
.B --daily
Generate daily statistics
.TP
.B --hourly <date>
Generate hourly stats for specific date (YYYY-MM-DD format)
.TP
.B --weekly
Generate weekly statistics
.TP
.B --weekday
Generate weekday comparison statistics
.TP
.B --top-keys [N]
Show top N most pressed keys (default: 10)
.TP
.B --top-words [N]
Show top N most typed words (default: 10)
.TP
.B --format <format>
Output format: json, csv, text (default: text)
.TP
.B --output <file>
Write output to file instead of stdout
.TP
.B --database <path>
Use custom database file (default: tikker.db)
.TP
.B --help
Display help message
.SH EXAMPLES
Generate daily statistics:
.IP
.B tikker-aggregator --daily
.PP
Generate hourly stats for specific date:
.IP
.B tikker-aggregator --hourly 2024-11-28
.PP
Generate weekly statistics in JSON format:
.IP
.B tikker-aggregator --weekly --format json --output weekly.json
.PP
Show weekday comparison:
.IP
.B tikker-aggregator --weekday
.SH OUTPUT FIELDS
.TP
.B Daily Statistics
Total Key Presses, Total Releases, Total Repeats, Total Events
.TP
.B Hourly Statistics
Hour, Presses per hour
.TP
.B Weekly Statistics
Day of week, Total presses
.TP
.B Weekday Statistics
Weekday name, Total presses, Average per hour
.SH EXIT STATUS
.TP
.B 0
Success
.TP
.B 1
Database error or invalid parameters
.SH SEE ALSO
tikker-decoder(1), tikker-indexer(1), tikker-report(1)
.SH AUTHOR
Retoor <retoor@molodetz.nl>