SUTF(1)

📦 version 9.2.2, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

🌸 NAME — sutf, aka the SUTF(1) manual 🌸

okay so this is SUTF(1), the manual page for sutf, and she does one iconic thing: convert encoding of text files. that's the whole vibe, bestie. 💖

✨ SYNOPSIS ✨

sutf [OPTIONS...] [INPUTFILES...]

🦋 DESCRIPTION 🦋

sutf converts the encoding of text files from one encoding to another, using the high-performance simdutf library for the formats it supports. for formats that simdutf doesn't support, sutf falls back to iconv if iconv is available. no cap, that's the whole plot. ✨

💅 OPTIONS 💅

  • -f, --from-code=ENCODING — encoding of the source text. this one is mandatory, bestie. you literally cannot skip it. 💀
  • -t, --to-code=ENCODING — encoding of the output. also mandatory, so don't forget it. 🫶
  • -o, --output=FILE — output file. if you don't specify it, the output goes to standard output. slay. 🌈
  • -h, --help — display help text and exit. your little "what do i do" button. 💖
  • -u, --usage — display a short usage message and exit. short and sweet. ✨
  • -l, --list — display supported formats and exit. the format menu, basically. 🍓

🌟 SUPPORTED FORMATS 🌟

formats supported by the simdutf library: UTF-8, UTF-16LE, UTF-16BE, UTF-32LE. that's the exact list, in that exact order. 👑

if iconv is available, additional formats supported by iconv are also available. the more you know 🌈

🎀 EXAMPLES 🎀

convert UTF-16LE file to UTF-8:

sutf -f UTF-16LE -t UTF-8 input.txt

convert multiple files and save to output file:

sutf -f UTF-8 -t UTF-16BE -o output.txt file1.txt file2.txt

list supported formats:

sutf --list

🫶 SEE ALSO 🫶

👑 AUTHOR 👑

Written by the simdutf development team. periodt. 💅

and that's the cute sign-off, bestie: this page comes from simdutf and is dated March 2026. the SUTF(1) footer energy is right there, but make it slay. 🦋✨

📦 where this page comes from