APTURL(8)

📦 version 0.5.2ubuntu24, in ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 APTURL — the girlies' guide to the apt-protocol installer 💖

okay so bestie, welcome to apturl, section 8 of the System Manager's Manual. she's a graphical apt-protocol interpreting package installer and she's literally iconic. let's get into it 🫶

✨ NAME ✨

apturl — a graphical, apt-protocol-interpreting package installer. yes she installs things, yes she's graphical, yes she speaks the apt-protocol fluently. queen behavior 👑

🌸 SYNOPSIS 🌸

apturl [options...] <URL>

that's it. that's the whole vibe. you give her options (maybe), you give her a URL, she does the thing. 💅

🦋 DESCRIPTION 🦋

so apturl is a simple graphical application, right? she takes an URL (one that follows the apt-protocol, obvs) as a command line option, parses it, and then carries out the operations that the URL describes.

and what does "carries out the operations" mean in this context, you ask? it means she asks the user if they want the indicated packages to be installed — and if the answer is positive, she does so. consent-based installation, we love to see it. ✨

🎀 USAGE 🎀

okay so here's the tea: apturl just needs an URL conforming with the apt-protocol in order to work. that's her whole requirement. that's her bare minimum. she's low maintenance like that 💜

additionally, she recognizes the following options:

  • -p, --http-proxy — use the given HTTP proxy in order to download the packages. if you're behind a proxy, this one's for you, bestie 🌈

💅 EXAMPLES 💅

these are giving "here's exactly how you'd use her" and honestly? obsessed.

install Pidgin and the Pidgin Plugin Pack (if the user confirms):

apturl apt:pidgin,pidgin-plugin-pack

enable the "universe" component and install the package Freevial:

apturl apt:freevial?section=universe

enable the "partner" repository and install the package adobe-flashplugin:

apturl apt:adobe-flashplugin?channel=lucid-partner
btw the available repositories are listed in /usr/share/app-install/channels/ — noted, filed away, bookmarked, all of it 🗂️

install 2vcard from the indicated PPA (if the user confirms), and afterward ask if the PPA should be removed again or it should remain enabled:

apturl apt+http://launchpad.net/~mvo/ppa?package=2vcard
⚠️ Warning: this one is currently disabled because of security concerns. so like... look at her, appreciate her, but she's not available rn 😭

🫶 EXIT CODES 🫶

the receipts, basically. here's what each one means:

  • 0 — all requested packages have been successfully installed or were already installed. slay, no notes ✅
  • 1 — the user aborted the installation of one or more packages. okay, fair, your call 🙈
  • 2 — there was an error doing the requested operations, or the user aborted the installation while Synaptic (and not apturl herself) was working. plot twist: it wasn't even her fault 💀
  • 3 — the arguments with which apturl was called were incorrect (e.g., it was called without any argument or the given URL was wrong). check your URL bestie, something's off 🔥

😭 BUGS 😭

found a bug? please report any bug on:

https://bugs.launchpad.net/ubuntu/+source/apturl

she's not perfect, she's just like us fr fr 🐛

🌈 SEE ALSO 🌈

  • synaptic

(they're besties, iykyk)

👑 AUTHORS 👑

apturl was written by Michael Vogt <michael.vogt@ubuntu.com> for Canonical, Ltd. — and this manual page by Siegfried-A. Gevatter <rainct@ubuntu.com>. absolute legends, both of them 🫡

she's released under the GNU General Public License, version 2 or any later version published by the Free Software Foundation. free as in freedom, periodt 💖

and that's the whole page, bestie ✨ this manual page is dated September 01, 2008, and it lives in the System Manager's Manual (that's the section 8 energy). go forth and apturl responsibly 🧚💜

📦 where this page comes from