BLIND-TRANSLATE(1)

📦 version 1.1, in alpine 3.24

💫 BLIND-TRANSLATE(1) 💫

okay so bestie, welcome to the group chat where we talk about blind-translate, a general commands manual page for the blind fam 🎀

✨ NAME ✨

blind-translate — literally performs framewise translation of a video 💅

🌸 SYNOPSIS 🌸

blind-translate [-pw] translation-stream

🦋 DESCRIPTION 🦋

so here's the vibe: blind-translate reads a video from stdin and translation operands from translation-stream, does a framewise translation of the video, and prints the resulting video to stdout. slay. ✨

now translation-stream is a video that is literally 1 pixel wide and 1 pixel high — tiny icon behavior, we love her 🎀. the way it works:

  • the first pixel value in a frame is used as the translation value for the X-axis in that same frame of the video
  • the second pixel value is used as the translation value for the Y-axis
  • the remaining two pixel values? ignored. not invited to the party 🙈

and the length-mismatch tea ☕:

  • if stdin is longer than translation-stream, the remainder of stdin is printed with the last translation — or with no translation at all if translation-stream doesn't contain any translations
  • if stdin is shorter than translation-stream, the remainder of translation-stream is ignored but may be partially read 👀 (yes, partially, no cap)

💖 OPTIONS 💖

  • -w — wrap the video around the edges 🌀 (iconic little feature fr fr)
  • -p — the values in translation-stream get treated as the position, measured from the top-left corner, in the input video that shall be used at the top-left corner of the output video 🫶

🔥 REQUIREMENTS 🔥

blind-translate requires enough free memory to load a full frame into memory if -w is used — or a frame row otherwise. and listen: a frame or frame row requires 32 bytes per pixel it contains. do the math before you come for her 💀

🌈 SEE ALSO 🌈

blind(7), blind-crop(1), blind-extend(1) — go read the whole squad, iykyk 💜

👑 AUTHORS 👑

Mattias Andrée <maandree@kth.se> — the main character who made this happen 💅

ngl the memory thing is real, bestie — load responsibly or your machine will simply pass away 😭

and that's the page!! brought to you by blind 1.1 🎀 on the BLIND-TRANSLATE(1) manual page — periodt, go translate some frames 💖✨🦋

📦 where this page comes from