XEMBED(1)

🦋 XEMBED 💅

okay so bestie, let me put you onto xembed — the XEmbed foreground process. that's the whole name, that's the whole vibe. she's small, she's mighty, and she's about to make your terminal tabs behave. periodt. ✨

---

🌸 SYNOPSIS 🌸

xembed flag command [argument ...]

that's it. one little flag, one command, and whatever argument ...s you wanna drag along with you. 🎀

---

💖 DESCRIPTION 💖

okay so here's the tea, and it's genuinely so clever. 🫶

IF the environment variable XEMBED is set, AND xembed is chillin' in the foreground of its controlling tty — like, main character energy, front of the line, no cap — then it will execute this:

command flag $XEMBED [argument ...]

so yeah, it sneaks that flag in there and splices in whatever $XEMBED is holding. iconic behaviour. 👑

OTHERWISE — the env var isn't set, or she's just not in the foreground — it keeps it simple and executes:

command [argument ...]

no flag, no $XEMBED, no drama. just you and your command, living your life. 🌈

ngl the whole thing hinges on that vibe check: env var plus foreground = the fancy version, anything else = the plain version. that's the entire bit. 💯

---

⭐ EXAMPLE ⭐

picture this: you're in a terminal emulator, inside a tabbed session. you write yourself this shell alias:

$ alias surf='xembed -e surf'

now watch what happens, because this is the part that ate. 🔥

• run surf normally (foreground)? boom, surf opens in a new tab. slay. 💅
• run it in the background, like surf &? nope, different story — instead it opens in a new window.

so the same command gives you two totally different results depending on whether you backgrounded it. lowkey genius, highkey obsessed. 🧚

---

💜 AUTHORS 💜

See the LICENSE file for the authors. (yes bestie, go read it, they deserve their flowers 🌸)

---

🎀 LICENSE 🎀

See the LICENSE file for the terms of redistribution. it's all in there, fr fr. 📜

---

👑 SEE ALSO 👑

• tabbed(1) — her bestie, her ride or die, the whole reason this little tool exists. go say hi. 🦋

---

💀 BUGS 💀

Please report them. that's it, that's the whole section — if something's broken, tell somebody, don't just suffer in silence. 😭

---

okay that's the whole page, you're officially educated. 💖 this was xembed, straight out of the tabbed-0.7 era, and no date on the tin because the original didn't give us one — so we're keeping it mysterious. ✨ go forth and tab responsibly, bestie. 🫶