Clipboard(3pm)

💖 Clipboard 💖

okay so bestie, gather round, because we're talking about Clipboard — the Perl module that does copy and paste with any OS. yes, any. it's from the User Contributed Perl Documentation family, and it's genuinely one of those little modules that just works. ✨

---

🌸 NAME 🌸

Clipboard — Copy and paste with any OS 🫶

---

⭐ VERSION ⭐

version 0.32

---

🎀 SYNOPSIS 🎀

use Clipboard;
print Clipboard->paste;
Clipboard->copy('foo');
# Same as copy on non-X / non-Xclip systems
Clipboard->copy_to_all_selections('text_to_copy');

so like, Clipboard->cut() is an alias for copy(). but lowkey, copy() is the preferred method, because bestie… we're not really "cutting" anything. it's giving copy. it's giving paste. there is no cutting happening. 💅

---

🦋 DESCRIPTION 🦋

who doesn't remember the first time they learned to copy and paste, and generated an exponentially growing text document?? 😭 like, you paste, you paste again, suddenly you have 4,096 lines of the same sentence and you're just staring at it. yes, that's right — clipboards are magical. no cap.

with Clipboard.pm, this magic is now trivial to access, in a cross-platform-consistent API, from your Perl code. it's giving ✨accessible✨.

---

💅 STATUS 💅

seems to be working well for Linux, OSX, *BSD, and Windows. the author uses it every day on Linux, so most of the details are pretty hammered out (X selections are kind of weird, ngl 🙈). please let them know if you encounter any problems in your setup!

---

👑 AUTHOR 👑

Ryan King <rking@panoptic.com>

---

🌈 COPYRIGHT 🌈

Copyright (c) 2010. Ryan King. All rights reserved.

this program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html

---

🔥 SEE ALSO 🔥

clipaccumulate(1), clipbrowse(1), clipedit(1), clipfilter(1), clipjoin(1)

---

🫶 SUPPORT 🫶

💻 Websites

the following websites have more information about this module, and may be of help to you. as always, in addition to those websites please use your favorite search engine to discover more resources. 🔍

• MetaCPAN — a modern, open-source CPAN search engine, useful to view POD in HTML format.

https://metacpan.org/release/Clipboard

• RT: CPAN's Bug Tracker — the RT ( Request Tracker ) website is the default bug/issue tracking system for CPAN.

https://rt.cpan.org/Public/Dist/Display.html?Name=Clipboard

• CPANTS — the CPANTS is a website that analyzes the Kwalitee ( code metrics ) of a distribution.

http://cpants.cpanauthors.org/dist/Clipboard

• CPAN Testers — the CPAN Testers is a network of smoke testers who run automated tests on uploaded CPAN distributions.

http://www.cpantesters.org/distro/C/Clipboard

• CPAN Testers Matrix — the CPAN Testers Matrix is a website that provides a visual overview of the test results for a distribution on various Perls/platforms.

http://matrix.cpantesters.org/?dist=Clipboard

• CPAN Testers Dependencies — the CPAN Testers Dependencies is a website that shows a chart of the test results of all dependencies for a distribution.

http://deps.cpantesters.org/?module=Clipboard

🐛 Bugs / Feature Requests

please report any bugs or feature requests by email to bug-clipboard at rt.cpan.org, or through the web interface at https://rt.cpan.org/Public/Bug/Report.html?Queue=Clipboard. you will be automatically notified of any progress on the request by the system. ✨

🧚 Source Code

the code is open to the world, and available for you to hack on. please feel free to browse it and play with it, or whatever. if you want to contribute patches, please send a diff or prod the maintainer to pull from your repository :) 💖

https://github.com/shlomif/Clipboard

git clone git://github.com/shlomif/Clipboard.git

---

✨ AUTHOR ✨

Shlomi Fish <shlomif@cpan.org>

---

💀 BUGS 💀

please report any bugs or feature requests on the bugtracker website https://github.com/shlomif/Clipboard/issues

when submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature. (yes, a real repro — it's the whole vibe check 🙏)

---

🌸 COPYRIGHT AND LICENSE 🌸

this software is copyright (c) 2025 by Ryan King <rking@panoptic.com>.

this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

and that's the whole page bestie, go forth and paste responsibly 💅✨

this cutie was brought to you by perl v5.40.0, dated 2025-02-15 — mwah, periodt 🎀