First cut at a video tutorial

[Tim Daly]

Being the "primitivist" I am, I've been looking at Medley from the bits up.

I'm also looking to capture some of the things I've learned and done

in a tutorial form. Attached is a first cut at a video tutorial. It has no

sound. I'm open to suggested scripts that could be read and added.

Feedback, positive, negative, and snide remarks welcome.

Tim

 Maiko-20230211.mp4

[John Cowan]

Please post the script/transcript as well.

--
https://Interlisp.org for more details
---
You received this message because you are subscribed to the Google Groups "Medley Interlisp Users/Interest" group.
To unsubscribe from this group and stop receiving emails from it, send an email to interlisp+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/interlisp/CAJn5L%3DLOCC9BBRsxMavzmSSrPMioVWUopdEYfqxw4uW6D8s7tw%40mail.gmail.com.

[Paolo Amoroso]

Tim, I like your minimalist approach and the video seems clear and easy to follow.

[Paolo Amoroso]

Speaking of tutorials, I recorded a screencast demonstrating basic SEdit mouse gestures for structure selection and manipulation (some production notes).

[Tim Daly]

There is no transcript yet.

[Nick Briggs]

If this were an installation on a system I was actually planning on using, rather than just a demo of how to build maiko, I’d do all of “apt update”, “apt upgrade” and likely reboot and then “apt autoremove”  before doing the “git clone …” and “Install the additional packages that maiko needs” steps.  It looks like a generic 22.04.something LTS release you’re starting from and so missing a lot of security patches and other updates.

If you’re also going to want to build sysouts from source you could also, after the “./makeright x”, do a “./makeright init” which will build the additional executable “ldeinit” in the same place as the other two.

Can’t say I’m a fan of the default Ubuntu purple terminal color, but that’s a purely personal aesthetic choice.  It is legible in the video, which is the most important thing.

It would be handy to have chapter marks in the video where the slides are inserted so that it’s easy to skip over sections (like the “update my distro” part)

Looks like a good start, thanks!

— Nick

[Tim Daly]

The meta-transcript would be the steps to create the video.

Since I have a face for radio and a voice for mime I made some choices,

such as no facial / voice. Anyone is welcome to write a transcript and do

voice-overs.

Problem: How to build maiko

Solution: try, try again.

0) read the documentation (post a patch)

Problem: How to record a window.

Solution: obs-studio

Note that the key trick was setting up hotkeys to start/stop.

1) record each terminal window

Problem: How to make a Medley logo

Solution: gimp

2) Google search logos, screen clip region

 

Problem: How to make banners

Solution: html

3a) make a "slide" for each terminal window

3b) Record browser windows for 5 seconds to make mp4 files per slide

Each html "slide" is a variation of this (missing leading less-than signs):

html>

head></head>

body>

center><img src="medley.png"/></center>

br>

br>

br>

center><h1 style="font-size: 64"><b>VISIT MAIKO ON GITHUB</b></h1></center>

br>

br>

center><h1 style="font-size: 16">https://github.com/Interlisp/maiko</h1></center>

/body>

/html>

Problem: How to make continuous video:

Solution: kdenlive

4a) Add all the mp4 clips

4b) arrange them on the timeline

4c) render the timeline

5) Profit!

So those are the tools. If I can figure out how to meta-record

actions of setting up and using these tools I'll post a video.

On Sat, Feb 11, 2023 at 3:14 AM John Cowan <co...@ccil.org> wrote:

[Tim Daly]

>If this were an installation on a system I was actually planning on using,

>rather than just a demo of how to build maiko, I’d do all of “apt update”,

>“apt upgrade” and likely reboot and then “apt autoremove”  before doing

>the “git clone …” and “Install the additional packages that maiko needs”

>steps.  It looks like a generic 22.04.something LTS release you’re starting

>from and so missing a lot of security patches and other updates.

I'm just using the my normal system. The longer term plan is to put all

of maiko / medley / obs-studio / gimp / kdenlive and other tools into a

single virtual machine. My first attempt failed so I did it on the raw system.

I did the apt instructions because they are in the maiko instructions.

I never use apt autoremove as I've broken too many systems that way.

>If you’re also going to want to build sysouts from source you could also,

>after the “./makeright x”, do a “./makeright init” which will build the

>additional executable “ldeinit” in the same place as the other two.

I have no idea what ldeinit is/does. It took half a day to figure out what

a 'sysout' is, how to find one, and how to invoke ldex on it. I still don't

know why I need a 'sysout'.

The point of the videos is to make it possible for someone like me to get

something running from scratch. I plan to make a video building medley next.

>Can’t say I’m a fan of the default Ubuntu purple terminal color, but that’s

>a purely personal aesthetic choice.  It is legible in the video, which is the

>most important thing.

Purple? I'm partially color-blind so I have no idea what you refer to.

I never manipulate color on anything. Suggestions welcome.

>It would be handy to have chapter marks in the video where the slides

>are inserted so that it’s easy to skip over sections (like the “update my

>distro” part)

I only learned how to use kdenlive yesterday. I have no idea how to

insert "chapter marks". Instructions welcome.

>Looks like a good start, thanks!

I've only learned obs-studio and kdenlive in the last 2 days so there

is much to learn. I normally only work from the command line.

Tim

[Nick Briggs]

On Feb 11, 2023, at 8:50 AM, Tim Daly <axio...@gmail.com> wrote:

Problem: How to make a Medley logo

Solution: gimp

2) Google search logos, screen clip region

 

https://github.com/Interlisp/online/pull/24/files#diff-4bb4bc763f51ec2c368182843135e5ae8a69a4e7eaba6f14b1aef96147e3199a

Frank added SVGs for the medley logo in this PR which should be sufficient for you to locate them.

[Nick Briggs]

On Feb 11, 2023, at 9:06 AM, Tim Daly <axio...@gmail.com> wrote:

>If this were an installation on a system I was actually planning on using,

>rather than just a demo of how to build maiko, I’d do all of “apt update”,

>“apt upgrade” and likely reboot and then “apt autoremove”  before doing

>the “git clone …” and “Install the additional packages that maiko needs”

>steps.  It looks like a generic 22.04.something LTS release you’re starting

>from and so missing a lot of security patches and other updates.

I'm just using the my normal system. The longer term plan is to put all

of maiko / medley / obs-studio / gimp / kdenlive and other tools into a

single virtual machine. My first attempt failed so I did it on the raw system.

OK.

I did the apt instructions because they are in the maiko instructions.

They’re an example of what you might do, not necessarily a prescription for what you must do.  Perhaps I should change the instructions to say “We recommend that you bring your Linux system up-to-date before installing and compiling maiko”

What do you normally do to keep your system(s) updated?

I never use apt autoremove as I've broken too many systems that way.

I always look at what it proposes and decide whether to do it or not.

When I’ve uninstalled something I’ve decided was a failed experiment I use autoremove to clean up the junk it dragged in with itself.

>If you’re also going to want to build sysouts from source you could also,

>after the “./makeright x”, do a “./makeright init” which will build the

>additional executable “ldeinit” in the same place as the other two.

I have no idea what ldeinit is/does. It took half a day to figure out what

a 'sysout' is, how to find one, and how to invoke ldex on it. I still don't

know why I need a 'sysout'.

Yeah, one wouldn’t — ldeinit is used behind the scenes by the “loadup-xxx.sh” scripts in medley/scripts for building new sysouts from source.

A sysout is the Lisp VM image (program/data, Lisp machine state), in the same way that you have a (Linux, Windows, …) VM image that’s executed by the hypervisor (VirtualBox, QEMU, VMware, bhyve, MS Virtual PC, ....).  

“lde” is the bootstrap program that starts the display-specific program (“ldex” in your case) that contains the (conceptual hypervisor equivalent) Lisp VM implementation that executes what’s in the sysout.  That is, it allocates system memory for the Lisp memory, restores the program/data from the sysout to that memory, restores the Lisp machine state, and then starts executing the Lisp VM instructions at the newly restored Lisp program counter, resulting in the bits you see displayed on the screen.

The point of the videos is to make it possible for someone like me to get

something running from scratch. I plan to make a video building medley next.

I agree — I’m glad you’re doing this, and since you were asking for suggestions, I’m making some.

>Can’t say I’m a fan of the default Ubuntu purple terminal color, but that’s

>a purely personal aesthetic choice.  It is legible in the video, which is the

>most important thing.

Purple? I'm partially color-blind so I have no idea what you refer to.

I never manipulate color on anything. Suggestions welcome.

Ah, OK.  So I can make suggestions on what color values would work for me but since I don’t know whether they would work for you that might not be that helpful.

>It would be handy to have chapter marks in the video where the slides

>are inserted so that it’s easy to skip over sections (like the “update my

>distro” part)

I only learned how to use kdenlive yesterday. I have no idea how to

insert "chapter marks". Instructions welcome.

I’ve never used kdenlive (I’m a macOS Final Cut Pro X person), but this is their manual for “guides” (and “markers”) https://docs.kdenlive.org/en/cutting_and_assembling/guides.html where they explain how to add them and export them to YouTube (Export guides as chapter description).  It’s a bit losing that it seems you have to export the chapter marks separately since they are easily encodable natively within an MP4 file (e.g., https://developer.apple.com/library/archive/technotes/tn2174/_index.html ), but perhaps it just requires more exploration of kdenlive to see if it’s present in some other non-obvious form.

>Looks like a good start, thanks!

I've only learned obs-studio and kdenlive in the last 2 days so there

is much to learn. I normally only work from the command line.

Impressive progress!  I’m also more command line oriented than the youngsters… my first timesharing system access was via a TI Silent 700 ca. 1972.

[Tim Daly]

re: apt instructions and system update instructions in general.

I agree they aren't relevant to medley related videos. I'll remove them.

re: medley logos. They're svg files it seems. I'll try to use them.

re: loadup-xxx.sh scripts ... I'll see if I can figure out how to build a

sysout from scratch once I finish the medley build video. Are there

instructions somewhere?

re: chapters. Good idea. I'll see if I can figure it out. Thanks.

I'm pondering a top-level tutorial video that points at the other

ones and introduces why anyone would care and how they fit

into the learning experience. Chapters would help there. I'm

thinking of it as a "course syllabus". I guess I spent too much

time teaching.

Thanks for the feedback.

Tim