Lodahl's blog

03 February 2013

Video tutorials and promotions


If you look around on Youtube and other video repositories you will find that many tutorials are available for open source projects. I my self learned Gimp qiute fast using these small videos. Many of the videos are produced by absolute amateurs but never the less brings a lot of value to the projects.
'These videos are an important part of marketing but also a simple way of teaching users how to do stuff with your application.

Unfortunately LibreOffice don't have a tradition for making tutorials or promotion videos. I would like us to change that.

I have made a few tutorials but none of them is close to being perfect. I'm also an amateur when it comes to making videos. Never the less I would like to parse my experience to others both in LibreOffice but also in other open source project. 

If you have comments or if you can help me with additional knowledge - please don't hold back :-)

Lesson one: Prerequisite

Before you even begin thinking of making video tutorials you need to get some software. But before that you need a piece of hardware to run your software on. And of cause you do. But I mention this explicitly because when it comes to video and audio editing the hardware configuration is essential. Even a recording of your desktop actually requires quite a lot of effort from your hardware. I recommend at least 4 Gb RAM and a dual core processor. I am using Ubuntu Linux 64 bit on a 4Gb Ram machine and I don't always have enough power.

We need some tools, right?

Yes. First of all you need a program to record your desktop. I find that Recordmydesktop suites my needs. I'm some kind of a KISS (Keep It Simple Stupid) person. Recordmydesktop does what the name says: It records my desktop and saves it as a video file on my hard drive. Other programs does the same and its completely up to you. Recordmydesktop is in most Linux distributions repositories so search for it.

A nifty little tool I have found is the key-mon project (http://code.google.com/p/key-mon/). This is a small window on your screen that shows what happens on your keyboard. Remember the desktop recorder doesn't record your keyboard and key-mon just shows any keyboard activity on the screen so that this will be recorded as part of the video. If you want to explain shortcuts and other keyboard tricks this is absolutely a nice tool.

You need some image editing software too. I usually use Gimp but from time to time I need to edit scalable vector graphics too so I recommend also to install Inkscape. Both applications are probably in your distribution already.

Editing the video is what is the key issue. I prefer OpenShot but you can use Kdenlive or other programs if you like. OpenShot has been criticized for being unstable and that it lacks advanced features but I find that it suits my needs and when it comes to stability its not more nor less stable than other applications. When OpenShot crashes its usually because of lack of ram on my computer.
If you want to use speak in your video you will first of all need a good microphone. The built in microphone will usually NOT do the job. I have a set of earphones with a microphone that didn't cost much. But I know that others prefer to record the voice on a mobile phone witch is actually a pragmatic solution.

You might find that OpenShot can do what you need with the voice track but if you need to edit or fine tune you voice take you might find Audacity a nifty tool. I think Audacity is state of the art when it comes to audio editing.

Lesson two: Plan the video

Before you even think of recording anything you must plan the project. First is to create whats called a story board. Imagine what you want to do in your video and write it down. Break the video down into scenes. Write down precisely what is to happen in each scene. For each scene you should also plan whats on the screen before you start. An empty desktop or the application open? Should you prepare a document?

Remember that when you shift from one scene to the next you might want the two scenes to be linked together in the way that the second scene starts exactly as the previous scene ended. Write that down.
My experience is that the more you prepare in the story board the easier the rest of the work will be. You simply can't prepare enough but experience will show you.

Lesson three: Strategy

Do you want to make the complete tutorial in one shot and speak as you take the scene? Or do you plan to take each scene one by one and then cut/paste everything together when you are done? You can even do the complete video and cut it together and then record the speak later.
If you plan to take everything in one shot you will need to rehearse several times before you record it. If you prefer this strategy you will most likely end of with a great tutorial but with a lot of small mistakes. But if you rehearse before you record you can do it. Some of the best tutorials on Youtube are made this way.
I prefer to take each scene one by one. That way I can re-take a scene if I make too many mistakes. I also prefer to record and add the voice at a later time. One reason is that I either ask somebody else to speak or that I need to record the voice in a different place.

On the other side some of the best tutorials are actually one long take. Take a look at this example: https://www.youtube.com/watch?v=A8OTSC_iVT0

This is a video where you can feel the soul of the author. You kan feel that this guy really loves what he is doing. If we edit too much we will end up having a nive video but with no spirit. The key is in the voice.

Lesson four: Recording voice

My office isn't a good place to record voice because there is too much background noise. Besides that the room is an office with hard walls and floor. In professional sound recording studios you will find that the room is covered with soft material to avoid sound reflections. You can imitate that by using a room with soft walls and heavy curtains. The best place to record voice is actually in my bedroom.  

02 February 2013

LibreOffice and CMIS

Here you can see a short video demonstration of how CMIS integration works in LibreOffice 4.0:


24 January 2013

LibreOffice and OpenClipart.org


For several years I have been very fond of clip arts from the Open Clipart Library (OCAL) and when LibreOffice now has built in usage of SVG files I was very happy. Now I could use these exelent cliparts in scalable format. Until then the only way was to convert to bitmap (png or jpg) format first.
Soon I began thinking of getting access to the library directly from the UI in LibreOffice. I  discovered that from Inkscape you can insert cliparts from online already.


Hmmm. It must be possible in LibreOffice also. I investigated the API.
I started prototyping in LibreOffice Basic and even got as far as designing a dialog and access to the API.

Aaaarg handling JSON and XML in LibreOffice Basic is .......trouble! Ok I then started over with Python. Perfect because I can handle JSON and XML quite easy.


The project has been described before and its on the list of potential GSOC project on the wiki.
Nice. And there is even a prototype from an earlier GSOC project there ;-) 


I made a few mock ups (Gimp) showing my idea about using the task panel.

I talked to one of my colleagues about it (I don't know about C++ at all). He grapped the idea just a few days ago and we will continue to work on it together. The idea is to look at both the Inkscape implementation and the GSOC project and create a prototype.

Dear students: I don't like taking the bread out of your mouth bu my colleage is a newbee in LibreOffice context and I am taking the liberty to look at this as "easy hack" for my friend.

Please tell me what you say about the rough drafts here. Is this something that will be of value to you?

13 December 2012

MSIEXEC parameters

Some time ago I wrote a few articles about administrative installation of LibreOffice on Windows. I have had quite a lot of feedback. Later there has come a wiki page on The Document Foundation wiki: Its called Deployment and Migration.

Nice but its still rather cumbersome to actually create a parameter string that works.

I have created a MSIEXEC parameter generator in a very simple spreadsheet. You can fill in the questionnaire and with a single click you get the complete string of parameters. There is not much error handling and evaluation so you can actually generate strings that doesn't work when you try to run it. But that might come later if any interest?

You can find the template with the macro on the extension website: http://templates.libreoffice.org/template-center/libreoffice-msi-generator . The template is waiting for approval currently, but I expect it to be approved shortly. Until the template gets approved you can get it from Dropbox here: http://dl.dropbox.com/u/9348527/LibreOffice_MSI.ots.

09 April 2012

The task panel in LibreOffice

LibreOffice has a very little known feature called the task pane. You might already be familiar with the navigator and the Styles and formatting dialogues. These dialogues are dockable whitch means that you can glue the dialogues to the border of the LibreOffice window.

It is however possible to create your own dockable dialogues. The dialogue becomes dockable through the so called task panel.

The task panel is only visible when you actively choose to show it and besides that you can only show it if it has content. In the view menu you might find the menu item “Task panel”. But as mentioned its only present in the menu if the task panel has an active content. When its visible it can be docked to one of the sides of the window or it can be floating. You can move it around and put it where you find it best for you.

In my case I have transformed an existing extension – the “Lorem Ipsum Generator” to show up in the task panel. As the task panel has a very little prominent occurrence in LibreOffice I decided to keep the Lorem Ipsum icon in the tool bar but now it only toggles the task panel on and off.

The result is that the tool becomes available at all times. Not open and close the dialogue any more. Just put the cursor wherever you want some dummy text and click the button in the task panel.

Usability

In the discussion about usability and “the new GUI” I think this could be the beginning. Of course the whole concept must have an overhaul as there are still some problems. First of all I don't think it's possible to use a localizable dialogue in the task panel. Therefore I had to keep the dialoque in English only but I hope that this will be only for a short time until I find out how to localize it. Another problem is that its not a trivial task to transform a dialogue into a a task panel item. I don't even think its possible to do with basic alone. i think it should be possible to generate an extension with dockable dialogues as its possible to generate extensions with the extension packager.

Anyway. I believe that the task panel could easily become a very important step into a new GUI. Not alone but followed by other efforts. Also we need to discuss if some of the existing built in dialogues in LibreOffice could easily be transformed into dockable tools. One thing I personally would like to see is the word count dialogue made dockable. Since 3.5 this dialogue has been modal witch means that it can be open while you type. It would be an obvious decision to put that dialogue in the dock.

What do you think? Would it be a good idea to continue to work on the task panel idea?

If you want to try my extension you can find it here: http://dl.dropbox.com/u/9348527/LoremIpsum.oxt but please have in mind that its not yet completely finished.