cyr(1)

💖 NAME 💖

cyr — setup Cyrillic on Linux console 🦋

(also known as: the little program that lives in the User Manuals part of your manual, section 1, and exists purely so your console can speak Cyrillic, bestie 💅)

🌸 SYNOPSIS 🌸

cyr [ options ]... [ keyboard [ keyboard_options ... ]]

✨ DESCRIPTION ✨

okay so real talk — cyr is a program for fast and easy setup of Cyrillic on the Linux console. that's it. that's the whole pitch. no cap, it just does the thing so you don't have to hand-hold your console through it. 🫶

🎀 OPTIONS 🎀

• -C, --copyright — shows you the copying conditions and the warranty info. the legal tea ☕
• -h, --help — displays help information and then exits. the classic "help me bestie" flag 🙈
• --save — saves the given parametes as default for latter use in ~/.cyr_defaults. so like, it remembers your vibe for next time 💾✨
• -v, --verbose — be more verbose. it's giving "tell me EVERYTHING" 🗣️
• -s, --style=fontstyle — the font style (fontface) half of the pair; the actual sentence about what -s and -f do together lives in the next bullet, fr fr 👇
• -f, --size=fontsize — use the given fontstyle (i.e. fontface) and fontsize. type cyr --help to see possible fontstyle-fontsize combinations. go peek, i'll wait 🍓
• --font=fontfile — use this fontfile. the options -s and -f get ingnored if this option is given. you'll reach for this one when you want a font that isn't directly supported by cyr — iconic for the custom-font girlies 👑
• -e, --encoding=encoding — setup the Linux console for this encoding. pick your encoding, live your truth 🌈
• --ttys='console1 console2...' — setup Cyrillic in these consoles. list 'em out and it handles the whole squad 💜
• keyboard — use this keyboard. ⌨️
• keyboard_options — use this keyboard and keyboard options.

📖 CONFIGURATION FILE 📖

cyr reads it defaults from ~/.cyr_defaults or — if that former file doesn't exist — from /etc/console-cyrillic. it checks the home one first, then falls back, nbd 🏠➡️🏢

Lines that contain only spaces or begin with # are simply ignored. (so go ahead and leave yourself lil notes, the config will not be reading them 💅)

All other lines should have the form:

keyword parameters

Different keywords correspond to different arguments of cyr as follows:

• ttys terminals... is equivalent to --tty='terminals...'.
• style fontstyle is equivalent to --style=fontstyle.
• size fontsize is equivalent to --size=fontsize.
• encoding enc is equivalent to --encoding=enc.
• fontfile fntfile is equivalent ot --font=fntfile.
• layout kbd specifies kbd as default keyboard to use.
• options opt... specifies opt as default keyboard options.

🚨 heads up bestie: in the config file it's --tty= with one t, but on the command line the option is --ttys. not me double-checking that twice 😭 keep them straight and you're golden.

🌟 AUTHOR 🌟

Anton Zinoviev <anton@lml.bas.bg>, <zinoviev@debian.org> 💌

and that's the whole page, bestie — brought to you by console-cyrillic, JUN 2002. vintage but slaying, periodt. 💖✨