/transcriba

Pedal for Audio Transcription using VLC

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

Transcriba 0.4

Integrates VLC media player with an arduino-based USB pedal for audio transcription.

This script is based on Jeffrey Ness' raw keyboad access code. It was inspired and re-written from 'vlccontrol' by Derek Barnett. It uses Al's Pyperclip for the usage of the clipboard function on Mac, Windoze, and Linux.

Tested with the PRO MICRO Leonardo-compatible board. Here is the pinout: (it works with other Leonardo-compatible boards, Teensy, etc.)

Pin     Key Assignment            Function
------------------------------------------------
D02     KEY_LEFTCTRL + KEY_F7     Pause/Play 
D03     KEY_LEFTCTRL + KEY_F8     Get Timecode
D04     KEY_LEFTCTRL + KEY_F9     Jump Forward 
D05     KEY_LEFTCTRL + KEY_F10    Jump Backward
D06     KEY_LEFTCTRL + KEY_F11    Speed-Up  
D07     KEY_LEFTCTRL + KEY_F12    Slow-Down

Getting Started

You need to configure VLC before using the script:

  • Open VLC: preferences: advanced preferences and configure its interface to use 'RC', check the option 'fake tty' and 'UNIX socket command input' to the path of the script;

  • Open 'keyboard.map' for a list of keycodes. Edit transcriba.py and change the keycodes according to your environment;

  • Plug your USB pedal and launch the script.

Assembly Instructions

The prototype was based on a L-shaped aluminum bar (which can be found in any hardware store), a collection of buttons, wires, and an ATmega32U4 MCU (which can be found in many projects, most notably on the Arduino Leonardo):

Pedal Transcriba prototype

TODO: describe the assembly process w/ the PCB, as soon as it is ready!

Licensing

Each dependency has specific licensing requirements. Check their respective files for further information. This script is distributed under the GPL version 2. For further information, read 'LICENSE'.

Enjoy Transcribing! (just kidding...)