Development Environment

From SIMON

Jump to: navigation, search

Languages: Deutsch | English | Esperanto | Español | Italiano |

If you finish this tutorial, you will get a fully functional simon version and the coresponding source files which you of course can modify freely.

To publish your changes, please get in touch with a simon developer to receive write access to the public git repository.

Contents

[edit]

Windows

The following tutorial will describe how to install everything needed to get started on developing on simon.

[edit]

KDE

  1. Please download the newest KDE-on-Windows-installer from windows.kde.org. You need the file kdewin-installer-gui-latest.exe.
  2. Please install the downloaded executable 'kdewin-installer-gui-latest.exe'.
  3. You may get a security warning: "The publisher could not be verified. Are you sure you want to run the software?" Please press the 'Run' button.
  4. You are being guided through the KDE for Windows installer. Press the 'Next >' button.
  5. Please select the directory where you want to install KDE applications. This guide will assume it is 'C:\KDE'. Press the 'Next >' button.
  6. Please choose as 'Install Mode' the option 'Package Manager'. The compiler mode has to be 'MinGW4'. Press the 'Next >' button.
  7. Please select the directory where the packages are stored for the installation. Press the 'Next >' button.
  8. Choose the option 'I have a direct connection to the Internet'. Press the 'Next >' button.
  9. Now select the download server from where you want to download KDE packages. We recommend the winkde.org mirror. Press the 'Next >' button.
  10. From the available releases, please choose the stable release with the highest number. At the moment, this is version 4.2.0. Press the 'Next >' button.
  11. Please select the packages you would like to install. You have to select the check boxes (in the 'Bin/Devel/Doc' column) of the following packages:
    1. aspell (bin)
    2. aspell-de (bin)
    3. aspell-en (bin)
    4. attica (bin/dev)
    5. automoc (bin)
    6. boost (bin)
    7. bzip2 (bin)
    8. cmake (bin)
    9. cyrus-sasl (bin)
    10. dbg_x86 (bin)
    11. dbus (bin)
    12. debugview (bin)
    13. exiv2 (bin)
    14. expat (bin)
    15. flex (bin / dev)
    16. gdb (bin)
    17. gettext (bin)
    18. gettext-tools (bin)
    19. giflib (bin)
    20. gzip (bin)
    21. iconv (bin)
    22. jasper (bin)
    23. jpeg (bin)
    24. kdebase-apps (bin)
    25. kdebase-runtime (bin)
    26. kdelibs (bin/dev)
    27. kdepimlibs (bin)
    28. kdewin (bin/dev)
    29. libbzip2 (bin)
    30. libical (bin)
    31. libpng (bin)
    32. libxml2 (bin)
    33. libxslt (bin)
    34. mingw-utils (bin)
    35. openssl (bin)
    36. oxygen-icons (bin)
    37. patch (bin)
    38. pcre (bin)
    39. phonon (bin/dev)
    40. phonon-backends (bin)
    41. qca (bin)
    42. qimjageblitz (bin)
    43. qt (bin/dev)
    44. runtime (bin)
    45. shared-mime-info (bin)
    46. soprano (bin)
    47. strigi (bin)
    48. taglib (bin)
    49. tiff (bin)
    50. upx (bin)
    51. zlib (bin/dev)
  12. For simon to work correctly you need QtMultimedia 4.6.3 which might need to be installed seperately (at the time of this writing the last version in the KDE installer is Qt 4.6.2).
  13. Select "Next" and the Installer will display another list of packages that were selected automatically because they are needed by the manually selected packages. Select "Next" to continue.
  14. The installer will now download the packages.
  15. After all packages are loaded the installation will begin automatically. Some of the packages need user interaction to be installed (the order can vary):
    1. MinGW: If the installer asks if it should check for newer versions of the package, select "No"! During the selection of the components select "MinGW Base Tools", "g++ compiler" and "MinGW Make". All other settings can be left at their default values. MinGW will now be loaded and installed.
    2. The rest of the packages will be installed automatically (silently).
  16. Download TortoiseGit (http://code.google.com/p/tortoisegit/downloads/list) and install it to C:\rogram Files\TortoiseGit
  17. Download MSysGit (http://code.google.com/p/msysgit/downloads/list) and install it to C:\Git
  18. Now open the "System settings" by pressing and holding the "Windows"-key and simultaniously pressing the "Pause"-key.
  19. Go to the "Advanced" tab and select "Environment variables".
  20. Look for the "Path" entry in the "System variables" list and double-click it.
  21. You can now change the value of this variable. Do not replace the content but add the following at the end of the line: ";C:\KDE\bin;C:\MinGW\bin;C:\Git\bin" and press "Ok".
  22. You can close the dialogs now.
  23. Download and install the Visual C Runtime from Microsoft: http://www.microsoft.com/downloads/details.aspx?familyID=32bc1bee-a3f9-4c13-9c99-220b62a191ee&displaylang=en
  24. Now open the file "C:\KDE\share\apps\cmake\modules\KDELibsDependencies.cmake" with a text editor (like notepad: "Editor").
  25. Press and hold down the "Control"-key and simultaniously press the "H" key to open the search and replace dialog. Enter "C:/kde/kde-mingw4" into the search field and enter "C:/KDE" into the "Replace with" field. Now select "Replace all" to replace all occurences.
  26. Save the file and close the editor.
  27. Now do the same with the file "C:\KDE\share\apps\cmake\modules\KDELibs4LibraryTargets-release.cmake".
  28. Restart your computer

This concludes the installation of KDE.

[edit]

HTK

  1. Register at http://htk.eng.cam.ac.uk/register.shtml (free)
  2. Download the latest windows binary version from "http://htk.eng.cam.ac.uk/ftp/software/". The file will be named "htk-3.x-windows-binary.zip". At the moment the latest binary release for windows is the version 3.3. It can be found at this direct link: "http://htk.eng.cam.ac.uk/ftp/software/htk-3.3-windows-binary.zip"
  3. This archive contains a folder "htk". Copy the contents of this folder to "C:\KDE\bin".
  4. You can now delete the archive.
  5. This concludes the installation.
[edit]

Portaudio 

If you don't want to use sam or Julius directly, you can skip this step.
  1. Download the portaudio dll from "http://code.google.com/p/portaudiosharp/downloads/detail?name=PortAudio.dll&can=2&q=" and move it to the folder "C:\KDE\bin".
  2. Download the portaudio_x86.dll from "http://code.google.com/p/jpab/downloads/detail?name=portaudio_x86.dll&can=2&q=" and move it to the folder "C:\KDE\bin".
  3. Then download the latest portaudio snapshot version (NOT the "stable version") from "http://www.portaudio.com/download.html". Direct link: http://www.portaudio.com/archives/pa_snapshot.tar.gz
  4. Move this file to "C:\".
  5. Download the windows setup of 7-Zip from http://www.7-zip.org/download.html (Direct link of the current version: http://downloads.sourceforge.net/sevenzip/7z465.exe)
  6. Install 7-Zip using the downloaded installation file.
  7. Open the folder "C:\" with the windows explorer and right-click on the previously downloaded file "pa_snapshot.tar.gz" and select "7-Zip" > "Extract Here".
  8. This will create the file "pa_snapshot.tar". Right click this file and again select "7-Zip" > "Extract Here".
  9. This creates the folder "C:\portaudio".
  10. You can now delete the files "pa_snapshot.tar" and "pa_snapshot.tar.gz"
  11. This concludes the portaudio installation.
[edit]

Bison

  1. Download the following DLLs and move them to the folder "C:\KDE\bin":
    1. "libintl3.dll" from "http://www.dsource.org/projects/dsss/browser/winbins/libintl3.dll?rev=45"(Direct link: "http://www.dsource.org/projects/dsss/browser/winbins/libintl3.dll?rev=45&format=raw")
    2. "libiconv2.dll" from "http://www.dsource.org/projects/dsss/browser/winbins/libiconv2.dll?rev=45" (Direct link: "http://www.dsource.org/projects/dsss/browser/winbins/libiconv2.dll?rev=45&format=raw")
    3. "libintl-2.dll" from "http://www.dsource.org/projects/dsss/browser/winbins/libintl-2.dll?rev=125" (Direct link: "http://www.dsource.org/projects/dsss/browser/winbins/libintl-2.dll?rev=125&format=raw")o:"
  2. Download regex2.dll from http://code.google.com/p/unwad/source/browse/trunk/dll/regex2.dll?spec=svn9&r=9 and copy it to the KDE binary folder (default: "C:\KDE\bin")
  3. Download the bison "Binaries" from "http://gnuwin32.sourceforge.net/packages/bison.htm" (Direct link: "http://downloads.sourceforge.net/gnuwin32/bison-2.4.1-bin.zip")
  4. Select the downloaded archive with the right mouse button and and choose "7-Zip" > "Extract files..."
  5. A dialog will be displayed. Change the "Extract to:" field to "C:\KDE" and select "Ok".
  6. This concludes the bison installation.
[edit]

simon

The following section will describe how to install simon and simond. All paths should be correct if you followed the instructions above carefully.

[edit]

Installation

  1. Open "C:\" and right-click at the background in order to get the context menu of the folder and select the option "Git Clone".
  2. Enter "git://speech2text.git.sourceforge.net/gitroot/speech2text/speech2text" for the checkout URL and "C:\simonsource" as "Checkout directory".
  3. Confirm that you want to create the folder "C:\simonsource".
  4. The current version of simon will now be downloaded. This can take a while.
  5. When Git has completed the checkout you can close the window.
  6. Now open a commando prompt by pressing and holding the "Windows"-key and pressing simultaniously pressing the "R" key. Enter "cmakesetup" in the resulting window and select "Ok".
  7. A dialog will be displayed. Enter "C:\simonsource" into the "Where is the source code:" field.
  8. Enter "C:\simonsource\build" into the field "Where to build the binaries:".
  9. Press "Configure".
  10. You will be prompted for the generator to use. Please select "MinGW Makefiles" from the list.
  11. simon will now be configured. This can take a few seconds.
  12. Change the value of "CMAKE_INSTALL_PREFIX" from "C:/simon" to "C:/KDE" and press "Enter" to apply the changes.
  13. Confirm by pressing "Ok".
  14. Open up a command prompt by pressing and holding the "Windows"-Key and simultaniously pressing the "R" key. In the resulting window enter "cmd" and confirm with "Ok".
  15. A black command prompt will open. Enter the following commands:
    1. cd C:\simonsource\build
    2. mingw32-make
    3. mingw32-make install
  16. You can now close the command prompt by entering "exit".
  17. simon is now compiled and installed to "C:\KDE". To start it just launch the program "C:\KDE\bin\simon.exe"
[edit]

Update

  1. Open "C:\" with the windows explorer.
  2. Select the subfolder "simonsource" with your right mouse button. In the contextmenu select the option "Git Sync" and update your local repository copy.
  3. Open up a command prompt by pressing and holding the "Windows"-Key and simultaniously pressing the "R" key. In the resulting window enter "cmd" and confirm with "Ok".
  4. A black command prompt will open. Enter the following commands:
    1. cd C:\simonsource\build
    2. mingw32-make
    3. mingw32-make install
  5. You can now close the command prompt by entering "exit".
  6. This completes the update.
[edit]

Linux

This guide will assume that you are using Ubuntu Linux or OpenSUSE. If you use a different distribution you will have to look up the correct name of the packages yourself and install them on your own.

This guide was tested on a clean, updated Ubuntu 8.10 Intrepid Ibex and Ubuntu 9.04 Jaunty Jackalope installation as well as a fresh OpenSUSE 11.1.

If you already installed the binary version of simon, please remove it! 

Debian based Systems:
sudo dpkg -r simon
[edit]

Requirements

You will need a couple of packages before getting to work. Install them using the following command: 

Debian based Systems:
sudo apt-get install git-core build-essential cmake bison flex gettext gettext-kde kdeartwork \
kdelibs5-dev libxtst-dev libqt4-sql-sqlite libqt4-multimedia libqt4-phonon-dev libattica-dev libattica0 zlib1g-dev \
portaudio19-dev
Note: You don't actually need kdeartwork to compile or run simon - it will just look ugly without it.

RPM based Systems:
sudo zypper in git-core gcc bison flex gettext-tools gettext-runtime libkde4-devel portaudio \
portaudio-devel libqt4-sql-sqlite libqt4-multimedia libqt4-phonon-devel libattica-devel libattica0 zlib-devel

If you use a different language than english we recommend installing the appropriate kde-l10n package. You can list all available translation using the following command: 

Debian based Systems:
apt-cache search kde-l10n

Choose your translation and install it. 

Debian based Systems:
sudo apt-get install kde-l10n-<countrycode>
[edit]

Compiling

Now check out a current copy of simon from svn using the following command: 

git clone git://speech2text.git.sourceforge.net/gitroot/speech2text/speech2text simonsource

This will create a new directory called simonsource in your current working directory containing the simon source code.

You can now make your changes. If you want to compile and install your new simon version, just call the build-script in the simonsource directory: 

Ubuntu:
./build_ubuntu.sh

Other distributions:
./build.sh


You now have compiled and installed simon. Please continue to install HTK on page Installation > Linux > HTK installation.

Retrieved from "http://www.cyber-byte.at/wiki/index.php/Development_Environment"
Personal tools