HONK(5)

πŸ“¦ version 1.5.2, in nixos 26.05

πŸ’… HONK(5) β€” status composition πŸŽ€

okay bestie, so this is the honk manual page β€” like, the file formats manual one, and it's literally all about composing status updates. buckle up πŸ’–


✨ NAME ✨

honk β€” status composition, and yes that's the whole vibe πŸ¦‹


🌸 DESCRIPTION 🌸

Status updates composed in honk have many features beyond just plain text. like, it's giving "more than meets the eye" fr fr.

The process begins by pressing the button marked β€œit's honking time” to activate the honk form. that's the entry point, bestie πŸ‘‘

Honks are posted publicly. no cap. everyone sees it 🌈

πŸŽ€ Basics πŸŽ€

A subset of markdown is supported. here's the roster:

  • bold β€” **bold text**
  • italics β€” *italicized text*
  • quotes β€” > This text is quoted.
  • code β€” inline code fragments with single ticks.

/* triple tick code blocks support syntax highlighting */ int main() { return 0; }

wait, let me just give you the block cleanly, because triple tick code blocks support syntax highlighting 😌

/* triple tick code blocks support syntax highlighting */
int main() { return 0; }
  • headings β€” heading lines starting with #.
  • lists β€” lists of items starting with either + or -.
  • tables β€” table cells separated by |.
  • images β€” inline images with img tags:
<img alt="Lifecycle of a honk" src="https://example.com/diagram.png">

also a src of a single number (1, 2, etc.) may refer to an attachment. iconic.

  • links β€” URLs beginning with β€œhttp” or β€œhttps” will be autolinked. slay, no extra work πŸ’…
  • rules β€” exactly three dashes on a line, ---, will become a horizontal rule.
  • spoilers β€” hide blocks of text between triple colon delimited regions:
::: warning
text that should be hidden behind a warning
:::

oh and this part is so important: if the first line of a honk begins with β€œDZ:” (danger zone) or any other combination of two letters and a colon, it will be used a summary and the post marked sensitive. like, the colon is doing a lot of heavy lifting there 🫢

Mentioning a specific user such as (@user@example.social) will send a copy of the message to them. several forms are supported:

  • @name will work using the short name from the honkers table and be expanded automatically.
  • @handle@domain will work for anyone.
  • @https://example.com works as well.

and when honking back, the author of the parent post is automatically mentioned. convenient ✨

πŸ¦‹ Extras πŸ¦‹

Custom emoji may be included by colon wrapping the image name. like (:hellsyeah:) β€” obsessed.

A meme (sticker, reaction gif) may be included with the meme operator followed by the file name:

meme: honk.mp4

A full list of emoji and memes may be found in the funzone. see honk(8) for more about the funzone 🧚

Custom flag emoji may be generated on the fly by specifying comma separated hexadecimal RGB values, one for each stripe:

flag:306,002,dcf

Vertical stripes may be selected by specifying "vert" for the first value. main character flag energy fr fr.

There are no length restrictions, but remember, somebody is going to have to read this noise. 😭

One may attach a file to a post. images are automatically rescaled and reduced in size for federation. a description, or caption, is encouraged. text files and PDFs are also supported as attachments. other formats are not supported. multiple files may be attached to the some post, but be wary of depending on a particular presentation order. (that's the original wording, "the some post" β€” not me, i swear πŸ™ˆ)

One may also live dangerously by posting assassination coordinates πŸ’€ the available fields, all optional, are name, url, latitude, and longitude. by default, location data is rounded to approximately 1/100 decimal degree accuracy. pressing the check in button a second time will refine this to more a precise location. lowkey spy behavior but okay πŸ•΅οΈ

Adding a time to a post turns it into an event. supported formats for start time are HH:MM or YYYY-MM-DD HH:MM. a 24 hour clock is assumed, unless am or pm are specified. the duration is optional and may be specified as XdYhZm for X days, Y hours, and Z minutes (1d12h would be a 36 hour event). math slay πŸ”₯

Clicking the pretty circle face will open the emu peeker to add in the selection of emus. yes. emu peeker. i don't make the rules πŸ‘‘

When everything is at last ready to go, press the β€œit's gonna be honked” button. periodt πŸ’–

⭐ Advanced ⭐

Some additional fields exist which modify the post's metadata:

  • cc β€” to add a recipient without inlining their address.
  • link β€” to add an http Link to the post.
  • name β€” to give a title to the link.
  • tags β€” to add additional hashtags without cluttering the text.

🌈 EXAMPLES 🌈

(Slightly dated screenshots.) β€” their words, not mine, but iconic either way πŸŽ€

Composing a new honk with an attached image and location.

screenshot of honk composition: screenshot-compose.png

After posting.

screenshot of honk after posting: screenshot-afterpost.jpg


πŸ‘‘ SEE ALSO πŸ‘‘

honk(1)


πŸ’€ CAVEATS πŸ’€

Markdown support is implemented with regexes. Preview is recommended. like, seriously bestie, hit preview. regex-based markdown is giving "chaotic neutral" 🫢


okay that's the whole page!! source/version and date: this is from Debian, with the date placeholder $Mdocdate$ β€” so go forth, press β€œit's honking time”, and honk responsibly πŸ’œβœ¨πŸŽ€

πŸ“¦ where this page comes from
  • nixos 26.05: honk 1.5.2
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms