'\" t
.\"
.\" === DO NOT EDIT — generated from util/tspin.adoc by util/generate_man_pages.sh ===
.\"
.\"     Title: tspin
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-07-14
.\"    Manual: tailspin
.\"    Source: tailspin 7.0.0
.\"  Language: English
.\"
.TH "TSPIN" "1" "2026-07-14" "tailspin 7.0.0" "tailspin"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
tspin \- A log file highlighter
.SH "SYNOPSIS"
.sp
\fBtspin\fP [\fIOPTION\fP].\|.\|. [\fIFILE\fP].\|.\|.
.SH "DESCRIPTION"
.sp
tailspin is a command line tool that highlights log files.
.SH "OPTIONS"
.sp
\fI\-f, \-\-follow\fP
.RS 4
Follow (tail) the contents of the file.
Always true when using the \fI\-\-exec\fP flag.
.RE
.sp
\fI\-p, \-\-print\fP
.RS 4
Print the output to stdout instead of viewing the contents in the pager \fIless\fP.
Always true if using stdin.
.RE
.sp
\fI\-\-theme\fP \fBPATH\fP
.RS 4
Specify the path to a custom theme file.
Defaults to \fBXDG_CONFIG_HOME/tailspin/theme.toml\fP or \fB~/.config/tailspin/theme.toml\fP if not set.
On Windows, defaults to \fB%APPDATA%\(rstailspin\(rstheme.toml\fP.
Can also be set via the \fITAILSPIN_THEME\fP environment variable.
.RE
.sp
\fI\-e, \-\-exec\fP \fBCOMMAND\fP
.RS 4
Run command and view the output in a pager.
The command traps the interrupt signal to allow for cancelling and resuming follow mode while inside \fIless\fP.
.sp
.B Example:
.br
.sp
.if n .RS 4
.nf
.fam C
tspin \-\-exec \*(Aqkubectl logs \-f pod_name\*(Aq
.fam
.fi
.if n .RE
.RE
.sp
\fI\-\-highlight\fP \fBCOLOR1\fP:\fIword1,word2,.\|.\|.\fP \fBCOLOR2\fP:\fIword3,word4,.\|.\|.\fP
.RS 4
Highlight the provided comma\-separated words in the specified color.
Possible colors are black, red, green, yellow, blue, magenta, cyan, and white, optionally prefixed with bright_ (e.g. bright_red).
.sp
.B Example:
.br
.sp
.if n .RS 4
.nf
.fam C
tspin logfile.txt \-\-highlight red:error,fail \-\-highlight green:success,ok
.fam
.fi
.if n .RE
.RE
.sp
\fI\-\-enable=[HIGHLIGHT_GROUP]\fP
.RS 4
Disable all highlighting groups except the ones specified.
Comma separated list of groups.
Cannot be used with \fB\-\-disable=[HIGHLIGHT_GROUP]\fP.
Possible groups: numbers, urls, emails, pointers, dates, durations, paths, quotes, key\-value\-pairs, uuids, ipv4, processes, json, keywords.
.RE
.sp
\fI\-\-disable=[HIGHLIGHT_GROUP]\fP
.RS 4
Disable the specified highlighting groups.
Comma separated list of groups.
Cannot be used with \fB\-\-enable=[HIGHLIGHT_GROUP]\fP.
The \fIkeywords\fP group controls the builtin keywords (booleans, nulls, log severities and common REST verbs); keywords from the config file and the \fB\-\-highlight\fP flag always apply.
Possible groups: numbers, urls, emails, pointers, dates, durations, paths, quotes, key\-value\-pairs, uuids, ipv4, processes, json, keywords.
.RE
.sp
\fI\-\-extras=[EXTRA]\fP
.RS 4
Enable extra highlighters.
Comma separated list of extras.
Possible values: ipv6, jvm\-stack\-trace.
Can also be set via the \fITAILSPIN_EXTRAS\fP environment variable.
.RE
.sp
\fI\-\-pager\fP \fBCOMMAND\fP
.RS 4
Override the default pager command used by tspin.
The command must include the string \fI[FILE]\fP which will be replaced with the file path internally.
.sp
.B Example:
.br
.sp
.if n .RS 4
.nf
.fam C
tspin logfile.txt \-\-pager "ov \-f [FILE]"
.fam
.fi
.if n .RE
.RE
.sp
\fI\-\-completions\fP \fBSHELL\fP
.RS 4
Print shell completions to stdout.
Possible values: bash, elvish, fish, powershell, zsh.
.RE
.sp
\fI\-\-generate\-default\-theme\fP
.RS 4
Print the default theme as a theme.toml to stdout.
Every value in the output is a default: copy it to \fB~/.config/tailspin/theme.toml\fP and edit the styles you want to override.
.RE
.SH "ENVIRONMENT VARIABLES"
.sp
\fBTAILSPIN_PAGER\fP
.RS 4
Set the \fITAILSPIN_PAGER\fP environment variable to override the default pager.
Equivalent to the \fB\-\-pager\fP flag.
The command must include the string \fI[FILE]\fP which will be replaced with the file path internally.
For example, \fI"ov \-f [FILE]"\fP.
.RE
.sp
\fBTAILSPIN_EXTRAS\fP
.RS 4
Comma separated list of extras to enable by default.
Equivalent to the \fB\-\-extras\fP flag.
For example, \fI"jvm\-stack\-trace"\fP or \fI"ipv6,jvm\-stack\-trace"\fP.
.RE
.sp
\fBTAILSPIN_THEME\fP
.RS 4
Path to the theme file to use.
Equivalent to the \fB\-\-theme\fP flag.
.RE
.SH "SEE ALSO"
.sp
\fBless\fP(1), \fBtail\fP(1)
.SH "ABOUT"
.sp
Ben Sadeh (github.com/bensadeh/tailspin)
.sp
Released under the MIT License