'\" t
.\"     Title: arbtt-dump
.\"    Author: Joachim Breitner <mail@joachim-breitner.de>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/19/2020
.\"    Manual: Program references
.\"    Source: arbtt manual
.\"  Language: English
.\"
.TH "ARBTT\-DUMP" "1" "06/19/2020" "arbtt manual" "Program references"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
arbtt-dump \- dumps arbtt data samples
.SH "SYNOPSIS"
.HP \w'\fBarbtt\-dump\fR\ 'u
\fBarbtt\-dump\fR [OPTION...]
.SH "DESCRIPTION"
.PP
\fBarbtt\-dump\fR
reads the data samples recorded by
arbtt\-capture(1)
and writes them so the standard output in an ascii based format\&.
.SH "OPTIONS"
.PP
\fB\-h\fR, \fB\-?\fR, \fB\-\-help\fR
.RS 4
shows a short summary of the available options, and exists\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
shows the version number, and exists\&.
.RE
.PP
\fB\-f\fR \fIFILE\fR, \fB\-\-logfile\fR \fIFILE\fR
.RS 4
logfile to use instead of
~/\&.arbtt/capture\&.log
.RE
.PP
\fB\-t\fR \fIFORMAT\fR, \fB\-\-format\fR \fIFORMAT\fR
.RS 4
dumping format to use, where
\fIFORMAT\fR
is one of
human
(the default),
show
or
JSON\&. Case in\-sensitive\&.
.RE
.PP
\fB\-l\fR \fINUMBER\fR, \fB\-\-last\fR \fINUMBER\fR
.RS 4
dump only the last
\fINUMBER\fR
of samples\&.
.RE
.SH "FILES"
.PP
~/\&.arbtt/capture\&.log
.RS 4
binary file, storing the arbtt data samples
.RE
.SH "FORMATS"
.SS "Human"
.PP
This format is intended for human inspection, but not for further processing\&. Hence, it may change in new versions of arbtt without notice\&. Example output:
.sp
.if n \{\
.RS 4
.\}
.nf
2013\-06\-20 14:53:50 (48ms inactive):
    ( ) Navigator:      arbtt\-dump \- Iceweasel
    ( ) gnome\-terminal\-server: jojo@kirk:~/projekte/programming/arbtt/doc
    (*) gvim:           arbtt\&.xml + (~/projekte/programming/arbtt/doc) \- GVIM2
.fi
.if n \{\
.RE
.\}
.PP
The line with a star indicates the currently active window\&.
.SS "Show"
.PP
This is the default serialization format of Haskell\*(Aqs
Show
type class, one entry per line\&. This can be useful if the data is to be processed by further Haskell code\&. Example output, with indentation added manually:
.sp
.if n \{\
.RS 4
.\}
.nf
TimeLogEntry
    { tlTime = 2013\-06\-20 14:53:50\&.957763 UTC
    , tlRate = 60000
    , tlData = CaptureData
        { cWindows =
            [ (False,"arbtt\-dump \- Iceweasel","Navigator")
            , (False,"jojo@kirk:~/projekte/programming/arbtt/doc","gnome\-terminal\-server")
            , (True,"arbtt\&.xml + (~/projekte/programming/arbtt/doc) \- GVIM2","gvim")
            ]
        , cLastActivity = 48
        }
    }
.fi
.if n \{\
.RE
.\}
.SS "JSON"
.PP
For interoperability, arbtt supports dumping its data to JSON, which can easily be parsed by many different programming languages\&. Some level of backward\-compatibility will be provided, as far as possible\&. Default output, again with indentation and spacing added manually:
.sp
.if n \{\
.RS 4
.\}
.nf
[ \&.\&.\&.,
  { "windows": [
      { "program": "arbtt\-dump \- Iceweasel",
        "title": "Navigator",
        "active": false},
      { "program": "jojo@kirk:~/projekte/programming/arbtt/doc",
        "title":" gnome\-terminal\-server",
        "active": false},
      { "program": "arbtt\&.xml + (~/projekte/programming/arbtt/doc) \- GVIM2",
        "title": "gvim",
        "active":true
      }],
    "inactive": 48,
    "date": "2013\-06\-20T14:53:50\&.957Z",
    "rate": 60000},
  \&.\&.\&.
]
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
See the arbtt manual for more information and the
\m[blue]\fBarbtt hackage page\fR\m[]\&\s-2\u[1]\d\s+2
for newer versions of arbtt\&.
.SH "AUTHORS"
.PP
\fBJoachim Breitner\fR <\&mail@joachim-breitner.de\&>
.RS 4
Main author of arbtt
.RE
.PP
\fBSergey Astanin\fR <\&s.astanin@gmail.com\&>
.RS 4
Contributor
.RE
.PP
\fBMartin Kiefel\fR <\&mk@nopw.de\&>
.RS 4
Contributor
.RE
.PP
\fBMuharem Hrnjadovic\fR <\&muharem@linux.com\&>
.RS 4
Contributor
.RE
.PP
\fBMarkus Hauck\fR <\&markus1189@gmail.com\&>
.RS 4
Contributor
.RE
.PP
\fBThomasz Miąsko\fR <\&tomasz.miasko@gmail.com\&>
.RS 4
Contributor
.RE
.PP
\fBWaldir Pimenta\fR <\&waldyrious@gmail.com\&>
.RS 4
Documentation writer
.RE
.PP
\fBGwern Branwen\fR <\&gwern@gwern.net\&>
.RS 4
Documentation writer
.RE
.PP
\fBPaolo G. Giarrusso\fR <\&p.giarrusso@gmail.com\&>
.RS 4
Contributor
.RE
.PP
\fBMichal J. Gajda\fR <\&migamake@migamake.com\&>
.RS 4
Contributor
.RE
.SH "NOTES"
.IP " 1." 4
arbtt hackage page
.RS 4
\%http://hackage.haskell.org/package/arbtt
.RE