INSTALL-XPI(1)

📦 version 0.54.2, in debian bookworm, ubuntu jammy

💅 install-xpi — bestie edition 💅

ok so this is install-xpi, part of the mozilla-devscripts suite, and it's literally the girlboss that takes your .xpi file and tucks it all cozy into a Debian package. no cap. 🎀

✨ NAME ✨

install-xpi — installs a xpi file into a Debian package 🫶

🌸 SYNOPSIS 🌸

install-xpi [options] xpi-file

🦋 DESCRIPTION 🦋

so install-xpi is a helper tool for packaging XUL extensions. it takes the xpi file you hand it, installs it into the correct directory, and creates all the required links based on the data chillin' in the install.rdf file. she also fixes up the file permissions for you — unless you pass --preserve-permissions, in which case she minds her own business. 💅

and okay, this part is kind of iconic: install-xpi will create a configuration file in /etc if the XUL extension brings one or more preferences files in defaults/preferences. that config file is lowkey minimal — it only contains a description of where to find the overridable preferences. but wait, there's more: if debian/package.js exists, that gets used as the configuration file instead. 👑

also the placeholder @INSTALLDIR@ gets replaced by the actual installation directory. (yes, the original says "is replaces" and honestly? we respect the typo era. but it means replaced, bestie. 😭)

if you don't want a system configuration file at all, just hit it with --disable-system-prefs. bye bye /etc file. 🧚

👑 OPTIONS 👑

  • --disable-system-prefs — do NOT create a system preference file in /etc. we're being independent today. 🚫
  • -x file, --exclude=file — the specified file from the xpi file will not be installed. you can use this parameter several times (stack 'em up, bestie, no limit). 🙈
  • -h, --help — displays a brief help message. short, sweet, slay. ✨
  • -i directory, --install-dir=directory — the xpi file will be installed in the specified directory. directory must be an absolute path. use this parameter with care, fr fr — she said what she said. ⚠️
  • -l directory, --link=directory — an additional link from the directory to the installation directory of the extension will be created. you can use this parameter several times too. 🌈
  • -p package, --package=package — the xpi file will be installed in the specified binary package. if you don't provide this parameter, the first binary package listed in debian/control will be used. she'll pick for you, no stress. 🎀
  • --preserve-permissions — the permissions of the files in the xpi file will not be modified. if this parameter is not provided, install-xpi will try to correct the permissions of the files to 644 (and files that start with a shebang get corrected to 755 instead, because obviously 👑).
  • -r, --remove-license-files — files with names like copying, licence, or license will not be installed. gone, reduced to atoms. 💀
  • -v, --verbose — print more information. she gets chatty. 🗣️

💜 AUTHOR 💜

Benjamin Drung <bdrung@debian.org> — thank you for your service, king 🫡

🌟 reminder bestie: every option above is exactly as written, so don't go freestyling the flags. copy them character for character. periodt.

okay that's the whole page, mwah 💖 this was install-xpi from the mozilla-devscripts suite, dated January 2010. vintage but make it iconic. bye bestie, go package something cute! 🎀✨🦋

📦 where this page comes from