App::Termcast(3pm)

💖 App::Termcast — the perl man page but make it cute 💖

okay bestie, sit DOWN because this is the User Contributed Perl Documentation page for App::Termcast, and it's literally about broadcasting your terminal to the whole internet. main character energy fr. 🎀

---

✨ NAME ✨

App::Termcast</purl> — broadcast your terminal sessions for remote viewing 🦋

🌸 VERSION 🌸

version 0.13 ✨

🫶 SYNOPSIS 🫶

okay so here's the vibe, no cap:

my $tc = App::Termcast->new(user => 'foo');
$tc->run('bash');

that's it. that's the whole thing. two lines and you're famous 💅

💜 DESCRIPTION 💜

App::Termcast is a client for the <http://termcast.org/> service, and that service is the one that lets you broadcast a terminal session so other people can watch it remotely. it's giving screenshare but make it text. 🌈

👑 ATTRIBUTES 👑

🌟 host

the server you're connecting to. defaults to noway.ratry.ru, which is the host for the termcast.org service. 🦋

🌟 port

the port to use on the termcast server. defaults to 31337. iconic number honestly. 🔥

🌟 user

the username you're using. defaults to the local username, so it just kinda knows who you are. 💫

🌟 password

the password for the given user. here's the tea though: the password gets set the first time that username connects, and then it has to be the same every single subsequent time. it is sent in plaintext as part of the connection process, so do NOT use an important password here, bestie I am begging. 🙈

defaults to 'asdf' since really, a password isn't all that important unless you're worried about being impersonated.

🌟 bell_on_watcher

whether or not to send a bell to the terminal when a watcher connects or disconnects. defaults to false. 🔔

🌟 timeout

how long in seconds to use for the timeout to the termcast server. defaults to 5. ⏳

💅 METHODS 💅

✨ establishment_message

returns the string that gets sent to the termcast server when connecting — typically containing the username and password. 🎀

✨ termsize_message

returns the string sent to the termcast server whenever the terminal size changes. so like, when you resize your window, it snitches. respectfully. 🪟

✨ write_to_termcast $BUF

sends $BUF to the termcast server. 💌

✨ run @ARGV

runs the given command in the local terminal as though via system, but streams all of that command's output to the termcast server. the command may be an interactive program — and in fact, that's the most useful case. periodt. 👑

🧚 TODO 🧚

use MooseX::SimpleConfig to make configuration easier. (a glow-up that hasn't happened yet, we're manifesting ✨)

💀 BUGS 💀

no known bugs. queen behavior honestly. 👑

please report any bugs to GitHub Issues at <https://github.com/doy/app-termcast/issues>. 🐛

🌈 SEE ALSO 🌈

<http://termcast.org/> 🦋

🍓 SUPPORT 🍓

you can find this documentation for this module with the perldoc command:

perldoc App::Termcast

you can also look for information at:

• MetaCPAN — <https://metacpan.org/release/App-Termcast>
• Github — <https://github.com/doy/app-termcast>
• RT: CPAN's request tracker — <http://rt.cpan.org/NoAuth/Bugs.html?Dist=App-Termcast>
• CPAN Ratings — <http://cpanratings.perl.org/d/App-Termcast>

⭐ AUTHOR ⭐

Jesse Luehrs <doy@tozt.net> 💖

🎀 COPYRIGHT AND LICENSE 🎀

this software is copyright (c) 2014 by Jesse Luehrs.

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!! 💜 this one's from perl v5.34.0, dated 2022-06-08, and it lives at App::Termcast(3pm) in the User Contributed Perl Documentation corner of the world. go forth and broadcast, you absolute icon. 🫶✨