tut(5)

📦 version 2.0.1, in alpine 3.24, opensuse-leap 16.0

🌸 tut(5) 🌸

okay bestie, welcome to tut(5) — the man page for tut, and this one is about the configuration file specifically. it's giving "settings menu but make it a whole document" and honestly? iconic. let's get into it. 💅

✨ NAME ✨

tut — configuration for tut(1)

like, the config for the thing. the (1) one. yes. 🎀

🦋 DESCRIPTION 🦋

this is the configuration format for tut. periodt.

where do you find it? on Linux it lives at $XDG_CONFIG_HOME/tut/config.toml, which usually equals ~/.config/tut/config.toml. if you don't run Linux, it'll use the path of the Go function os.UserConfigDir(). but — plot twist — if you move the tut folder to XDG_CONFIG_HOME/tut/ and you have set the environment variable XDG_CONFIG_HOME, it will look there instead of the standard place. so you got options, bestie. 🫶

🌈 CONFIGURATION 🌈

the configuration file is split into seven sections, named general, media, open-custom, open-pattern, desktop-notification, style and input.

under each section you'll find the name of the configuration option. and the last line under each option shows the default value. so if you're ever like "wait what does it do out of the box", the answer is literally right there. ⭐

💜 GENERAL 💜

this section is [general] in your configuration file. yes that's the literal header. cute.

  • editor — what editor to use. TUT_USE_INTERNAL will use the editor that comes with tut. if you want, you can set this to $EDITOR to use your environment variable, or vim if you want to specify the program directly. default: editor="TUT_USE_INTERNAL" 🔥
  • confirmation — you need to press yes in a confirmation dialog before favoriting, boosting, etc. safety girlies rise. default: confirmation=true
  • mouse-support — enable mouse support in tut. default: mouse-support=false
  • date-format — the date format to be used. see https://pkg.go.dev/time#pkg-constants for the full lore. default: date-format="2006-01-02 15:04"
  • date-tody-format — format for dates the same day. see date-format for more info. (yes the key is literally spelled date-tody-format, no i'm not fixing it, that's what the file wants 💀) default: date-tody-format="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 integer:

  • -1 = don't use relative dates
  • 0 = always use relative dates, except for dates < 1 day
  • 1 - ∞ = number of days to use relative dates

so value 28 will display a relative date for toots that are between 1-28 days old. otherwise it will use the short or long format. default: date-relative=-1

  • max-width — the max width of text before it wraps when displaying a toot. default: max-width=0
  • list-placement — the placement of your panes.

valid: left, right, top, bottom

default: list-placement="left"

  • list-split — how should panes be split?

valid: row, column

default: list-split="row"

  • list-proportion — the proportion of panes vs. content. 1 on this and 3 on content below results in content taking up 3 times more space. math slay. default: list-proportion=1
  • content-proportion — see previous. yeah. literally that. default: content-proportion=2
  • notifications-to-hide — hide notifications of this type in your notification timelines.

valid: mention, status, boost, follow, follow_request, favorite, poll, edit

default: notifications-to-hide=[]

  • quote-reply — always include a quote of the message you're replying to. default: quote-reply=false
  • show-icons — if you want to show icons in timelines. default: show-icons=true
  • short-hints — if you only want to use the letter of keys instead of the full hint. default: short-hints=false
  • show-filter-phrase — if you want to display the filter that filtered a toot. default: show-filter-phrase=true
  • show-help — display a message in the commandbar on how to access the help text. default: show-help=true
  • stick-to-top — always jump to the newest post. ⚠️ may ruin your reading experience. bestie, it said it, not me. default: stick-to-top=false
  • show-boosted-user — display the username of the person being boosted instead of the person that boosted. default: show-boosted-user=false
  • commands-in-new-pane — open a new pane when you run a command like :timeline home. default: commands-in-new-pane=true
  • dynamic-timeline-name — set a default name for the timeline if the name is empty. so if you run :tag linux the title of the pane will be set to #linux. default: dynamic-timeline-name=true
  • terminal-title —
    • 0 = no terminal title
    • 1 = show title in terminal and top bar
    • 2 = only show terminal title, and no top bar in tut
    • 3 = no terminal title and no top bar in tut

valid: 0, 1, 2, 3

default: terminal-title=0

  • redraw-ui — if you don't want the whole UI to update, and only update the text content, you can disable this. ⚠️ this will lead to some artifacts being left on the screen when emojis are present. (the emoji girlies are being warned directly.) default: redraw-ui=true
  • leader-key — the leader is used as a shortcut to run commands as you can do in Vim. by default this is disabled and you enable it by setting a key here. it can only consist of one char, so set it to something like a comma. default: leader-key=""
  • leader-timeout — number of milliseconds before the leader command resets. so if you tap the leader-key by mistake, or you're too slow, it empties all the input after X milliseconds. default: leader-timeout=1000

🧚 GENERAL.TIMELINES 🧚

this section is [[general.timelines]] in your configuration file. and you can have multiple of them, bestie. go off.

timelines add panes of feeds. you can customize the number of feeds, what they should show, and the key to activate them.

example:

[[general.timelines]]
name="home"
type="home"
hide-boosts=false
hide-replies=false

[[general.timelines]]
name="Notifications"
type="notifications"
keys=["n", "N"]
closed=true
on-creation-closed="new-pane"
on-focus="focus-self"
  • name — the name to display above the timeline. default: name=""
  • type — the type of the timeline.

valid: home, direct, local, federated, bookmarks, saved, favorited, notifications, lists, mentions, tag

default: type=""

  • data — used for the tag type, so here you set the tag. if you have multiple you separate them with a space. default: data=""
  • keys — a list of keys to give this timeline focus. see under the input section to learn more about keys. default: keys=[]
  • special-keys — a list of special-keys to give this timeline focus. see under the input section to learn more about special-keys. default: special-keys=[]
  • shortcut — a shortcut to give this timeline focus with your leader-key + this shortcut. default: shortcut=""
  • hide-boosts — hide boosts in this timeline. default: hide-boosts="false"
  • hide-replies — hide replies in this timeline. default: hide-replies="false"
  • closed — don't open this timeline when you start tut. use your keys or shortcut to open it. default: closed="false"
  • on-creation-closed — don't open this timeline when you start tut. use your keys or shortcut to open it.

valid: new-pane, current-pane

default: on-creation-closed="new-pane"

  • on-focus — don't open this timeline when you start tut. use your keys or shortcut to open it.

valid: focus-pane, focus-self

default: on-focus="focus-pane"

👑 GENERAL.LEADER-ACTIONS 👑

this section is [[general.leader-actions]] in your configuration file. you can have multiple of them. we stan a repeatable section. 💖

you set actions for leader-key with one or more leader-actions.

the shortcuts are up to you, but keep them quite short and make sure they don't collide. ⚠️ if you have one shortcut that is "f" and another one that is "fav", the one with "f" will always run and "fav" will never run. no cap. watch your keys.

some special actions that require data to be set:

  • pane is special as it's a shortcut for switching between the panes you've set under general, and they are zero indexed. pane 0 = your first timeline, pane 1 = your second and so on.
  • list-placement as it takes the argument top, right, bottom or left
  • list-split as it takes the argument column or row
  • proportions takes the arguments [int] [int], where the first integer is the list and the other content, e.g. proportions 1 3. see list-proportion above for more information.

example:

[[general.leader-actions]]
type="close-pane"
shortcut="q"

[[general.leader-actions]]
type="list-split"
data="row"
shortcut="r"

[[general.leader-actions]]
type="list-split"
data="column"
shortcut="c"
  • type — the action you want to run.

valid: blocking, boosts, clear-notifications, close-pane, compose, edit, favorited, favorites, followers, following, history, list-placement, list-split, lists, move-pane-left, move-pane-right, move-pane-up, move-pane-down, move-pane-home, move-pane-end, muting, newer, pane, preferences, profile, proportions, refetch, stick-to-top, tags

default: type=""

  • data — data to pass to the action. default: data=""
  • shortcut — a shortcut to run this action with your leader-key + this shortcut. default: shortcut=""

🍓 MEDIA 🍓

this section is [media] in your configuration file.

  • delete-temp-files — media files will be removed directly after they've been opened. some programs don't like this, so if your media doesn't open, try setting this to false. tut will remove all files once you close the program. default: delete-temp-files=true

🎀 MEDIA.IMAGE 🎀

this section is [media.image] in your configuration file.

  • program — the program to open images. TUT_OS_DEFAULT equals xdg-open on Linux, open on MacOS and start on Windows. default: program="TUT_OS_DEFAULT"
  • args — arguments to pass to the program. default: args=""
  • terminal — if the program runs in the terminal, set this to true. default: terminal=false
  • single — if the program should be called multiple times when there are multiple files. if set to false all files will be passed as an argument, but not all programs support this. default: single=true
  • reverse — if the files should be passed in reverse order. this will make some programs display the files in the correct order. default: reverse=false

🌈 MEDIA.VIDEO 🌈

this section is [media.video] in your configuration file.

  • program — the program to open videos. TUT_OS_DEFAULT equals xdg-open on Linux, open on MacOS and start on Windows. default: program="TUT_OS_DEFAULT"
  • args — arguments to pass to the program. default: args=""
  • terminal — if the program runs in the terminal, set this to true. default: terminal=false
  • single — if the program should be called multiple times when there are multiple files. if set to false all files will be passed as an argument, but not all programs support this. default: single=true
  • reverse — if the files should be passed in reverse order. this will make some programs display the files in the correct order. default: reverse=false

💜 MEDIA.AUDIO 💜

this section is [media.audio] in your configuration file.

  • program — the program to open audio. TUT_OS_DEFAULT equals xdg-open on Linux, open on MacOS and start on Windows. default: program="TUT_OS_DEFAULT"
  • args — arguments to pass to the program. default: args=""
  • terminal — if the program runs in the terminal, set this to true. default: terminal=false
  • single — if the program should be called multiple times when there are multiple files. if set to false all files will be passed as an argument, but not all programs support this. default: single=true
  • reverse — if the files should be passed in reverse order. this will make some programs display the files in the correct order. default: reverse=false

This section is [media.link] in your configuration file. It’s the whole “what opens my links, bestie” situation.

  • program — the program to open links. TUT_OS_DEFAULT equals xdg-open on Linux, open on MacOS, and start on Windows. Default: program=“TUT_OS_DEFAULT”
  • args — arguments to pass to the program. Default: args=““
  • terminal — if the program runs in the terminal, set this to true. Default: terminal=false

🔔 DESKTOP-NOTIFICATION

This section is [desktop-notification] in your configuration file. It’s giving “tell me everything immediately” energy.

  • followers — enable notifications when someone follows you. Default: followers=false
  • favorite — enable notifications when one of your toots gets favorited. Default: favorite=false
  • mention — enable notifications when someone mentions you. Default: mention=false
  • update — enable notifications when a post you have interacted with gets edited. Default: update=false
  • boost — enable notifications when one of your toots gets boosted. Default: boost=false
  • poll — enable notifications when a poll ends. Default: poll=false
  • posts — enable notifications for new posts. Default: posts=false

🛠️ OPEN-CUSTOM

This section is [open-custom] in your configuration file. Example:

[[open-custom.programs]]
program = 'chromium'
terminal = false
hint = "[C]hrome"
keys = ["c", "C"]

[[open-custom.programs]]
program = 'imv'
terminal = false
hint = "[I]mv"
keys = ["i", "I"]"

🧩 OPEN-CUSTOM.PROGRAMS

This section is [[open-custom.programs]] in your configuration file. You can have multiple of them, because options are a lifestyle.

  • program — the program to open the file with. Default: program=““
  • args — arguments to pass to the program. Default: args=““
  • terminal — if the program runs in the terminal, set this to true. Default: terminal=false
  • hint — what should the key hint in tut be for this program. See under the input section to learn more about hint. Default: hint=““
  • keys — a list of keys to open files with this program. See under the input section to learn more about keys. Default: keys=[]
  • special-keys — a list of special-keys to open files with this program. See under the input section to learn more about special-keys. Default: special-keys=[]

🎯 OPEN-PATTERN

This section is [open-pattern] in your configuration file.

🌈 OPEN-PATTERN.PROGRAMS

This section is [[open-pattern.programs]] in your configuration file. You can have multiple of them.

  • matching — 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. To see the syntax for glob pattern you can follow this URL: https://github.com/gobwas/glob#syntax. Default: matching=““
  • program — the program to open the file with. Default: program=““
  • args — arguments to pass to the program. Default: args=““
  • terminal — if the program runs in the terminal, set this to true. Default: terminal=false

🎨 STYLE

This section is [style] in your configuration file.

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 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 asterisk. 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. You’ll have to set theme="none" for this to work.

  • theme — the theme to use. You can use some themes that come bundled with tut. Check out the themes available on the URL below. If a theme is named nord.toml you just write theme="nord". https://github.com/RasmusLindroth/tut/tree/master/config/themes You can also create a theme file in your config directory e.g. ~/.config/tut/themes/foo.toml and then set theme=foo. If you want to use your own theme but don’t want to create a new file, set theme="none" and then you can create your own theme below. Default: theme=“default”
  • xrdb-prefix — the xrdb prefix used for colors in .Xresources. Default: xrdb-prefix=“guess”
  • background — the background color used on most elements. Default: background=““
  • text — the text color used on most of the text. Default: text=““
  • subtle — the color to display subtle elements or subtle text. Like lines and help text. Default: subtle=““
  • warning-text — the color for errors or warnings. Default: warning-text=““
  • text-special-one — this color is used to display username. Default: text-special-one=““
  • text-special-two — this color is used to display username and key hints. Default: text-special-two=““
  • top-bar-background — the color of the bar at the top. Default: top-bar-background=““
  • top-bar-text — the color of the text in the bar at the top. Default: top-bar-text=““
  • status-bar-background — the color of the bar at the bottom. Default: status-bar-background=““
  • status-bar-text — the color of the text in the bar at the bottom. Default: status-bar-text=““
  • status-bar-view-background — the color of the bar at the bottom in view mode. Default: status-bar-view-background=““
  • status-bar-view-text — the color of the text in the bar at the bottom in view mode. Default: status-bar-view-text=““
  • command-text — the color of the text in the command bar at the bottom. Default: command-text=““
  • list-selected-background — background of selected list items. Default: list-selected-background=““
  • list-selected-text — the text color of selected list items. Default: list-selected-text=““
  • list-selected-inactive-background — the background color of selected list items that are out of focus. Default: list-selected-inactive-background=““
  • list-selected-inactive-text — the text color of selected list items that are out of focus. Default: list-selected-inactive-text=““
  • controls-text — the main color of the text for key hints. Default: controls-text=““
  • controls-highlight — the highlight color of for key hints. Default: controls-highlight=““
  • autocomplete-background — the background color in drop-downs and autocompletions. Default: autocomplete-background=““
  • autocomplete-text — the text color in drop-downs at autocompletions. Default: autocomplete-text=““
  • autocomplete-selected-background — the background color for selected value in drop-downs and autocompletions. Default: autocomplete-selected-background=““
  • autocomplete-selected-text — the text color for selected value in drop-downs and autocompletions. Default: autocomplete-selected-text=““
  • button-color-one — the background color on selected button and the text color of unselected buttons. Default: button-color-one=““
  • button-color-two — the text color on selected button and the background color of unselected buttons. Default: button-color-two=““
  • timeline-name-background — the background on named timelines. Default: timeline-name-background=““
  • timeline-name-text — the text color on named timelines. Default: timeline-name-text=““

⌨️ INPUT

This section is [input] in your configuration file. In this section you set the keys to be used in tut.

The hint option lets you set which part of the hint that will be highlighted in tut. E.g. [F]avorite results in a highlighted F and the rest of the text is displayed normally. Some of the options can be in two states, like favorites, so there you can set the hint-alt option to something like Un[F]avorite.

Examples:

  • "[D]elete" = Delete with a highlighted D
  • "Un[F]ollow" = UnFollow with a highlighted F
  • "[Enter]" = Enter where everything is highlighted
  • "Yan[K]" = YanK with a highlighted K

The keys option lets you define what key that should be pressed. This is limited to one character only and they are case sensitive. Example: keys=["j","J"]

You can also set special-keys and they’re for keys like Escape and Enter. To find the names of special keys you have to go to the following site and look for "var KeyNames = map[Key]string{". https://github.com/gdamore/tcell/blob/master/key.go

⬇️ INPUT.GLOBAL-DOWN

This section is [input.global-down] in your configuration file. Keys for moving down.

  • keys — Default: keys=[“j”,“J”]
  • special-keys — Default: special-keys=[“Down”]

⬆️ INPUT.GLOBAL-UP

This section is [input.global-up] in your configuration file. Keys for moving down — yes, the page says that here too, no cap.

  • keys — Default: keys=[“k”,“K”]
  • special-keys — Default: special-keys=[“Up”]

✅ INPUT.GLOBAL-ENTER

This section is [input.global-enter] in your configuration file. To select items.

  • special-keys — Default: special-keys=[“Enter”]

↩️ INPUT.GLOBAL-BACK

This section is [input.global-back] in your configuration file. To go back.

  • hint — Default: hint=“[Esc]”
  • special-keys — Default: special-keys=[“Esc”]

🚪 INPUT.GLOBAL-EXIT

This section is [input.global-exit] in your configuration file. To go back or exit.

  • hint — Default: hint=“[Q]uit”
  • keys — Default: keys=[“q”,“Q”]

🏠 INPUT.MAIN-HOME

This section is [input.main-home] in your configuration file. Move to the top.

  • keys — Default: keys=[“g”]
  • special-keys — Default: special-keys=[“Home”]

🔚 INPUT.MAIN-END

This section is [input.main-end] in your configuration file. Move to the bottom.

  • keys — Default: keys=[“G”]
  • special-keys — Default: special-keys=[“End”]

⏪ INPUT.MAIN-PREV-FEED

This section is [input.main-prev-feed] in your configuration file. Go to previous feed.

  • keys — Default: keys=[“h”,“H”]
  • special-keys — Default: special-keys=[“Left”]

⏩ INPUT.MAIN-NEXT-FEED

This section is [input.main-next-feed] in your configuration file. Go to next feed.

  • keys — Default: keys=[“l”,“L”]
  • special-keys — Default: special-keys=[“Right”]

◀️ INPUT.MAIN-PREV-PANE

This section is [input.main-prev-pane] in your configuration file. Focus on the previous feed pane.

  • special-keys — Default: special-keys=[“Backtab”]

▶️ INPUT.MAIN-NEXT-PANE

This section is [input.main-next-pane] in your configuration file. Focus on the next feed pane.

  • special-keys — Default: special-keys=[“Tab”]

🔄 INPUT.MAIN-NEXT-ACCOUNT

This section is [input.main-next-account] in your configuration file. Focus on the next account.

  • special-keys — Default: special-keys=[“Ctrl-N”]

🔁 INPUT.MAIN-PREV-ACCOUNT

This section is [input.main-prev-account] in your configuration file. Focus on the previous account.

  • special-keys — Default: special-keys=[“Ctrl-P”]

✍️ INPUT.MAIN-COMPOSE

This section is [input.main-compose] in your configuration file. Compose a new toot.

  • keys — Default: keys=[“c”,“C”]

🖼️ INPUT.STATUS-AVATAR

This section is [input.status-avatar] in your configuration file. Open avatar.

  • hint — Default: hint=“[A]vatar”
  • keys — Default: keys=[“a”,“A”]

🚀 INPUT.STATUS-BOOST

This section is [input.status-boost] in your configuration file. Boost a toot.

  • hint — Default: hint=“[B]oost”
  • keys — Default: keys=[“b”,“B”]

INPUT.STATUS-EDIT 🎀

This section is [input.status-edit] in your configuration file

Bestie. You wanna Edit a toot — that's the whole vibe here.

  • hint — hint=“[E]dit”
  • keys — keys=[“e”,“E”]

INPUT.STATUS-DELETE 🗑️

This section is [input.status-delete] in your configuration file

Delete a toot. Gone. Poof. No takebacks, so like… be sure bestie 💀

  • hint — hint=“[D]elete”
  • keys — keys=[“d”,“D”]

INPUT.STATUS-FAVORITE ⭐

This section is [input.status-favorite] in your configuration file

Favorite a toot. Give it the little star, it deserves it fr fr.

  • hint — hint=“[F]avorite”
  • keys — keys=[“f”,“F”]

INPUT.STATUS-MEDIA 📸

This section is [input.status-media] in your configuration file

Open toots media files — all the pics and clips attached to the toot, live and in colour.

  • hint — hint=“[M]edia”
  • keys — keys=[“m”,“M”]

This section is [input.status-links] in your configuration file

Open links — any links chilling in the toot, opened up for you.

  • hint — hint=“[O]pen”
  • keys — keys=[“o”,“O”]

INPUT.STATUS-POLL 📊

This section is [input.status-poll] in your configuration file

Open poll — yes we're doing democracy in the timeline.

  • hint — hint=“[P]oll”
  • keys — keys=[“p”,“P”]

INPUT.STATUS-REPLY 💬

This section is [input.status-reply] in your configuration file

Reply to toot. Say your thing, queen.

  • hint — hint=“[R]eply”
  • keys — keys=[“r”,“R”]

INPUT.STATUS-BOOKMARK 🔖

This section is [input.status-bookmark] in your configuration file

Save/bookmark a toot. Tuck it away for later, like a little snack.

  • hint — hint=“[S]ave”
  • hint-alt — hint-alt=“Un[S]ave”
  • keys — keys=[“s”,“S”]

INPUT.STATUS-THREAD 🧵

This section is [input.status-thread] in your configuration file

View thread — the whole conversation, not just the one toot.

  • hint — hint=“[T]hread”
  • keys — keys=[“t”,“T”]

INPUT.STATUS-USER 🫶

This section is [input.status-user] in your configuration file

Open user profile — go snoop (lovingly).

  • hint — hint=“[U]ser”
  • keys — keys=[“u”,“U”]

INPUT.STATUS-VIEW-FOCUS 👀

This section is [input.status-view-focus] in your configuration file

Open the view mode.

  • hint — hint=“[V]iew”
  • keys — keys=[“v”,“V”]

INPUT.STATUS-YANK 📋

This section is [input.status-yank] in your configuration file

Yank the url of the toot — into the clipboard it goes, iconic behaviour.

  • hint — hint=“[Y]ank”
  • keys — keys=[“y”,“Y”]

INPUT.STATUS-TOGGLE-CW 🙈

This section is [input.status-toggle-cw] in your configuration file

Show the content in a content warning. Peek behind the curtain.

  • hint — hint=“Press [Z] to toggle cw”
  • keys — keys=[“z”,“Z”]

INPUT.STATUS-SHOW-FILTERED 🫣

This section is [input.status-show-filtered] in your configuration file

Show the content of a filtered toot. Same key energy as the CW one above — both are z/Z, so context is doing the work here iykyk.

  • hint — hint=“Press [Z] to view filtered toot”
  • keys — keys=[“z”,“Z”]

INPUT.USER-AVATAR 🖼️

This section is [input.user-avatar] in your configuration file

View avatar — yes, the pfp, enlarged, slay.

  • hint — hint=“[A]vatar”
  • keys — keys=[“a”,“A”]

INPUT.USER-BLOCK 🚫

This section is [input.user-block] in your configuration file

Block the user. Boundaries! We love them!

  • hint — hint=“[B]lock”
  • hint-alt — hint-alt=“Un[B]lock”
  • keys — keys=[“b”,“B”]

INPUT.USER-FOLLOW 💖

This section is [input.user-follow] in your configuration file

Follow user. New bestie acquired.

  • hint — hint=“[F]ollow”
  • hint-alt — hint-alt=“Un[F]ollow”
  • keys — keys=[“f”,“F”]

INPUT.USER-FOLLOW-REQUEST-DECIDE 📨

This section is [input.user-follow-request-decide] in your configuration file

Follow user. And yes — the hint and the hint-alt here are literally the same string, “Follow [R]equest” both times. Not a typo on my end, that's just how it is 💅

  • hint — hint=“Follow [R]equest”
  • hint-alt — hint-alt=“Follow [R]equest”
  • keys — keys=[“r”,“R”]

INPUT.USER-MUTE 🔇

This section is [input.user-mute] in your configuration file

Mute user. Still following, just… quietly.

  • hint — hint=“[M]ute”
  • hint-alt — hint-alt=“Un[M]ute”
  • keys — keys=[“m”,“M”]

This section is [input.user-links] in your configuration file

Open links — whatever links are hanging out on that profile.

  • hint — hint=“[O]pen”
  • keys — keys=[“o”,“O”]

INPUT.USER-USER 🪞

This section is [input.user-user] in your configuration file

View user profile.

  • hint — hint=“[U]ser”
  • keys — keys=[“u”,“U”]

INPUT.USER-VIEW-FOCUS 👁️

This section is [input.user-view-focus] in your configuration file

Open view mode.

  • hint — hint=“[V]iew”
  • keys — keys=[“v”,“V”]

INPUT.USER-YANK 📎

This section is [input.user-yank] in your configuration file

Yank the user URL — copy that profile link, chef's kiss.

  • hint — hint=“[Y]ank”
  • keys — keys=[“y”,“Y”]

INPUT.LIST-OPEN-FEED 📜

This section is [input.list-open-feed] in your configuration file

Open list.

  • hint — hint=“[O]pen”
  • keys — keys=[“o”,“O”]

INPUT.LIST-USER-LIST 👥

This section is [input.list-user-list] in your configuration file

List all users in a list. Roll call, everybody say present.

  • hint — hint=“[U]sers”
  • keys — keys=[“u”,“U”]

INPUT.LIST-USER-ADD ➕

This section is [input.list-user-add] in your configuration file

Add user to list.

  • hint — hint=“[A]dd”
  • keys — keys=[“a”,“A”]

INPUT.LIST-USER-DELETE ➖

This section is [input.list-user-delete] in your configuration file

Delete user from list.

  • hint — hint=“[D]elete”
  • keys — keys=[“d”,“D”]

This section is [input.link-open] in your configuration file

Open URL.

  • hint — hint=“[O]pen”
  • keys — keys=[“o”,“O”]

This section is [input.link-yank] in your configuration file

Yank the URL.

  • hint — hint=“[Y]ank”
  • keys — keys=[“y”,“Y”]

INPUT.TAG-OPEN-FEED 🏷️

This section is [input.tag-open-feed] in your configuration file

Open tag feed.

  • hint — hint=“[O]pen”
  • keys — keys=[“o”,“O”]

INPUT.TAG-FOLLOW 🦋

This section is [input.tag-follow] in your configuration file

Toggle follow on tag. Tags can be followed, and honestly? They deserve it.

  • hint — hint=“[F]ollow”
  • hint-alt — hint-alt=“Un[F]ollow”
  • keys — keys=[“f”,“F”]

INPUT.COMPOSE-EDIT-CW ✍️

This section is [input.compose-edit-cw] in your configuration file

Edit content warning text on new toot.

  • hint — hint=“[C]W text”
  • keys — keys=[“c”,“C”]

INPUT.COMPOSE-EDIT-TEXT 📝

This section is [input.compose-edit-text] in your configuration file

Edit the text on new toot. The main character moment.

  • hint — hint=“[E]dit text”
  • keys — keys=[“e”,“E”]

INPUT.COMPOSE-INCLUDE-QUOTE 💬

This section is [input.compose-include-quote] in your configuration file

Include a quote when replying.

  • hint — hint=“[I]nclude quote”
  • keys — keys=[“i”,“I”]

INPUT.COMPOSE-MEDIA-FOCUS 🎞️

This section is [input.compose-media-focus] in your configuration file

Focus on adding media to toot.

  • hint — hint=“[M]edia”
  • keys — keys=[“m”,“M”]

INPUT.COMPOSE-POST 🚀

This section is [input.compose-post] in your configuration file

Post the new toot. Send it. No cap.

  • hint — hint=“[P]ost”
  • keys — keys=[“p”,“P”]

INPUT.COMPOSE-TOGGLE-CONTENT-WARNING 🙈

This section is [input.compose-toggle-content-warning] in your configuration file

Toggle content warning on toot.

  • hint — hint=“[T]oggle CW”
  • keys — keys=[“t”,“T”]

INPUT.COMPOSE-VISIBILITY 🌈

This section is [input.compose-visibility] in your configuration file

Edit the visibility on new toot. Who gets to see it, bestie's choice.

  • hint — hint=“[V]isibility”
  • keys — keys=[“v”,“V”]

INPUT.COMPOSE-LANGUAGE 🌍

This section is [input.compose-language] in your configuration file

Edit the language of a toot.

  • hint — hint=“[L]ang”
  • keys — keys=[“l”,“L”]

INPUT.COMPOSE-POLL 📊

This section is [input.compose-poll] in your configuration file

Switch to creating a poll.

  • hint — hint=“P[O]ll”
  • keys — keys=[“o”,“O”]

INPUT.MEDIA-DELETE 🗑️

This section is [input.media-delete] in your configuration file

Delete media file.

  • hint — hint=“[D]elete”
  • keys — keys=[“d”,“D”]

INPUT.MEDIA-EDIT-DESC 🖊️

This section is [input.media-edit-desc] in your configuration file

Edit the description on media file. Alt text girlies rise 🫶

  • hint — hint=“[E]dit desc”
  • keys — keys=[“e”,“E”]

INPUT.MEDIA-ADD ➕

This section is [input.media-add] in your configuration file

Add a new media file.

  • hint — hint=“[A]dd”
  • keys — keys=[“a”,“A”]

INPUT.VOTE-VOTE 🗳️

This section is [input.vote-vote] in your configuration file

Vote on poll.

  • hint — hint=“[V]ote”
  • keys — keys=[“v”,“V”]

INPUT.VOTE-SELECT ✅

This section is [input.vote-select] in your configuration file

Select item to vote on. Heads up: this one doesn't have a keys entry at all — it's a special-keys situation instead, and the special key is “Enter”.

  • hint — hint=“[Enter] to select”
  • special-keys — special-keys=[“Enter”]

INPUT.POLL-ADD ➕

This section is [input.poll-add] in your configuration file

Add a new poll option.

  • hint — hint=“[A]dd”
  • keys — keys=[“a”,“A”]

INPUT.POLL-EDIT ✏️

This section is [input.poll-edit] in your configuration file

Edit a poll option.

  • hint — hint=“[E]dit”
  • keys — keys=[“e”,“E”]

INPUT.POLL-DELETE ❌

This section is [input.poll-delete] in your configuration file

Delete a poll option.

  • hint — hint=“[D]elete”
  • keys — keys=[“d”,“D”]

INPUT.POLL-MULTI-TOGGLE 🔀

This section is [input.poll-multi-toggle] in your configuration file

Toggle voting on multiple options. Choose many, why not.

  • hint — hint=“Toggle [M]ultiple”
  • keys — keys=[“m”,“M”]

INPUT.POLL-EXPIRATION ⏳

This section is [input.poll-expiration] in your configuration file

Change the expiration of poll.

  • hint — hint=“E[X]pires”
  • keys — keys=[“x”,“X”]

INPUT.PREFERENCE-NAME 💫

This section is [input.preference-name] in your configuration file

Change display name.

  • hint — hint=“[N]ame”
  • keys — keys=[“n”,“N”]

INPUT.PREFERENCE-VISIBILITY 🌈

This section is [input.preference-visibility] in your configuration file

Change default visibility of toots.

  • hint — hint=“[V]isibility”
  • keys — keys=[“v”,“V”]

INPUT.PREFERENCE-BIO 🍓

This section is [input.preference-bio] in your configuration file

Change bio in profile. Make it iconic.

  • hint — hint=“[B]io”
  • keys — keys=[“b”,“B”]

INPUT.PREFERENCE-SAVE 💾

This section is [input.preference-save] in your configuration file

Save your preferences. Don't forget this step, I'm begging 😭

  • hint — hint=“[S]ave”
  • keys — keys=[“s”,“S”]

INPUT.PREFERENCE-FIELDS 📋

This section is [input.preference-fields] in your configuration file

Edit profile fields. The little metadata rows. Very cute, very you.

  • hint — hint=“[F]ields”
  • keys — keys=[“f”,“F”]

INPUT.PREFERENCE-FIELDS-ADD ➕

This section is [input.preference-fields-add] in your configuration file

Add new field.

  • hint — hint=“[A]dd”
  • keys — keys=[“a”,“A”]

INPUT.PREFERENCE-FIELDS-EDIT ✏️

This section is [input.preference-fields-edit] in your configuration file

Edit current field.

  • hint — hint=“[E]dit”
  • keys — keys=[“e”,“E”]

INPUT.PREFERENCE-FIELDS-DELETE 🗑️

This section is [input.preference-fields-delete] in your configuration file

Delete current field.

  • hint — hint=“[D]elete”
  • keys — keys=[“d”,“D”]

✨ INPUT.EDITOR-EXIT ✨

okay bestie, this section is [input.editor-exit] in your configuration file — and it is literally all about the exit-the-editor moment. Exit the editor is the whole assignment here, no cap. 💅

💖 hint 💖

The hint line is exactly this, periodt:

hint=“[Esc] when done”

🦋 special-keys 🦋

And the special-key lineup is exactly:

special-keys=[“Esc”]

🌈 SEE ALSO 🌈

  • tut(1) - flags and commands
  • tut(7) - commands and keys inside of tut

👑 AUTHORS 👑

  • Rasmus Lindroth.

okay that is the whole page, bestie — source/version is tut 2.0.0, date is 2023-01-24, byeee! 💖✨🦋

📦 where this page comes from