view web/about/ttyrec.html @ 82:14850d283b54

Update information about ttyrec terminal size.
author John "Elwin" Edwards
date Wed, 07 Feb 2018 20:54:48 -0500
parents 2cca66b3e262
children d417016bbf73
line wrap: on
line source

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>TTYREC files</title>
<link rel="stylesheet" type="text/css" href="/main.css">
</head>

<body>
<h1>TTYREC files</h1>
<div class="nav"><a href="/">rlgallery.org</a> -&gt; <a href="/about/">About</a> -&gt; TTYRECs</div>
<div class="content">
<p>TTYREC files are recordings of text-based sessions, much like screencasts are recordings of graphical sessions. The Roguelike Gallery and other roguelike 
sites create ttyrec recordings of games played online, so that others can watch them. The <a href="/archive.cgi">Archiver</a> will search rlgallery.org's 
ttyrecs for you.</p>
<p>As you might expect, ttyrecs are not video files that can be played in video players. They contain mostly text, and you will need a ttyrec player to 
watch them.</p>
<p><a href="http://0xcc.net/ttyrec/">The original ttyrec program</a> comes with ttyplay.</p>
<p><a href="http://angband.pl/termrec.html">Termrec</a> includes termplay, which is easy to use and works on Windows.</p>
<p><a href="http://www.chiark.greenend.org.uk/~sgtatham/ipbt/">IPBT</a> is a newer player that allows you to rewind while playing.</p>
<p>A ttyrec produced on one kind of terminal will not play properly on a different kind of terminal. Most modern terminals are similar and should produce 
compatible ttyrecs, but you might come across a file that won't work.</p>
<p>Replaying also might not work properly if your terminal is a different size from the one that produced the ttyrec. If things are getting drawn in the 
wrong places, try making your terminal bigger.</p>
<p>Unfortunately, ttyrecs don't contain any metadata which could tell you what the proper size is. But most recent files from the Gallery and similar sites
work around this limitation by putting some invisible text at the beginning. You can read it by opening the ttyrec with a hex editor or text editor. There
will be a line starting with "Size:" followed by the terminal width and height.</p>
<p>Note: if you are using ipbt, you must also tell ipbt what size terminal to use. Check ipbt's documentation.</p>
</div>
<div class="foot"><a href="/">rlgallery.org</a> <a href="/recent.cgi">Recent Games</a> <a href="/scoring/high.cgi">High Scores</a> <a href="/notes/">Notes</a> <a href="https://rlgallery.org:8080/">Play</a></div>
</body>
</html>