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

-- Config --