How I Create Video Tutorials
September 11th, 2008 | Posted in Technical Writing |
Creating video tutorials is no trivial task. When you sit down to create 20+ video tutorials for a project, you’re faced with dozens of questions. What screen size should the videos be, what recording tool should you use, what microphone is best, how long should the videos be, what file size is acceptable? Should you use voice or captions? Where will you create the recording?
You can create video tutorials using dozens of different methods. There are no official steps to create videos, because situations and audiences vary so widely. If you’re creating e-learning with quizzes for a global audience, your approach will be different from one who is creating demo videos for a small company.
Having said all that, here’s my general process for creating video tutorials:
- I copy a topic from my help, put it into a Word document, and modify it into a script that I’ll read. I’ve tried being more spontaneous and off-the-cuff rather than reading scripts, but I end up having to restart so many times that it frustrates me. Scripts are fine, as long as I can communicate the info without sounding too much like I’m reading. Ideally, I start the script off with a conceptual paragraph that I illustrate in the video with a diagram. The more I write, the more I find that everyone wants to see a visual workflow or process.
- I find an empty, quiet conference room. Luckily, at my work there’s a conference room that can’t be scheduled (so it’s often free), and it’s not adjacent to any office or other conference room. In general, I turn off anything in the room, such as a humming computer, air conditioning machine, ticking clock, or mini-fridge. One day I’ll make my own sound booth to dampen the acoustic echoing.
- I connect my microphone to my laptop. I use an H4 Zoom recorder that connects to my laptop with a USB cord. My laptop then recognizes the Zoom as a microphone device. The Zoom H4 records pretty clearly, but since it’s a little pricey ($300), I also recommend a high-end Plantronics headset ($90). Whatever you use, avoid using your laptop’s built-in mic (because it sounds like a CB radio).
- I open up my recording tool and the software application I’m explaining. I then fit the recording screen to the application. I personally like Camtasia Studio because it allows me to edit full-motion recording in ways that Captivate doesn’t. 640 x 480 is a good screen size, especially since some users may have their resolutions set at 1024 x 768. I start at 640 X 480 and drag the recording edge to 1000 x 750 (this keeps the same proportions while allowing me to capture the entire application; when I later edit and produce at 640 X 480, the video still looks clear because it’s proportional).
- I prop the script up next to my laptop’s screen, and then simultaneously read my script as I move and click my mouse in the application to demonstrate a task. This is the hard part. I use the pause and resume hotkey (F9 in Camtasia Studio) to recompose myself or clear my throat if necessary. It’s hard to look at a script while also looking at the monitor, but if I keep the steps simple and short, I can often manage it without too many restarts.
- As I read, I try to avoid swallowing, licking my lips, breathing loudly through my nose, stuttering or stumbling, over-enunciating, mumbling, sounding as if I’m reading, coughing, yawning, mis-pronouncing words I never have trouble with, or veering off my script.
- When I’m finished making several recordings, I trot back to my desk and start editing the recordings. If the script has a conceptual intro, I insert a diagram (which I draw in Visio and Photoshop) depicting a workflow, process, or other concept. I think the visual diagram works well at the beginning of a tutorial, as it gives variety to the demo and grounds the user in a better understanding of the overall process.
- As I edit the recording, I often need to manipulate the audio or video independently. In Camtasia Studio, I do this by selecting a portion of the audio, and then choosing File > Produce Selection As. I then produce just an MP3 file at max quality. I silence the audio on Track 1, and then import the produced MP3 file back into my project and add it to Audio Track 2. I can then move the audio independently of the video.
- I publish the video tutorial. Although I compress the audio, I crank up the audio quality all the way. I keep the JPEG quality at about 93%, set the frame rate at about 10, and use the One Show format because it includes the preloader (whereas Express Show doesn’t). I always keep the file size around 15 MB or less because I have some users in South America and I’m not sure what their bandwidth speeds are. By keeping the videos about three minutes or less, the file size rarely exceeds 15 MB. (Almost no one has an attention span that lasts more than 5 minutes anyway.)
- I integrate the videos into my online help file in the appropriate topics using a little javascript that pops open a new window sized just about the same as the video dimensions. Here’s the javascript:
<a onclick=”window.open(’http://mydomain.org/training/helpresources/rp/Documents/Videos/Create New Widgets.html’,'RPvideo’,'width=660,height=560,resizable=no’);return false”/ >
<img style=”text-decoration:none; border:none;” src=”../../Resources/Images/videocamera.gif” alt=”" /> Watch Video </a>I also publish a web menu (”Camtasia Theater”) of the video tutorials, and create a help topic with a list of them all.
That’s my process, in a nutshell, for creating video tutorials. Overall, I’m pretty happy with it, but especially with the independent audio/video manipulation and the integration of the visual diagrams to reinforce understanding. The Zoom H4 acting as an audio interface also records with near-perfect clarity.
But I am looking to improve several things. First, I want to sound less like I’m reading, while still reading. I also need to get faster at creating visual diagrams. Finally, I’m a little perplexed that my scripts vary so much from my help topic text. When I arrange the text in a script, I listen to myself talking it out, and I start making dozens of changes. Ideally, I’d like to have my video scripts single source from my help topic text.
I dislike captions in place of voice. I once asked a user which he preferred, and he said voice ten to one. I agree. Of course voice is much more problematic for translation, but I don’t have to worry about that (yet).
I’m also not fond of the “let-my-try” videos. We have a test environment where users can experiment, and it’s just as easy to send them there to play rather than requiring them to click little hidden pixels here and there.
That’s what works for me. What’s your process for creating video tutorials? Do you have any tips or advice for me?
Related Posts
- Thinking About an STC Proposal to Submit
- Tip: Search Engine Optimize Your Blog Posts to Increase Your Readership
- Welcoming Camtasia Studio as a New Blog Sponsor
- Podcast: Using Video in Training and Documentation, Interview with Todd O’Neill
- Combining Podcasting with Technical Writing
Tags: Camtasia Studio, Captivate, create video tutorials, microphones, video tutorials, Zoom H4 microphone
Twitter
iTunes




September 12th, 2008 at 2:27 am
I didn’t publish video tutorials in any online help project yet, but I prepared some for my blog and I worked similarly. Though I’m not to happy with Camtasia here; being used to more complex video applications like Ulead Mediastudio, I find it lacking in handling and options. Cutting pieces out is not optimally solved IMHO.
On a side note, I’m currently doing a project with SAP tutorials, and there the users record their processes and transactions with SnagIt, basically making their own tutorials but not for publication, only for us to transfer it to “paper”. It works wonderfully and everyone’s pleased by the solution so far!
September 12th, 2008 at 4:58 am
I record my audio first and then record my video. I think of it as a music video work-flow. This allows me to focus on the audio and then make my video clean and sharp. It also seems to take me less takes, which is nice.
Chris McQueens last blog post..Don’t Panic!
September 12th, 2008 at 11:06 am
I might suggest a different approach. Focus initially on recording the screen actions. Even in Camtasia, I believe you are able to add a separate audio track.
When you look at how the “big guys” (Hollywood and other movie producers) do things, do they record the actual sound of the actors speaking the lines while filming the movie? Nope. They splice in the audio track as a separate process.
I think if you give that a try you will find you are able to achieve what you are looking for with making your script sound more natural.
Cheers… Rick
September 13th, 2008 at 12:05 pm
Dear Sir
Thank you for the benefit of your wisdom, it lit up my face like the sun rising in the morning. I most enjoyed the style of your writing and respect your expertise like a man might respect an elder who has killed a lion.
I was wondering are you by any chance the famous Olly Walker of Squamish who delivered the celebrated “Remembering the User: Tricks for Making Drupal Easier” presentation at Raincity Studios, or if not, then are you at least related to him?
I say this as your style of writing is beautiful, like a peacock sitting on a greenhouse in the middle of summer. You are able to put across points clearly even when they are complex and mind-blowing. You have a gift and you use it wisely.
I will return to receive further valuable tuition from you.
Yours faithfully
Dr Lawrence Bariga
September 14th, 2008 at 8:12 am
I found that step 1 (turning the Help into a Script) makes me extremely proficient with the content i’m documenting. A huge benefit
avis last blog post..המטבח האובייקטיביסטי * האולטימטיבי
September 14th, 2008 at 9:29 pm
[...] How I Create Video Tutorials(14 September 2008) Creating video tutorials is no trivial task. When you sit down to create 20 video tutorials for a project, you8217re faced with dozens of questions. W… [...]
September 15th, 2008 at 3:56 am
My only tip would be: don’t worry too much about recording a flawless commentary. The videos that come with the Rally project management system are a good example of unpolished videos, complete with a few ums and ahs, and I think it lends a certain authenticity. I tend to be a little suspicious of videos that are very polished.
I also completely agree with you about labels versus voice. Maybe I’m just lazy and I’d rather hear someone explaining things rather than have to do the reading myself. One of the things that disappoints me with Flare (might have changed in version 4) is that their videos are all labelled and all you hear is the fake mouse clicks.
For me, hearing someone explaining something to you in their natural voice (maybe with a few pauses and ums and ahs) immediately makes the subject less intimidating.
Alistair Christies last blog post..ITauthor podcast #15 - September 13th, 2008 - Virtual Machines
September 15th, 2008 at 3:56 am
Rick is on the right track. I do audio separately myself.
Actually, I prefer captions and flash highlighting within the project as well… and screenshots and vector based mouse movement vs live vid.
Otherwise these are all great tips!
Charless last blog post..Wordle: Just check it out
September 17th, 2008 at 12:17 pm
While using Adobe Captivate, I have found that using a little free application called Sizer (just google that word) helps me keep my windows a uniform size and position on the screen.
This way, if I have to come back and use Captivate to record additional slides down the road, I can keep the transition from being choppy.
Thanks for your tips!
September 18th, 2008 at 9:58 am
[...] How I Create Video Tutorials [...]
September 19th, 2008 at 12:39 am
@ M. Hunsberger, Thanks for the tip about the Sizer tool.
September 19th, 2008 at 12:53 am
@ Charles, I’ve been experimenting with more of the technique you describe — doing the audio and video separately. You’re right, it lends itself towards a more professional video.
September 19th, 2008 at 12:59 am
@ Alistair, I agree with you about the danger of flawless commentary. There’s a certain inhumanity that can result from a script that’s read too-slick and polished. Making a script sound natural and human is an art. I don’t know if you use scripts, but I really enjoy the conversational tone of your podcasts (however, it seemed that with the VM podcast you used a script — but it was still great content).
Re the labels and Flare, I also agree with you. Actually, I think their development of Mimic is a waste of time. Mimic is so far behind Camtasia and Captivate, I can’t see anyone adopting it as their video recording tool of choice. I’d rather they put all their resources behind Flare.
September 19th, 2008 at 1:22 am
@ Dr. Lawrence, Dude, your comment made me chuckle. Thanks. You might want to lighten up on the similes.
September 19th, 2008 at 1:28 am
@ Rick, Thanks for the tip and the comparison to Hollywood movies. It always amazes me how they’re able to record the movie and later sync up the audio like that. Since writing this post, I have been experimenting more with methods more similar to this. Thanks again for commenting.