80 lines
1.7 KiB
Groff
Raw Normal View History

2025-11-29 00:50:53 +01:00
.TH TIKKER-REPORT 1 "2024-11-28" "Tikker 2.0" "User Commands"
.SH NAME
tikker-report \- generate HTML activity reports
.SH SYNOPSIS
.B tikker-report
[\fIOPTIONS\fR]
.SH DESCRIPTION
Generates comprehensive HTML reports of keystroke activity. Can include
embedded graphs and statistics summaries.
.SH OPTIONS
.TP
.B --input <dir>
Input logs directory (default: logs_plain)
.TP
.B --output <file>
Output HTML file (default: report.html)
.TP
.B --graph-dir <dir>
Directory containing PNG graphs to embed
.TP
.B --include-graphs
Enable embedding of PNG graphs from graph-dir
.TP
.B --database <path>
Use custom database file (default: tikker.db)
.TP
.B --title <title>
Report title
.TP
.B --help
Display help message
.SH EXAMPLES
Generate default HTML report:
.IP
.B tikker-report
.PP
Generate report with custom output file:
.IP
.B tikker-report --output activity-report.html
.PP
Generate report with embedded graphs:
.IP
.B tikker-report --include-graphs --graph-dir ./graphs --output report.html
.PP
Custom input directory:
.IP
.B tikker-report --input ./logs --output ./reports/activity.html
.SH OUTPUT
Generates an HTML file containing:
\- Activity statistics (total presses, releases, repeats)
\- Report generation timestamp
\- Embedded PNG graphs (if enabled)
\- Styled with dark theme for readability
.SH HTML STRUCTURE
.IP
<html>
.IP
<head> - Embedded CSS styling
.IP
<body>
.IP
<h1> - Report title
.IP
<div class="stats"> - Statistics section
.IP
</body>
.IP
</html>
.SH EXIT STATUS
.TP
.B 0
Success
.TP
.B 1
Database error, invalid parameters, or output file error
.SH SEE ALSO
tikker-decoder(1), tikker-indexer(1), tikker-aggregator(1)
.SH AUTHOR
Retoor <retoor@molodetz.nl>