NAME
Dancer::Plugin::Showterm - Replay terminal typescript captures
VERSION
version 0.0.1
SYNOPSIS
In config.yml:
plugins:
Showterm:
stylesheet: /my_showterm.css
In your app:
package MyApp;
use Dancer ':syntax';
use Dancer::Plugin::Showterm;
...
DESCRIPTION
This plugin is a Dancer port of the wonderful http://showterm.io, which allows terminal screen captures taken via the UNIX tool http://man7.org/linux/man-pages/man1/script.1.html|script to be replayed in the browser.
The plugin will intercept any request for files with a .showterm extension and will generate an html page that will be able to replay the same file, but with the .typescript extension.
In other words, if you put the file mysession.typescript in the public folder of the app, then the url /mysession.showterm will display its webified version. The webified version can also be embedded in other pages via iframes:
<iframe src="/mysession.showterm"
width="660" height="360" style="border: 1px solid #444">
</iframe>
CAPTURING THE ACTION
The cli capture is done using the UNIX utility c<script>. The plugin assumes that the captured screen is 80 columns by 24 rows.
$ script -ttiming
... everything you do here will be recorded ...
^D
$ echo '---' | cat - timing >> typescript
$ mv typescript /path/to/dancer/app/public/myscreen.typescript
Note that the c<typescript> file the plugin uses is the concatenation of the original produced typescript with its timing file, separated with a type dash on a single line.
ADDED ROUTES
/showterm/*
The plugin adds the javascript and stylesheets assets required by the webified typescript under /showterm. Those are bundled with the plugin as shared tarball. If you want to see where this tarball is on your filesystem, you can do
use Dancer;
use Dancer::Plugin::Showterm;
print Dancer::Plugin::Showterm->instance->assets_dir;
or
$ perl -MFile::ShareDir=dist_dir -E'say dist_dir("Dancer-Plugin-Showterm")'
*.showterm
Any request for a file with the extension .showterm will be served the showterm page, using the same uri with its extension changed to .typescript as the script to play.
CONFIGURATION
plugins:
Showterm:
stylesheet: /my_showterm.css
stylesheet
If provided, will be added to the showterm page.
SEE ALSO
- http://showterm.io - the original service
AUTHOR
Yanick Champoux <yanick@cpan.org>
COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by Yanick Champoux.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.