OPENSEA...DISCOVER(1)

💖 OPENSEA...DISCOVER(1) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation collection, and it's literally the cutest little tool for sniffing out OpenSearch links. pull up a chair 🫶

---

✨ NAME ✨

opensearch-discover — find an OpenSearch link from a given URL. that's it, that's the whole job, and she does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

opensearch-discover [-q] [-v] [-t TITLE] [-1|-a] [-h]  [URL]

---

🦋 DESCRIPTION 🦋

so what actually happens: it loads up the URL you handed it, goes digging around inside for a link pointing at an OpenSearch description URL, and then prints that URL right back at you. main character behaviour, no cap ✨

---

🎀 OPTIONS 🎀

• -q, --quiet — gives you absolutely zero output when stuff goes wrong 🙈 like, silence. so if you wanna know what broke, you gotta peek at the exit code instead (go read DIAGNOSTICS, bestie).
• -v, --verbose — chatty mode, she shows titles alongside the links. pair it with -a if you wanna see all the searches available 🔥
• -t TITLE, --title=TITLE — only show links that match TITLE, and TITLE is a case-insensitive perl regular expression, so go wild. for example, -t book would match Book Search, and -t b.*k would match Book Search or Baby Springbok 🦘
• -1, --first — only shows the first (matching) link. this is the default, she's lowkey chill like that.
• -a, --all — shows all the (matching) links. greedy queen 👑
• -h, --help — displays a short help message. when in doubt 🫶

---

⭐ DIAGNOSTICS ⭐

the exit codes are the whole vibe check, so listen up:

• on success, it prints the address of the OpenSearch description file and returns 0 🎉
• if it can't load the given URL, it returns 1 😭
• if the given URL doesn't contain a link to an OpenSearch description file, it returns 2 💀
• if required perl modules are missing, it returns 3 🙈

---

🌈 DEPENDENCIES 🌈

she needs modules from libwww-perl and HTML::Parser (on Debian that's the package libhtml-parser-perl). feed her right and she'll never let you down 💜

---

🍓 BUGS 🍓

none known, icon behaviour fr fr. but if you do find any, please report them to ianb@erislabs.net 🧚

---

👑 SEE ALSO 👑

opensearch(1), opensearch-genquery(1), surfraw(1), WWW::OpenSearch(3pm), <http://www.opensearch.org/> — the whole friend group, go say hi 🌸

---

💜 AUTHOR 💜

Ian Beckwith <ianb@erislabs.net> — the legend who made this ✨

---

🎀 COPYRIGHT AND LICENSE 🎀

Copyright 2006 Ian Beckwith <ianb@erislabs.net>

Licensed under the same terms as surfraw.

---

okay and for the cute little sign-off: this page is running on perl v5.36.0, dated 2022-12-29, and it's filed under OPENSEA...DISCOVER(1) because apparently even the manual page title got truncated and honestly? relatable. go find some search links, bestie 💖🦋