SWIRC.THEME(5)

📦
version 3.5.9 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 swirc.theme — the manual page, bestie edition 💖

okay so this is swirc.theme(5), from the File Formats Manual section, and it's literally the guide to writing themes for swirc. let's get into it 🫶

✨ NAME ✨

swirc.theme — how to write themes for swirc 💅

🌸 DESCRIPTION 🌸

This manual page is the ultimate reference to consult when you're writing themes for swirc(1). like, no other page, just this one. it's giving "the final boss of theme docs" 👑

🎀 TEXT DECORATION 🎀

Here's the whole vibe chart, bestie — the name, the hex, the octal, and what it actually looks like:

  • Blink — 1d, 035, ^]
  • Bold — 02, 002, ^B
  • Color — 03, 003, ^C
  • Normal — 0f, 017, ^O
  • Reverse — 16, 026, ^V
  • Underline — 1f, 037, ^_

Example usage:

blabla ^Bbold text^B blabla
blabla ^Vreversed text^V blabla
blabla ^_underlined text^_ blabla
Always use the literal control characters because else it won't work! 😭 fr fr, no shortcuts.

Blink is a no operation because it's annoying. periodt. it does nothing. we don't do that here. 💀

🌈 COLORS 🌈

The classic sixteen, icon by icon:

  • 00 — white
  • 01 — black
  • 02 — blue (navy)
  • 03 — green
  • 04 — red
  • 05 — brown (maroon)
  • 06 — purple
  • 07 — orange (olive)
  • 08 — yellow
  • 09 — lt.green (lime)
  • 10 — teal (a kinda green/blue cyan)
  • 11 — lt.cyan (cyan ?) (aqua)
  • 12 — lt.blue (royal)
  • 13 — pink (light purple) (fuchsia)
  • 14 — grey
  • 15 — lt.grey (silver)

For the colors 16-99 see the output of the command /colormap. Enough color pairs must've been initialized. (and heads up: 193 color pairs are too few for the colors 16-99 to be used as backgrounds. 💀)

The syntax of the color attribute in text has the format ^CN[,M]. N will be the text (foreground) color and M the background color. A background color (M) is optional and is not always included.

N and M can maximally be two digits long. Although the colors {0,1,2,...,9} are supported you are highly encouraged to use {00,01,02,...,09}. ✨

A plain ^C can be used to turn the color effect off. While typing ^O will make sure ALL the text effects gets reset. For example:

blabla ^C05,02red text on blue background^C blabla
blabla ^C09green text^O blabla

Of course settings can start with colored text and a closing ^C is not essential. 🦋

💜 SETTING TYPES 💜

See swirc.conf(5). that's it, that's the section, go read the other one bestie 🫶

👑 SETTINGS 👑

  • term_background (int) — Which background color (0-15) is this theme written for?
    • 0 = white
    • 1 = black
  • term_enable_colors (bool) — Enable colors (yes/no)?
  • term_use_default_colors (bool) — Use terminal's default colors? I.e. call use_default_colors(3).
  • color3, color4 (string) — Colors used in uncategorized contexts. Must begin with ^C.
  • gfx_failure, gfx_success, gfx_warning (string) — Used in contexts where to flag failures, successes and warnings respectively.
  • left_bracket, right_bracket (string) — Left and right bracket. Frequently used.
  • logo_color (string) — Swirc ASCII logo color displayed at startup. (Must begin with ^C.)
  • nick_s1, nick_s2 (string) — When you or another user types something the nickname will be enclosed by s1 and s2.
  • nicklist_my_nick_color, nicklist_nick_color, nicklist_privilege_color, nicklist_vline_color (int) — Nicklist decoration. All of these settings are of type int (0-99) thus ^C is not needed and should not be used.
  • notice_color1, notice_color2 (string) — Notice colors. ^C should be used.
  • notice_lb, notice_rb, notice_sep (string) — Notice left/right bracket and separator
  • notice_inner_b1, notice_inner_b2 (string) — Notice inner bracket 1 and 2. (I.e. left and right.)
  • primary_color, secondary_color (string) — Primary and secondary color for the theme. Frequently used. (Begin with ^C.)
  • slogan (string) — Swirc slogan displayed in the statusbar.
  • specifier1, specifier2, specifier3 (string) — Specifiers used in various contexts. Number 1 is frequently used.
  • statusbar_bg, statusbar_fg (string) — Statusbar background and foreground. Valid values are black, red, green, yellow, blue, magenta, cyan, white.
  • statusbar_leftBracket, statusbar_rightBracket, statusbar_spec (string) — Statusbar left/right bracket and specifier.
  • time_format (string) — Time format passed to strftime(3).
  • titlebar_bg, titlebar_fg (string) — Titlebar background and foreground. Valid values are black, red, green, yellow, blue, magenta, cyan, white.
  • whois_acc (string)
  • whois_away (string)
  • whois_bot (string)
  • whois_cert (string)
  • whois_channels (string)
  • whois_conn (string)
  • whois_host (string)
  • whois_idle (string)
  • whois_ircName (string)
  • whois_ircOp (string)
  • whois_modes (string)
  • whois_server (string)
  • whois_service (string)
  • whois_ssl (string)

🍓 FILES 🍓

  • ~/.swirc/default.thm — default theme

🧚 SEE ALSO 🧚

swirc(1), swirc.conf(5)

⭐ AUTHORS ⭐

This manual page was written by Markus Uhlin ⟨markus@nifty-networks.net⟩ 🫶

💀 CAVEATS 💀

If you want to give color to numbers be sure to use two digits for N nor M! like, literally, do not skip this one bestie 😭

okay that's the whole page!! 💖 this was swirc.theme(5) from the File Formats Manual, Debian edition, dated March 11, 2024. slay, go write some iconic themes, you got this 👑✨🌈

📦 where this page comes from