## ## ######## ## ## ######## ######## ## ##
## ## ## ## ## ## ## ## ### ##
## ## ## ## #### ## ## #### ##
##### ######## ## ## ###### ## ## ##
## ## ## ## ## ## ## ## ####
## ## ## ## ## ## ## ## ###
## ## ## ## ## ## ######## ## ##
> That's easy for you to say, Mr David, you're a human
What is Kryten?
Here is a presentation made with Kryten.
Kryten is Unix Shell tool that makes terminal-based presentations a snap to write, present, and share.
Kryten takes it's name from Kryten of the British television series Red Dwarf
Why Kryten?
Kryten allows presenters to focus on the presentation without having to type code. It types the code for you and runs it. With Kryten, you present live code demos from prewritten presentation files. Write the presentation beforehand, and play it, step-by-step with Kryten. You can pause the presentation at any time, play backwards, and forward. It also edits files for you using a built-in editor.
When running on Mac, Kryten has the ability of reading comments in the code using text-to-speech. This allows turning a code into a video tutorial without human intervention.
Moreover it always checks the difference between the current files and what they are supposed to be and it only types in the differences.
While it can edit any types of file interactively, the shell commands are restricted to bash and Python commands.
Installing Kryten
pip install kryten
or download kryten.py from this repo.
Usage
Command line options
$ python kryten.py -h
Usage:
play (record mode)"
play [options] -p filename.play (playback mode)"
play [options] -i input -o output (editor mode)"
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-n, --nonblock do not ask for intput
-d DELAY, --delay=DELAY
typing delay
-p PLAY, --play=PLAY file to play (play mode)
-i INPUT, --input=INPUT
input file (editor mode)
-o OUTPUT, --output=OUTPUT
output file (editor mode)
-s, --speak read comments, mac only
-D, --debug stops on tracbacks
-m MARKMIN, --markmin=MARKMIN
saves markmin output (experimental)
Writing a presentation
Kryten works with .play files.
Syntax
Start comments with a #
Mark file edits with @@UPDATE@@ path.to/file.ext
, followed by the new file contents, ending with @@END@@
.
Try an play an existing file:
>>> python kryten.py -d 0.05 -n -p python101.play
A simple example
This example presentation presents a couple Python loops.
example1.play
# a simple loop
for i in range(5):
print i
# another loop
for i in range(5):
for j in range(3):
print i+j
# print something
print 'hello world'
quit
Example with file edits
Kryten uses diff comparison to update files on the system. Use @@UPDATE@@ path.to/file
to start a file edit block. Write how the file should look post-edit and end with @@END@@
.
example2.play
# create a file
@@UPDATE@@ file_edit.txt
a sample presentation
@@END@@
# update the file
@@UPDATE@@ file_edit.txt
a sample presentation
with another line
@@END@@
quit
Interactive Commands
Commands in shell:
SPACE execute and move to next line
q quit
p previous
n next without execue
x quickly execute and move to next line
Commands in editor:
SPACE next line
UP, DOWN for moving highlited line
q quit
b previous
n next
s save partial
x quickly execute end exit
(i intrecative mode - not yet suported sorry)
License
Copyright © 2012 Massimo DiPierro.
Licensed under the BSD license.
http://opensource.org/licenses/BSD-2-Clause
Thanks
Thanks for Devon Blandin for help with the docs and text alignment.