VideoLAN Wiki - User contributions [en]

VLC HowTo/Use for transcription (Linux)

2010-10-06T11:14:33Z

Derek:

'''OVERVIEW:'''

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

 There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.  This script was written for linux, but might have some useful information for anyone trying to do this on other platforms. 

 '''PREREQUISITES:'''

First, you need to have [http://www.videolan.org/vlc/ VLC] (obviously), [http://www.python.org/ python] 2 OR 3, [http://hoopajoo.net/projects/xautomation.html xautomation] OR a version of [http://www.semicomplete.com/projects/xdotool/ xdotool] (newer than august 2010), and you need the openbsd implementation of [http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/nc/ netcat].

 The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need. Unfortunately, the GNU implementation of netcat, which is the default in most distributions, does not seem to support UNIX sockets (the -U switch for nc.openbsd). If you run slackware and can't find it, check [http://www.slackbuilds.org slackbuilds]. 

 xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

 '''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

 To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

 You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

 Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

 Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

 I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

 If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

 If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

 In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:

<code></code>
<pre> keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</pre>
 

'''VLCCONTROL.PY:'''

 Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

 

<code></code>
<pre>#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek at skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo of an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#don't change this. if you need an offset, take care of it below
offset = 0

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offsetneeded = False

if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it (not the beginning). Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</pre>
 '''OTHER THINGS YOU MIGHT CARE TO KNOW IF YOU'VE MADE IT THIS FAR:'''

There are a couple of things in the script which you ought to know about if you do transcription regularly enough to care about these sorts of things.

 Within the script, you'll find settings for 'tempo' and 'offset'. Most people aren't going to need to worry about either of these and can just leave them as they sit. However, if you do alot of transcription, it's likely you'll find these to be of some value.

 The tempo setting does not refer to VLC's speed adjustment, rather it's is used if you have edited an audio file in an external editor, like audacity, and changed the tempo of the audio and created a new audio file based on that. The 'tempo' variable is a percentage of the original audio, so at full speed, you'll want 'tempo = 100'. If you slow it down 20%, you'll want 'tempo = 80', or 'tempo = 175' if you've sped it up 75%. By using this, you can get a timestamp for the spot in the full speed audio file, and won't need to go back through it later and correct your timestamps (it's always a good idea to do a couple of spot checks, just in case.) You DO NOT need to change this tempo variable if you are only adjusting the speed within VLC, it takes care of itself.

 The 'offset' section is useful if you are editing a video file which has an OSD timecode which you need to timestamp, rather than the playtime of the file. Again, this is not something you should need to mess with unless you have a specific use for it. If you do have a use for it, keep in mind that occasionally there will be edits that have been made to the video which will throw off your offest, so to speak. Unfortunately there's no real easy way to deal with this problem that I'm aware of, you simply have to keep an eye on the difference and adjust it as needed. Again, spot checks are always a good idea.

 In order to set the script up to properly offset your video, pick a spot somewhere in the video which is not at the beginning, and then enter in the appropriate values. For instance, if we have a video file which at 01:23:45 play time on the file has an OSD timecode of 12:34:56, you'll enter the values like this:

offsetneeded = True
vtch = 12 <--hours on the video timecode
vtcm = 34 <--minutes on the video timecode
vtcs = 56 <--seconds on the video timecode

atch = 1 <---don't use a leading 0, or the script will puke
atcm = 23 <--minutes on the playback time
atcs = 45 <--seconds on the playback time

 You can use offset with the tempo settings. Don't use the video timecode at 00:00:00 on the playback time, or the calculation will be off. Check the difference between the video timecode and the playback time at the beginning and end of your file to see if it's consistent, as that will tell you if there have been any edits made. If there are edits, just change the offset numbers when you get to those points.

 Finally, variable bit rates are a pain for transcription. You'll get files which simply won't behave in a useful manner when you try and jog backward, et cetera. You can try converting those files to ogg format, and that generally solves the problem.

 If you have any questions about this, I can be reached at derek at skyehaven.net.

[[Category:How_To]]

VLC HowTo

2010-10-06T11:04:17Z

Derek: /* Remote Control for VLC */

__NOTOC__
Below are some handy guides for using {{VLC}}

===Playing Video and Audio===
;How to...
* [[What can vlc do#How to enable/use subtitles|Use Subtitles]]
*: Playing movies with subtitles
* [[How to Use a Capture Card|Use a Capture Card]]
*: This explains how to watch TV or get video from your capture card.
* [[What can vlc do#Play DVD/SVCD/VCD iso's / Images|Play DVDs and Disks from the image file]]
*: This explains how to use movies encoded onto an ISO file.

===Adjusting Settings===
;How to...
* [[What can vlc do#How to adjust picture brightness/colors/contrast..|Adjust Picture Brightness and Contrast]]
* [[What can vlc do#How to control the aspect ratio of the video|Edit the Aspect Ratio of a video]]
* [[Crop|Crop video]]
* [[How_to_disable_acceleration_in_Win32|Disable video acceleration in Win32]]
* [[How_to_save_bookmarks | Save bookmarks]]
* [[How_to_play_multiple_instances_of_VLC | How to play multiple instances]]

===Remote Control for VLC===
;How to...
* [[Control VLC via a browser]]
*: This explains how to use the HTTP [[interface]]
* [[Control VLC via a widget]] on the Mac desktop
* [[Control VLC from an iPhone]]
* [[Control VLC from an Android Phone]]
* [[Control VLC from a Palm Web OS Phone]]
* [[How to Use Creative Remote]]
*: Explains how to control {{VLC}} with Creative brand remote controls

===Transcoding and Streaming===
;How to...
* [[iPod Video Conversion Guide|Play videos on your iPod]]
*: This explains how to convert your videos so they play on your iPod.
* [[Play_on_Yan Micro|Play videos on your Play-Yan Micro]]
*: This explains how to convert your videos so they play on your Play-Yan Micro.
* [[Play_on_Xbox|Play videos on your XBox and XBox 360 ]]
*: This explains how to convert your videos so they play on your XBox.
* [[Play_on_Zune| Play video on your Zune]]
*: This explains how to convert your videos so they play on your Zune.
* [[Fixing .flv to .avi with Ffmpeg]]
*: This explains how to use ffmpeg to a convert broken .flv files to a perfectly good .avi file '''DEPRECATED'''
* [[Transcode_WM_to_Mov_or_MP4|Convert Windows Media audio/video files to MOV or .MP4]]
*: This explains how to convert Windows Media-encoded files to Quicktime or MPEG-4 files
* [[Streaming_to_ActiveX_for_Windows_Media_Player | Streaming from a webcam to an ActiveX embedded object page]]
* [[How_to_add_logo | Add a logo on your videos]]
* [[Mosaic| Create a Mosaic]]
*: This explains how to set up a mosaic from a few streams like a TV portal.
* [[How to DBox|Set up Video on Demand on a Dreambox]]
* [[How to Batch Encode]]
*: This explains how to set up a batch transcode with all files in a directory of a certain file extension being transcoded to a specified format.
* [[How to merge and transcode multiple videos]]
*: This explains how to take several source videos and merge then transcode resulting in a single file output.

===Using VLC in other Applications===
;How to...
* [[ActiveX]]
*: Specification for ActiveX control
* [[LibVLC|Use VLC's External API]]
*: Information for using libvlc
* [[Use in Media Center]]
* [[Useful Firefox Extensions]]
*: Information about extensions to view embedded videos in web pages using VLC
* [[GWT]]
*: Google WebToolkit

===Other Stuff===
;How to...
* [[How to Create a DVD|Create a DVD]]
*: This explains how to make a DVD from your home videos
* [[ActiveX/Delphi|Use the ActiveX control with Borland's Delphi]]
*: Using the VLC ActiveX plug-in in your programs
* [[ActiveX/HTML|Use the ActiveX control within a webpage.]]
* [[HowTo_Integrate_VLC_plugin_in_your_webpage|Integrate ActiveX/Mozilla on your webpage]]
* [[Change the brightness or contrast of a video|Change a video]]
*: This explains how to edit a video and save the changes
* [[How to create thumbnails]]
* [[How to Use Lirc]]
* [[How to shut down computer]] when VLC playback is over...
* [[How to make VLC the default player]]
* [[How to use VLC for transcription in linux]]

== See also ==
* '''See also [[:Category:How To]]'''
[[Category:How To]]

VLC HowTo

2010-10-06T11:03:25Z

Derek: /* Remote Control for VLC */

__NOTOC__
Below are some handy guides for using {{VLC}}

===Playing Video and Audio===
;How to...
* [[What can vlc do#How to enable/use subtitles|Use Subtitles]]
*: Playing movies with subtitles
* [[How to Use a Capture Card|Use a Capture Card]]
*: This explains how to watch TV or get video from your capture card.
* [[What can vlc do#Play DVD/SVCD/VCD iso's / Images|Play DVDs and Disks from the image file]]
*: This explains how to use movies encoded onto an ISO file.

===Adjusting Settings===
;How to...
* [[What can vlc do#How to adjust picture brightness/colors/contrast..|Adjust Picture Brightness and Contrast]]
* [[What can vlc do#How to control the aspect ratio of the video|Edit the Aspect Ratio of a video]]
* [[Crop|Crop video]]
* [[How_to_disable_acceleration_in_Win32|Disable video acceleration in Win32]]
* [[How_to_save_bookmarks | Save bookmarks]]
* [[How_to_play_multiple_instances_of_VLC | How to play multiple instances]]

===Remote Control for VLC===
;How to...
* [[Control VLC via a browser]]
*: This explains how to use the HTTP [[interface]]
* [[Control VLC via a widget]] on the Mac desktop
* [[Control VLC from an iPhone]]
* [[Control VLC from an Android Phone]]
* [[Control VLC from a Palm Web OS Phone]]
* [[How to Use Creative Remote]]
*: Explains how to control {{VLC}} with Creative brand remote controls
* [[How to use VLC for transcription in linux]]
*: Explains how to set up control keys without focusing on VLC plus timestamping

===Transcoding and Streaming===
;How to...
* [[iPod Video Conversion Guide|Play videos on your iPod]]
*: This explains how to convert your videos so they play on your iPod.
* [[Play_on_Yan Micro|Play videos on your Play-Yan Micro]]
*: This explains how to convert your videos so they play on your Play-Yan Micro.
* [[Play_on_Xbox|Play videos on your XBox and XBox 360 ]]
*: This explains how to convert your videos so they play on your XBox.
* [[Play_on_Zune| Play video on your Zune]]
*: This explains how to convert your videos so they play on your Zune.
* [[Fixing .flv to .avi with Ffmpeg]]
*: This explains how to use ffmpeg to a convert broken .flv files to a perfectly good .avi file '''DEPRECATED'''
* [[Transcode_WM_to_Mov_or_MP4|Convert Windows Media audio/video files to MOV or .MP4]]
*: This explains how to convert Windows Media-encoded files to Quicktime or MPEG-4 files
* [[Streaming_to_ActiveX_for_Windows_Media_Player | Streaming from a webcam to an ActiveX embedded object page]]
* [[How_to_add_logo | Add a logo on your videos]]
* [[Mosaic| Create a Mosaic]]
*: This explains how to set up a mosaic from a few streams like a TV portal.
* [[How to DBox|Set up Video on Demand on a Dreambox]]
* [[How to Batch Encode]]
*: This explains how to set up a batch transcode with all files in a directory of a certain file extension being transcoded to a specified format.
* [[How to merge and transcode multiple videos]]
*: This explains how to take several source videos and merge then transcode resulting in a single file output.

===Using VLC in other Applications===
;How to...
* [[ActiveX]]
*: Specification for ActiveX control
* [[LibVLC|Use VLC's External API]]
*: Information for using libvlc
* [[Use in Media Center]]
* [[Useful Firefox Extensions]]
*: Information about extensions to view embedded videos in web pages using VLC
* [[GWT]]
*: Google WebToolkit

===Other Stuff===
;How to...
* [[How to Create a DVD|Create a DVD]]
*: This explains how to make a DVD from your home videos
* [[ActiveX/Delphi|Use the ActiveX control with Borland's Delphi]]
*: Using the VLC ActiveX plug-in in your programs
* [[ActiveX/HTML|Use the ActiveX control within a webpage.]]
* [[HowTo_Integrate_VLC_plugin_in_your_webpage|Integrate ActiveX/Mozilla on your webpage]]
* [[Change the brightness or contrast of a video|Change a video]]
*: This explains how to edit a video and save the changes
* [[How to create thumbnails]]
* [[How to Use Lirc]]
* [[How to shut down computer]] when VLC playback is over...
* [[How to make VLC the default player]]
* [[How to use VLC for transcription in linux]]

== See also ==
* '''See also [[:Category:How To]]'''
[[Category:How To]]

Linux

2010-10-06T10:59:22Z

Derek: /* Other info */

== Graphical User Interfaces under Linux ==

* The [[Skins|Skinnable Interface]]
* The [[Qt4 Interface]]
* The [[WxWidgets Interface]], ''deprecated''
* The [[Gnome Interface]], ''deprecated''
* The [[Kde Interface]], ''deprecated''
* Other [[interfaces]]

== Other info ==
* [[Linux keyboard shortcuts]]
* [[Linux VLC FAQ]]
* [[Alsa | Using ALSA]]
* [[How to use VLC for transcription in linux]]

==Command line==

* [[ZSH Autocompletion]]

==Distribution-specific stuff==

* [[GNU/Linux Debian]]
* [[Ubuntu|GNU/Linux Ubuntu]] and Ubuntu-based (Kubuntu, Edubuntu, Xubuntu, ...)
* [[RedHat|GNU/Linux RedHat]]
* [[Mandriva|GNU/Linux Mandriva (formerly Mandrake)]]
* [[Gentoo|GNU/Linux Gentoo]]
* [[SuSE|GNU/Linux SuSE]]
* [[Slackware|GNU/Linux Slackware]]
* Other [[distros |GNU/Linux distros]]

==General Linux Advice==
* [http://www.tldp.org/HOWTO/Keyboard-and-Console-HOWTO-8.html Getting out of freezes]

[[Category:Operating systems]]

VLC HowTo/Use for transcription (Linux)

2010-10-06T10:52:47Z

Derek:

'''OVERVIEW:'''

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

 There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.  This script was written for linux, but might have some useful information for anyone trying to do this on other platforms. 

 '''PREREQUISITES:'''

First, you need to have [http://www.videolan.org/vlc/ VLC] (obviously), [http://www.python.org/ python] 2 OR 3, [http://hoopajoo.net/projects/xautomation.html xautomation] OR a version of [http://www.semicomplete.com/projects/xdotool/ xdotool] (newer than august 2010), and you need the openbsd implementation of [http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/nc/ netcat].

 The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need. Unfortunately, the GNU implementation of netcat, which is the default in most distributions, does not seem to support UNIX sockets (the -U switch for nc.openbsd). 

 xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

 '''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

 To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

 You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

 Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

 Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

 I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

 If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

 If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

 In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:

<code></code>
<pre> keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</pre>
 

'''VLCCONTROL.PY:'''

 Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

 

<code></code>
<pre>#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek at skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo of an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#don't change this. if you need an offset, take care of it below
offset = 0

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offsetneeded = False

if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it (not the beginning). Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</pre>
 '''OTHER THINGS YOU MIGHT CARE TO KNOW IF YOU'VE MADE IT THIS FAR:'''

There are a couple of things in the script which you ought to know about if you do transcription regularly enough to care about these sorts of things.

 Within the script, you'll find settings for 'tempo' and 'offset'. Most people aren't going to need to worry about either of these and can just leave them as they sit. However, if you do alot of transcription, it's likely you'll find these to be of some value.

 The tempo setting does not refer to VLC's speed adjustment, rather it's is used if you have edited an audio file in an external editor, like audacity, and changed the tempo of the audio and created a new audio file based on that. The 'tempo' variable is a percentage of the original audio, so at full speed, you'll want 'tempo = 100'. If you slow it down 20%, you'll want 'tempo = 80', or 'tempo = 175' if you've sped it up 75%. By using this, you can get a timestamp for the spot in the full speed audio file, and won't need to go back through it later and correct your timestamps (it's always a good idea to do a couple of spot checks, just in case.) You DO NOT need to change this tempo variable if you are only adjusting the speed within VLC, it takes care of itself.

 The 'offset' section is useful if you are editing a video file which has an OSD timecode which you need to timestamp, rather than the playtime of the file. Again, this is not something you should need to mess with unless you have a specific use for it. If you do have a use for it, keep in mind that occasionally there will be edits that have been made to the video which will throw off your offest, so to speak. Unfortunately there's no real easy way to deal with this problem that I'm aware of, you simply have to keep an eye on the difference and adjust it as needed. Again, spot checks are always a good idea.

 In order to set the script up to properly offset your video, pick a spot somewhere in the video which is not at the beginning, and then enter in the appropriate values. For instance, if we have a video file which at 01:23:45 play time on the file has an OSD timecode of 12:34:56, you'll enter the values like this:

offsetneeded = True
vtch = 12 <--hours on the video timecode
vtcm = 34 <--minutes on the video timecode
vtcs = 56 <--seconds on the video timecode

atch = 1 <---don't use a leading 0, or the script will puke
atcm = 23 <--minutes on the playback time
atcs = 45 <--seconds on the playback time

 You can use offset with the tempo settings. Don't use the video timecode at 00:00:00 on the playback time, or the calculation will be off. Check the difference between the video timecode and the playback time at the beginning and end of your file to see if it's consistent, as that will tell you if there have been any edits made. If there are edits, just change the offset numbers when you get to those points.

 Finally, variable bit rates are a pain for transcription. You'll get files which simply won't behave in a useful manner when you try and jog backward, et cetera. You can try converting those files to ogg format, and that generally solves the problem.

 If you have any questions about this, I can be reached at derek at skyehaven.net.

[[Category:How_To]]

VLC HowTo/Use for transcription (Linux)

2010-10-06T10:51:19Z

Derek: links added

'''OVERVIEW:'''

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

 There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.  This script was written for linux, but might have some useful information for anyone trying to do this on other platforms. 

 '''PREREQUISITES:'''

First, you need to have [http://www.videolan.org/vlc/ VLC] (obviously), [http://www.python.org/ python] 2 OR 3, [http://hoopajoo.net/projects/xautomation.html xautomation] OR a version of [http://www.semicomplete.com/projects/xdotool/ xdotool] (newer than august 2010), and you need the openbsd implementation of [http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/nc/ netcat].

 The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need. Unfortunately, the GNU implementation of netcat, which is the default in most distributions, does not seem to support UNIX sockets (the -U switch for nc.openbsd). 

 xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

 '''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

 To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

 You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

 Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

 Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

 I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

 If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

 If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

 In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:

<code></code>
<pre> keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</pre>
 

'''VLCCONTROL.PY:'''

 Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

 

<code></code>
<pre>#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek at skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#don't change this. if you need an offset, take care of it below
offset = 0

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offsetneeded = False

if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it (not the beginning). Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</pre>
 '''OTHER THINGS YOU MIGHT CARE TO KNOW IF YOU'VE MADE IT THIS FAR:'''

There are a couple of things in the script which you ought to know about if you do transcription regularly enough to care about these sorts of things.

 Within the script, you'll find settings for 'tempo' and 'offset'. Most people aren't going to need to worry about either of these and can just leave them as they sit. However, if you do alot of transcription, it's likely you'll find these to be of some value.

 The tempo setting does not refer to VLC's speed adjustment, rather it's is used if you have edited an audio file in an external editor, like audacity, and changed the tempo of the audio and created a new audio file based on that. The 'tempo' variable is a percentage of the original audio, so at full speed, you'll want 'tempo = 100'. If you slow it down 20%, you'll want 'tempo = 80', or 'tempo = 175' if you've sped it up 75%. By using this, you can get a timestamp for the spot in the full speed audio file, and won't need to go back through it later and correct your timestamps (it's always a good idea to do a couple of spot checks, just in case.) You DO NOT need to change this tempo variable if you are only adjusting the speed within VLC, it takes care of itself.

 The 'offset' section is useful if you are editing a video file which has an OSD timecode which you need to timestamp, rather than the playtime of the file. Again, this is not something you should need to mess with unless you have a specific use for it. If you do have a use for it, keep in mind that occasionally there will be edits that have been made to the video which will throw off your offest, so to speak. Unfortunately there's no real easy way to deal with this problem that I'm aware of, you simply have to keep an eye on the difference and adjust it as needed. Again, spot checks are always a good idea.

 In order to set the script up to properly offset your video, pick a spot somewhere in the video which is not at the beginning, and then enter in the appropriate values. For instance, if we have a video file which at 01:23:45 play time on the file has an OSD timecode of 12:34:56, you'll enter the values like this:

offsetneeded = True
vtch = 12 <--hours on the video timecode
vtcm = 34 <--minutes on the video timecode
vtcs = 56 <--seconds on the video timecode

atch = 1 <---don't use a leading 0, or the script will puke
atcm = 23 <--minutes on the playback time
atcs = 45 <--seconds on the playback time

 You can use offset with the tempo settings. Don't use the video timecode at 00:00:00 on the playback time, or the calculation will be off. Check the difference between the video timecode and the playback time at the beginning and end of your file to see if it's consistent, as that will tell you if there have been any edits made. If there are edits, just change the offset numbers when you get to those points.

 Finally, variable bit rates are a pain for transcription. You'll get files which simply won't behave in a useful manner when you try and jog backward, et cetera. You can try converting those files to ogg format, and that generally solves the problem.

 If you have any questions about this, I can be reached at derek at skyehaven.net.

[[Category:How_To]]

VLC HowTo/Use for transcription (Linux)

2010-10-06T10:23:43Z

Derek: added category tag

'''OVERVIEW:'''

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

'''PREREQUISITES:'''

First, you need to have VLC (obviously), python 2 OR 3, xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

'''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:
<code><pre><nowiki>
keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</nowiki></pre></code>

'''VLCCONTROL.PY:'''

Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek at skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#don't change this. if you need an offset, take care of it below
offset = 0

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offsetneeded = False

if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it (not the beginning). Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

'''OTHER THINGS YOU MIGHT CARE TO KNOW IF YOU'VE MADE IT THIS FAR:'''

There are a couple of things in the script which you ought to know about if you do transcription regularly enough to care about these sorts of things.

Within the script, you'll find settings for 'tempo' and 'offset'. Most people aren't going to need to worry about either of these and can just leave them as they sit. However, if you do alot of transcription, it's likely you'll find these to be of some value.

The tempo setting does not refer to VLC's speed adjustment, rather it's is used if you have edited an audio file in an external editor, like audacity, and changed the tempo of the audio and created a new audio file based on that. The 'tempo' variable is a percentage of the original audio, so at full speed, you'll want 'tempo = 100'. If you slow it down 20%, you'll want 'tempo = 80', or 'tempo = 175' if you've sped it up 75%. By using this, you can get a timestamp for the spot in the full speed audio file, and won't need to go back through it later and correct your timestamps (it's always a good idea to do a couple of spot checks, just in case.) You DO NOT need to change this tempo variable if you are only adjusting the speed within VLC, it takes care of itself.

The 'offset' section is useful if you are editing a video file which has an OSD timecode which you need to timestamp, rather than the playtime of the file. Again, this is not something you should need to mess with unless you have a specific use for it. If you do have a use for it, keep in mind that occasionally there will be edits that have been made to the video which will throw off your offest, so to speak. Unfortunately there's no real easy way to deal with this problem that I'm aware of, you simply have to keep an eye on the difference and adjust it as needed. Again, spot checks are always a good idea.

In order to set the script up to properly offset your video, pick a spot somewhere in the video which is not at the beginning, and then enter in the appropriate values. For instance, if we have a video file which at 01:23:45 play time on the file has an OSD timecode of 12:34:56, you'll enter the values like this:

offsetneeded = True
vtch = 12 <--hours on the video timecode
vtcm = 34 <--minutes on the video timecode
vtcs = 56 <--seconds on the video timecode

atch = 1 <---don't use a leading 0, or the script will puke
atcm = 23 <--minutes on the playback time
atcs = 45 <--seconds on the playback time

You can use offset with the tempo settings. Don't use the video timecode at 00:00:00 on the playback time, or the calculation will be off. Check the difference between the video timecode and the playback time at the beginning and end of your file to see if it's consistent, as that will tell you if there have been any edits made. If there are edits, just change the offset numbers when you get to those points.

Finally, variable bit rates are a pain for transcription. You'll get files which simply won't behave in a useful manner when you try and jog backward, et cetera. You can try converting those files to ogg format, and that generally solves the problem.

If you have any questions about this, I can be reached at derek at skyehaven.net.

[[Category:How_To]]

VLC HowTo/Use for transcription (Linux)

2010-10-06T09:38:54Z

Derek: added mention of python in prerequisites

VLC HowTo/Use for transcription (Linux)

2010-10-06T09:15:31Z

Derek: minor formatting

'''OVERVIEW:'''

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

'''PREREQUISITES:'''

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

'''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:
<code><pre><nowiki>
keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</nowiki></pre></code>

'''VLCCONTROL.PY:'''

Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek at skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#don't change this. if you need an offset, take care of it below
offset = 0

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offsetneeded = False

if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it (not the beginning). Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

'''OTHER THINGS YOU MIGHT CARE TO KNOW IF YOU'VE MADE IT THIS FAR:'''

There are a couple of things in the script which you ought to know about if you do transcription regularly enough to care about these sorts of things.

Within the script, you'll find settings for 'tempo' and 'offset'. Most people aren't going to need to worry about either of these and can just leave them as they sit. However, if you do alot of transcription, it's likely you'll find these to be of some value.

The tempo setting does not refer to VLC's speed adjustment, rather it's is used if you have edited an audio file in an external editor, like audacity, and changed the tempo of the audio and created a new audio file based on that. The 'tempo' variable is a percentage of the original audio, so at full speed, you'll want 'tempo = 100'. If you slow it down 20%, you'll want 'tempo = 80', or 'tempo = 175' if you've sped it up 75%. By using this, you can get a timestamp for the spot in the full speed audio file, and won't need to go back through it later and correct your timestamps (it's always a good idea to do a couple of spot checks, just in case.) You DO NOT need to change this tempo variable if you are only adjusting the speed within VLC, it takes care of itself.

The 'offset' section is useful if you are editing a video file which has an OSD timecode which you need to timestamp, rather than the playtime of the file. Again, this is not something you should need to mess with unless you have a specific use for it. If you do have a use for it, keep in mind that occasionally there will be edits that have been made to the video which will throw off your offest, so to speak. Unfortunately there's no real easy way to deal with this problem that I'm aware of, you simply have to keep an eye on the difference and adjust it as needed. Again, spot checks are always a good idea.

In order to set the script up to properly offset your video, pick a spot somewhere in the video which is not at the beginning, and then enter in the appropriate values. For instance, if we have a video file which at 01:23:45 play time on the file has an OSD timecode of 12:34:56, you'll enter the values like this:

offsetneeded = True
vtch = 12 <--hours on the video timecode
vtcm = 34 <--minutes on the video timecode
vtcs = 56 <--seconds on the video timecode

atch = 1 <---don't use a leading 0, or the script will puke
atcm = 23 <--minutes on the playback time
atcs = 45 <--seconds on the playback time

You can use offset with the tempo settings. Don't use the video timecode at 00:00:00 on the playback time, or the calculation will be off. Check the difference between the video timecode and the playback time at the beginning and end of your file to see if it's consistent, as that will tell you if there have been any edits made. If there are edits, just change the offset numbers when you get to those points.

Finally, variable bit rates are a pain for transcription. You'll get files which simply won't behave in a useful manner when you try and jog backward, et cetera. You can try converting those files to ogg format, and that generally solves the problem.

If you have any questions about this, I can be reached at derek at skyehaven.net.

VLC HowTo/Use for transcription (Linux)

2010-10-06T09:11:26Z

Derek: added notes about tempo and offset settings in the script

'''OVERVIEW:'''

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

'''PREREQUISITES:'''

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

'''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:
<code><pre><nowiki>
keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</nowiki></pre></code>

'''VLCCONTROL.PY:'''

Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek at skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#don't change this. if you need an offset, take care of it below
offset = 0

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offsetneeded = False

if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it (not the beginning). Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

'''OTHER THINGS YOU MIGHT CARE TO KNOW IF YOU'VE MADE IT THIS FAR:'''

There are a couple of things in the script which you ought to know about if you do transcription regularly enough to care about these sorts of things.

Within the script, you'll find settings for 'tempo' and 'offset'. Most people aren't going to need to worry about either of these and can just leave them as they sit. However, if you do alot of transcription, it's likely you'll find these to be of some value.

The tempo setting does not refer to VLC's speed adjustment, rather it's is used if you have edited an audio file in an external editor, like audacity, and changed the tempo of the audio and created a new audio file based on that. The 'tempo' variable is a percentage of the original audio, so at full speed, you'll want 'tempo = 100'. If you slow it down 20%, you'll want 'tempo = 80', or 'tempo = 175' if you've sped it up 75%. By using this, you can get a timestamp for the spot in the full speed audio file, and won't need to go back through it later and correct your timestamps (it's always a good idea to do a couple of spot checks, just in case.) You DO NOT need to change this tempo variable if you are only adjusting the speed within VLC, it takes care of itself.

The 'offset' section is useful if you are editing a video file which has an OSD timecode which you need to timestamp, rather than the playtime of the file. Again, this is not something you should need to mess with unless you have a specific use for it. If you do have a use for it, keep in mind that occasionally there will be edits that have been made to the video which will throw off your offest, so to speak. Unfortunately there's no real easy way to deal with this problem that I'm aware of, you simply have to keep an eye on the difference and adjust it as needed. Again, spot checks are always a good idea.

In order to set the script up to properly offset your video, pick a spot somewhere in the video which is not at the beginning, and then enter in the appropriate values. For instance, if we have a video file which at 01:23:45 play time on the file has an OSD timecode of 12:34:56, you'll enter the values like this:

offsetneeded = True
vtch = 12 <--hours on the video timecode
vtcm = 34 <--minutes on the video timecode
vtcs = 56 <--seconds on the video timecode

atch = 1 <---don't use a leading 0, or the script will puke
atcm = 23 <--minutes on the playback time
atcs = 45 <--seconds on the playback time

You can use offset with the tempo settings. Don't use the video timecode at 00:00:00 on the playback time, or the calculation will be off. Check the difference between the video timecode and the playback time at the beginning and end of your file to see if it's consistent, as that will tell you if there have been any edits made. If there are edits, just change the offset numbers when you get to those points.

Finally, variable bit rates are a pain for transcription. You'll get files which simply won't behave in a useful manner when you try and jog backward, et cetera. You can try converting those files to ogg format, and that generally solves the problem.

If you have any questions about this, I can be reached at derek at skyehaven.net.

VLC HowTo/Use for transcription (Linux)

2010-10-06T08:35:59Z

Derek: minor clarifications

'''OVERVIEW:'''

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

'''PREREQUISITES:'''

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

'''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:
<code><pre><nowiki>
keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</nowiki></pre></code>

'''VLCCONTROL.PY:'''

Finally, here is the vlccontrol.py script. Copy the script below and paste it into a file named 'vlccontrol.py'. Save it to your home directory and make it executable with the command 'chmod 700 vlccontrol.py'

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

VLC HowTo/Use for transcription (Linux)

2010-10-06T08:32:48Z

Derek: minor formatting

'''OVERVIEW:'''

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

'''PREREQUISITES:'''

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

'''SETUP:'''

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

I set my control keys up like this:

F1 = ~/vlccontrol.py jogbackward

F2 = ~/vlccontrol.py pause

F3 = ~/vlccontrol.py pause (no need for two, just habit)

F4 = ~/vlccontrol.py jogforward

F5 = ~/vlccontrol.py timestamp

Shift+F1 = ~/vlccontrol.py slower

Shift+F3 = ~/vlccontrol.py normal

Shift+F4 = ~/vlccontrol.py faster

If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:
<code><pre><nowiki>
keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</nowiki></pre></code>

'''VLCCONTROL.PY:'''

Finally, here is the vlccontrol.py script. Save it to your home directory and make it executable with 'chmod 700 vlccontrol.py'

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

VLC HowTo/Use for transcription (Linux)

2010-10-06T08:24:24Z

Derek: added information about configuring various window managers

OVERVIEW:

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

PREREQUISITES:

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

SETUP:

This setup is window manager agnostic. It shouldn't make much difference which environment you run it in, the only practical difference will be in how you set up your control keys. I won't go over how to set up window environment here, but I will try to give you a few pointers below.

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your control keys for your window environment. Remember to check to make sure that whichever control keys you wish to use are not already used by your window manager. Redefine these control keys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC but, personally, I like having these commands in the script. You may have better results with some experimentation.

I set my control up like this:
F1 = ~/vlccontrol.py jogbackward
F2 = ~/vlccontrol.py pause
F3 = ~/vlccontrol.py pause (no need for two, just habit)
F4 = ~/vlccontrol.py jogforward
F5 = ~/vlccontrol.py timestamp
Shift+F1 = ~/vlccontrol.py slower
Shift+F3 = ~/vlccontrol.py normal
Shift+F4 = ~/vlccontrol.py faster

If you use gnome+metacity, you can edit your keybindings in gconf-editor. Go to apps->metacity->global_keybindings and assign a command number to control key you want. Then go to app->metacity->keybinding_commands and assign the appropriate commands to the command numbers. So, for my keybindings, in 'global_keybindings' you would set run_command_1 to F1. Then go to 'keybinding_commands' and set command_1 to /home/YOURNAME/vlccontrol.py jogbackward.

If you use kde4, open system settings, click on 'Shortcuts and Gestures', then choose 'Custom Shortcuts'. In the second pane, under name, choose an appropriate group to put your new bindings (it might be a good idea to create a new group for these under 'Preset Actions', choose 'New Group' from the 'Edit' menu below the second pane.) Click on 'Edit', go to New->Global Shortcut->Command/URL, and name the action. While the new action is selected, click the 'Trigger' tab in the right hand pane, click shortcut box and hit the key you wish to bind to the action (F1). Then go to action and enter in the command for that action (/home/YOURNAME/vlccontrol.py jogbackward.)

In any window manager which utilizes an rc.xml file for it's keybindings, like OpenBox, edit the rc.xml in a text editor and go down to the 'keybindings' section. Just follow along with the other keybind examples in the file, it's fairly straightfoward, but your first entry should look something like this, although you will need to put in appropriate symbols around the keywords:
<code><pre><nowiki>
keybind key="F1"
action name="execute"
execute /home/delwin/vlccontrol.py jogbackward /execute
/action
/keybind
</nowiki></pre></code>

Finally, here is the vlccontrol.py script. Save it to your home directory and make it executable with 'chmod 700 vlccontrol.py'

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

VLC HowTo/Use for transcription (Linux)

2010-10-06T07:48:53Z

Derek: more formatting issues

OVERVIEW:

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

PREREQUISITES:

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

SETUP:

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your hotkeys for your window environment. This should work equally well in any window manger, so pick whichever you like. Remember to check to make sure that whichever hotkeys you wish to use are not already used by your windowmanager. Redefine these hotkeys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC, but I personally like having these commands in the script, anyway. You may have better results with some experimentation.

<code><pre><nowiki>
#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####

##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')

#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])

#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
#have vlc post the time ~/vlc.out
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)

#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)

#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100

#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:

#If an offset is needed:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc

#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60

#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)

#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "

#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

VLC HowTo/Use for transcription (Linux)

2010-10-06T07:42:05Z

Derek: still trying to format this code properly

{{Howto}}

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

PREREQUISITES:

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

SETUP:

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your hotkeys for your window environment. This should work equally well in any window manger, so pick whichever you like. Remember to check to make sure that whichever hotkeys you wish to use are not already used by your windowmanager. Redefine these hotkeys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC, but I personally like having these commands in the script, anyway. You may have better results with some experimentation.

<code><pre><nowiki>
#!/usr/bin/env python

#### licensing nonsense - short version: New BSD License

#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net

#All rights reserved.

#Redistribution and use in source and binary forms, with or

#without modification, are permitted provided that the following

#conditions are met:

#
# * Redistributions of source code must retain the above

#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####
##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')
#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])
#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)
#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)
#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100
#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc
#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60
#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)
#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "
#xdotool requires a version later created than august 2010
#
#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</nowiki></pre></code>

VLC HowTo/Use for transcription (Linux)

2010-10-06T07:40:03Z

Derek:

{{Howto}}

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

PREREQUISITES:

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

SETUP:

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your hotkeys for your window environment. This should work equally well in any window manger, so pick whichever you like. Remember to check to make sure that whichever hotkeys you wish to use are not already used by your windowmanager. Redefine these hotkeys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC, but I personally like having these commands in the script, anyway. You may have better results with some experimentation.

<nowiki>
<code><pre>
#!/usr/bin/env python

#### licensing nonsense - short version: New BSD License

#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net

#All rights reserved.

#Redistribution and use in source and binary forms, with or

#without modification, are permitted provided that the following

#conditions are met:

#
# * Redistributions of source code must retain the above

#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####
##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')
#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])
#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)
#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)
#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100
#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc
#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60
#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)
#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "
#xdotool requires a version later created than august 2010
#
#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)
</pre></code>
</nowiki>

VLC HowTo/Use for transcription (Linux)

2010-10-06T06:49:04Z

Derek: Instructions and a script useful for doing transcription in linux

{{Howto}}

VLC makes a good option for people trying to do transcription of audio or video in linux. The script below might be usable in other operating systems, but will likely take some adjusting.

The purpose of this howto is to show you how to configure vlc and use the script below to enable you to control vlc with scripted commands and, most importantly, take a timestamp from vlc and automatically type it into whatever document you are working on, without ever needing to shift focus away from the document.

There are other ways to achieve what I've done with this, many of them likely better than what is here. But this works, and works well.

PREREQUISITES:

First, you need to have VLC (obviously), xautomation OR a version of xdotool (newer than august 2010), and you need the openbsd implementation of netcat.

The openbsd version of netcat is in the repositories of most major linux distirbutions these days. This script is written for use in Archlinux, so it's likely that you will need to change the command used by netcat in the script. Arch uses nc.openbsd, just replace it with whatever you need.

xautomation will almost certainly be in your repos, and xdotool might be. xautomation seems to be the better choice if you're only concerned about how quickly it does the job, but xdotool is nice as well if you're doing fancier things with it. However, if you do choose to try xdotool, you'll need a build done later than August 2010, as some of the features used in this script are not in the older versions available in most repositories.

SETUP:

To set up vlc to use this script, go to tools->preferences and click on "show settings->all" at the bottom. From that menu, select "Interface->Main Interfaces", and check the "Remote Control
Interface" box. Next, select "Interface->Main Interfaces->RC", check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in the "UNIX socket command input" field.

You probably also want to adjust the "Very short jump length" located in "Interface->Hotkeys settings". This script assumes that it is set for 5 seconds rather than the default of 3 seconds. It won't affect the script if you don't change this value, as it uses the 'very short jump' command rather than jogging a specific number of seconds. If you poke around the vlc docs, you'll see a seek command, but that is to go to a certain point in a file rather than going forward or backward a certain number of seconds.

Hit "Save". Restart VLC, and check to see if it creates "vlc.sock" in your home directory. This should be created automatically when vlc starts. If it doesn't, check your socket path and try again.

Next, you need to set up your hotkeys for your window environment. This should work equally well in any window manger, so pick whichever you like. Remember to check to make sure that whichever hotkeys you wish to use are not already used by your windowmanager. Redefine these hotkeys or the defaults as necessary. I didn't have any luck with the global hotkeys settings within VLC, but I personally like having these commands in the script, anyway. You may have better results with some experimentation.

THE vlccontrol.py SCRIPT:

#!/usr/bin/env python
#### licensing nonsense - short version: New BSD License
#Copyright (c) 2010, Derek Barnett, Skyehaven Transcription
#Contact: derek@skyehaven.net
#All rights reserved.
#Redistribution and use in source and binary forms, with or
#without modification, are permitted provided that the following
#conditions are met:
#
# * Redistributions of source code must retain the above
#copyright notice, this list of conditions and the following
#disclaimer.
# * Redistributions in binary form must reproduce the above
#copyright notice, this list of conditions and the following
#disclaimer in the documentation and/or other materials provided
#with the distribution.
# * Neither the name of the Skyehaven Transcription nor the
#names of its contributors may be used to endorse or promote
#products derived from this software without specific prior
#written permission.
#
#THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
#CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
#INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
#DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
#CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
#LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
#USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
#AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
#LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
#IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
#THE POSSIBILITY OF SUCH DAMAGE.
#####
##### useful notes
#vlc control script, compatible with python 2 or 3
#
#this script requires the openbsd version of netcat. gnu's version
#does not appear to support unix sockets as of this time. it will
#almost certainly be in the repos of your distribution. you may need
#to adjust this script to change the name of the binary to whatever
#format your distribution uses (change 'nc.openbsd' below to whatever
#you need.)
#
#it also requires either xautomation (for it's xte tool) or xdotool
#xautomation is used by default, as it's currently a bit faster
#if you use xdotool, ensure that it's a version later than aug 2010
#
#to set up vlc to use this script, go to tools->preferences and
#click on "show settings->all" at the bottom. from that menu,
#select "Interface->Main Interfaces", and check the "Remote Control
#Interface" box. Next, select "Interface->Main Interfaces->RC",
#check the "Fake TTY' box, and enter 'home/YOURNAME/vlc.sock'in
#the "UNIX socket command input" field.
#
#You probably also want to adjust the "Very short jump length" located
#in "Interface->Hotkeys settings". This script assumes that it is set
#for 5 seconds rather than the default of 3 seconds. It won't affect the
#script if you don't change this value, as it uses the 'very short jump'
#command rather than jogging a specific number of seconds. If you poke
#around the vlc docs, you'll see a seek command, but that is to go to a
#certain point in a file rather than going forward or backward a certain
#number of seconds.
#
#Hit "Save". Restart VLC, and check to see if it creates "vlc.sock"
#in your home directory. This should be created automatically when vlc
#starts. If it doesn't, check your socket path and try again.
#
#Next, you need to set up your hotkeys for your window environment.
#This should work equally well in any window manger, so pick whichever
#you like. Remember to check to make sure that whichever hotkeys you wish
#to use are not already used by your windowmanager. Redefine these
#hotkeys or the defaults as necessary.
#
#note: vlc supposedly support global hotkeys, but I didn't have any luck
#with them, which is why i went this route with the control script. Your
#mileage may vary.
#
#I personally set it up like this:
#F1 = ~/vlccontrol.py jogbackward
#F2 = ~/vlccontrol.py pause (no need to have this twice, just habit)
#F3 = ~/vlccontrol.py pause
#F4 = ~/vlccontrol.py jogforward
#F5 = ~/vlccontrol.py timestamp
#Shift+F1 = ~/vlccontrol.py slower
#Shift+F3 = ~/vlccontrol.py normal
#Shift+F4 = ~/vlccontrol.py faster
##### end of rambling, on to business

import sys
import os

#feed command to vlc socket to get the time played in seconds
workingdir = os.path.join(os.path.expanduser('~'))
vlcin = os.path.join(workingdir,'vlc.sock')
vlcout = os.path.join(workingdir,'vlc.out')
#accept argument when running script, e.g. './vlctimestamp.py timestamp'
args = sys.argv[1:]
i = "normal"
if args:
i = str.lower(args[0])
#acceptable arguments: help, --help, pause, jogforward, +5, jogbackward, -5,
#faster, slower, normal, timestamp. no argument assumes 'normal'
if i == "help" or i == "-help" or i == "--help":
print("""
'help' or '--help' returns this help
'pause' is a play/pause toggle
'jogforward' or '+5' jumps forward 5 seconds
'jogbackward' or '-5' jumps backward 5 seconds
'faster' increases the tempo without increasing pitch
'slower' decreases the tempo without decreasing pitch
no argument or 'normal' returns vlc to normal speed
'timestamp' types a hh:mm:ss coded timestamp into
active window. see comments within this
script if you need to change the timestamp
string, offset the timestamp for a video
timecode, or if you've made tempo changes
in an audio file outside of vlc
""")

elif i == "jogforward" or i == "+5":
os.system('echo "key key-jump+extrashort" | nc.openbsd -U ' + vlcin)

elif i == "jogbackward" or i == "-5":
os.system('echo "key key-jump-extrashort" | nc.openbsd -U ' + vlcin)

elif i == "pause":
os.system('echo "pause" | nc.openbsd -U ' + vlcin)

elif i == "faster":
os.system('echo "key key-rate-faster-fine" | nc.openbsd -U ' + vlcin)

elif i == "slower":
os.system('echo "key key-rate-slower-fine" | nc.openbsd -U ' + vlcin)

elif i == "normal":
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

elif i == "timestamp":
os.system('echo "get_time" | nc.openbsd -U ' + vlcin + ' > ' + vlcout)
#read vlc.out and report time played in seconds
f = open(vlcout, 'r')
f_list = f.read().split("\n")
if len(f_list) > 2:
sec = f_list[1]
else:
sec = f_list[0]
sec = int(sec)
#tempo - if you've adjusted the tempo and an audio file, in
# audacity for instance, then you can use the tempo
# variable to give output for a timestamp postion in
# original file. tempo is the percent playback speed
# of the modified file. 80 = -20% tempo change, etc.
# default is 100
tempo = 100
#change offsetneeded to True if, for instance, you need to
#use a timecode embedded into a video rather than the playtime
#of the file
offset = 0
offsetneeded = False
if offsetneeded == True:
#Pick a spot on the video and pause it. Enter the appropriate values below:
#vtch = hours on video time code, vtcm = minutes, vtcs = seconds
vtch = 0
vtcm = 0
vtcs = 0
vtc = (vtch * 3600) + (vtcm * 60) + vtcs
#atch = hours in actual playtime, atcm = minutes,
#atcs = seconds
atch = 0
atcm = 0
atcs = 0
atc = ((((atch * 3600) + (atcm * 60) + atcs) * tempo) / 100)
offset = vtc - atc
#get the values for hh:mm:ss formatting
sec = ((sec * tempo) / 100) + offset
th = sec/3600
tm = (sec % 3600)/60
ts = sec % 60
#format the timestamp, default looks like '##Inaudible 00:01:10## '
#the timestamp in hours:minutes:seconds
t = "%02d:%02d:%02d" % (th,tm,ts)
#string to append before timestamp
#for no prefix, set prefix = ""
prefix = "##Inaudible "
#string to append after timestamp
#for no suffix, set suffix = ""
suffix = "## "
#xdotool requires a version later created than august 2010
#
#xdotool command to execute, uncomment next line to use xdotool
#dropstamp = str("xdotool type --delay 0 --clearmodifiers '" + prefix + t + suffix + "'")
#
#drop the timestamp string into active window, uncomment next line to use xdotool
#os.system(dropstamp)
#
#use xte from the xautomation package if you don't have a version of
#xdotool newer than august 2010
os.system('xte "str ' + prefix + t + suffix + '"')

#if we don't feed an argument to the script, normalize the play speed of vlc
else:
os.system('echo "normal" | nc.openbsd -U ' + vlcin)

VLC HowTo

2010-10-06T06:23:48Z

Derek: /* Other Stuff */