Config
Tut is configurable, so you can change things like the colors, the default timeline, what image viewer to use and some more.
You find it in XDG_CONFIG_HOME/tut/config.ini which usally equals to ~/.config/tut/config.ini.
In the git-repo you can find a example.config.ini. It contains the default values. And can be good to look at for reference.
General config
Section [general] in your config
auto-load-newer
If the program should check for new toots without user interaction. If you don't enable this the program will only look for new toots when you reach the bottom or top of your feed. With this enabled it will check for new toots every x second.
default=true
auto-load-seconds
How many seconds between each pulling of new toots if you have enabled auto-load-newer
default=60
date-format
The date format to be used. See Go time#Time.Format
default=2006-01-02 15:04
date-today-format
Format for dates the same day. See date-format for more info.
default=15:04
date-relative
This displays relative dates instead for statuses that are one day or older the output is 1y2m1d (1 year 2 months and 1 day)
The value is an integear
-1 = don't use relative dates
0 = always use relative dates, except for dates < 1 day
1 - ∞ = number of days to use relative dates
Example: date-relative=28 will display a relative date for toots that are between 1-28 days old. Otherwhise it will use the short or long format.
default=-1
timeline
The timeline that opens up when you start tut.
Valid values: home, direct, local, federated
default=home
max-width
The max width of text before it wraps when displaying toots.
0 = no restriction.
default=0
notification-feed
If you want to display a list of notifications under your timeline feed.
default=true
list-placement
Where do you want the list of toots to be placed?
Valid values: left, right, top, bottom.
default=left
list-split
If you have notification-feed set to true you can display it under the main list of toots (row) or place it to the right of the main list of toots (column).
default=row
hide-notification-text
Hide notification text above list in column split. It's displayed as [N]otifications.
default=false
list-proportion
You can change the proportions of the list view in relation to the content view list-proportion=1 and content-proportoin=3 will result in the content taking up 3 times more space.
Must be n > 0
default=1
content-proportion
See list-proportion for more info
default=2
quote-reply
If you always want to quote original message when replying.
default=false
char-limit
If you're on an instance with a custom character limit you can set it here.
default=500
show-icons
If you want to show icons in the list of toots.
default=true
short-hints
If you've learnt all the shortcut keys you can remove the help text and only show the key in tui. So it gets less cluttered.
default=false
show-help
If you want to show a message in the cmdbar on how to access the help text.
default=true
redraw-ui
If you don't want the whole UI to update, and only the text content you can set this option to true. This will lead to some artifacts being left on the screen when emojis are present. But it will keep the UI from flashing on every single toot in some terminals.
default=true
Media config
Section [media] in your config
image-viewer
Your image viewer.
default=xdg-open
image-terminal
Open the image viewer in the same terminal as toot. Only for terminal based viewers.
default=false
image-single
If images should open one by one e.g. "imv image.png" multiple times. If set to false all images will open at the same time like this "imv image1.png image2.png image3.png". Not all image viewers support this, so try it first.
default=true
image-reverse
If you want to open the images in reverse order. In some image viewers this will display the images in the "right" order.
default=false
video-viewer
Your video viewer.
default=xdg-open
video-terminal
Open the video viewer in the same terminal as toot. Only for terminal based viewers.
default=false
video-single
If videos should open one by one. See image-single.
default=true
video-reverse
If you want your videos in reverse order. In some video apps this will play the files in the "right" order.
default=false
audio-viewer
Your audio viewer.
default=xdg-open
audio-terminal
Open the audio viewer in the same terminal as toot. Only for terminal based viewers.
default=false
audio-single
If audio should open one by one. See image-single.
default=true
audio-reverse
If you want to play the audio files in reverse order. In some audio apps this will play the files in the "right" order.
default=false
link-viewer
Your web browser.
default=xdg-open
link-terminal
Open the browser in the same terminal as toot. Only for terminal based browsers.
default=false
Open-Custom config
Section [open-custom] in your config
This sections allows you to set up to five custom programs to upen URLs with. If the url points to an image, you can set c1-name to img and c1-use to imv. If the program runs in a terminal and you want to run it in the same terminal as tut. Set cX-terminal to true. The name will show up in the UI, so keep it short so all five fits.
c1-name=name
c1-use=program
c1-terminal=false
c2-name=name
c2-use=program
c2-terminal=false
c3-name=name
c3-use=program
c3-terminal=false
c4-name=name
c4-use=program
c4-terminal=false
c5-name=name
c5-use=program
c5-terminal=false
Open-Pattern config
Section [open-pattern] in your config
Here you can set your own glob patterns for opening matching URLs in the program you want them to open up in. You could for example open Youtube videos in your video player instead of your default browser.
You must name the keys foo-pattern, foo-use and foo-terminal, where use is the program that will open up the URL. To see the syntax for glob pattern you can follow this URL https://github.com/gobwas/glob#syntax. foo-terminal is if the program runs in the terminal and should open in the same terminal as tut itself.
Example for youtube.com and youtu.be to open up in mpv instead of the browser.
y1-pattern=*youtube.com/watch*
y1-use=mpv
y1-terminal=false
y2-pattern=*youtu.be/*
y2-use=mpv
y2-terminal=false
Desktop-Notification config
Section [desktop-notification] in your config
followers
Notification when someone follows you.
default=false
favorite
Notification when someone favorites one of your toots.
default=false
mention
Notification when someone mentions you.
default=false
boost
Notification when someone boosts one of your toots.
default=false
poll
Notification of poll results.
default=false
posts
Notification when there is new posts in current timeline.
default=false
Style config
Section [style] in your config
All styles can be represented in their HEX value like #ffffff or with their name, so in this case white. The only special value is "default" which equals to transparent, so it will be the same color as your terminal.
You can also use xrdb colors like this xrdb:color1 The program will use colors prefixed with an * first then look for URxvt or XTerm if it can't find any color prefixed with an asterik. If you don't want tut to guess the prefix you can set the prefix yourself. If the xrdb color can't be found a preset color will be used.
xrdb-prefix
The xrdb prefix used for colors in .Xresources.
default=guess
background
The background color used on most elements.
default=xrdb:background
text
The text color used on most of the text.
default=xrdb:foreground
subtle
The color to display sublte elements or subtle text. Like lines and help text.
default=xrdb:color14
warning-text
The color for errors or warnings
default=xrdb:color1
text-special-one
This color is used to display username.
default=xrdb:color5
text-special-two
This color is used to display username and key hints.
default=xrdb:color2
top-bar-background
The color of the bar at the top
default=xrdb:color5
top-bar-text
The color of the text in the bar at the top.
default=xrdb:background
status-bar-background
The color of the bar at the bottom
default=xrdb:color5
status-bar-text
The color of the text in the bar at the bottom.
default=xrdb:foreground
status-bar-view-background
The color of the bar at the bottom in view mode.
default=xrdb:color4
status-bar-view-text
The color of the text in the bar at the bottom in view mode.
default=xrdb:foreground
list-selected-background
Background of selected list items.
default=xrdb:color5
list-selected-text
The text color of selected list items.
default=xrdb:background