Simon/Installation: Difference between revisions

From KDE UserBase Wiki
mNo edit summary
 
(16 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The following pages describe how you as an end-user can install and configure Simon on your computer, so that you can control your PC via voice. Please refer to the [[Simon/Handbook|Handbook]] for information about how to proceed after the installation.
<languages/>
<translate>
<!--T:1-->
The following pages describe how you as an end-user can install and configure Simon on your computer, so that you can control your PC via voice. Please refer to the [[Special:myLanguage/Simon/Handbook|Handbook]] for information about how to proceed after the installation.


Software developers please follow page [[Simon/Development_Environment|Setting up A Development Environment]].
<!--T:2-->
Software developers please follow page [[Special:myLanguage/Simon/Development_Environment|Setting up A Development Environment]].


== Windows ==
== Windows == <!--T:3-->


* Get the current version of Simon from our [https://sourceforge.net/projects/speech2text Sourceforge page]. Make sure you download the Windows version of Simon - it contains "win32" in its name and ends with ".exe".
<!--T:4-->
* Get the current version of Simon from [http://download.kde.org/stable/simon/0.4.0/win32/simon-x86-setup-0.4.0.exe.mirrorlist]. Make sure you download the Windows version of Simon - it contains "win32" in its name and ends with ".exe".


<!--T:5-->
* Run the installation wizard to install Simon. If you are unsure at some point during the installation you can just keep the default values.
* Run the installation wizard to install Simon. If you are unsure at some point during the installation you can just keep the default values.


=== HTK installation ===
=== Optional: HTK installation === <!--T:6-->


If you want to train your acoustic model you also need the HTK. If you only want to use a static base model you can safely skip this step.
<!--T:7-->
If you want to train or adapt HTK acoustic models, you also need the HTK. If you don't know what that means, you can safely skip this whole step.


Simon uses a software called [http://htk.eng.cam.ac.uk/ Hidden Markov Model Toolkit (HTK)] to generate the speechmodel. This software is free of charge, but its licence prohibits its distribution with Simon.
<!--T:8-->
Simon uses a software called [http://htk.eng.cam.ac.uk/ Hidden Markov Model Toolkit (HTK)] to generate the speechmodel. This software is free of charge, but its license prohibits its distribution with Simon.


<!--T:9-->
* Now please register at the [http://htk.eng.cam.ac.uk/register.shtml HTK homepage] (it's free). Shortly after you entered your account details you should receive an e-mail containing your personal HTK-password.
* Now please register at the [http://htk.eng.cam.ac.uk/register.shtml HTK homepage] (it's free). Shortly after you entered your account details you should receive an e-mail containing your personal HTK-password.


<!--T:10-->
* Download the [http://htk.eng.cam.ac.uk/ftp/software/htk-3.3-windows-binary.zip HTK]. You will be asked your username and HTK-password.
* Download the [http://htk.eng.cam.ac.uk/ftp/software/htk-3.3-windows-binary.zip HTK]. You will be asked your username and HTK-password.


* Extract HTK to the bin-subfolder of your Simon installation directory. Default path is <code>C:\Program Files\Simon 0.3\bin</code>. The binary files from the archive (HHEd.exe, HDMan.exe, etc.) must be stored directly in this bin-folder (fe.: <code>C:\Program Files\Simon 0.3\bin\HDMan.exe</code>) and NOT in a subfolder of bin.
<!--T:11-->
* Extract HTK to the bin-subfolder of your Simon installation directory. Default path is <code>C:\Program Files\Simon 0.3\bin</code>. The binary files from the archive (HHEd.exe, HDMan.exe, etc.) must be stored directly in this bin-folder (e.g. <code>C:\Program Files\Simon 0.3\bin\HDMan.exe</code>) and NOT in a subfolder of bin.


<!--T:12-->
----
----


== Linux ==
== Linux == <!--T:13-->


There are several ways to install Simon on linux. Users of debian based systems should use the provided debian package and users of OpenSUSE should use the RPM packages while users of other distributions should use the general binary package.
<!--T:14-->
There are several ways to install Simon on linux. If there are packages for your distribution, please install Simon through your regular package manager. Additional steps after installation from the repository are sometimes required: 
* Linux Mint Installation  (tested on 17.1 Mate) works fine via repository, but the connection to simond refused due to missing access to database. Connection can be established if libqt4-sql-lite is installed.
  {{Input|sudo apt-get install  libqt4-sql-sqlite}}


For an installation from sourcecode please follow page [[Simon/Development Environment|Setting up A Development Environment]].
<!--T:15-->
For an installation from sourcecode please follow page [[Special:myLanguage/Simon/Development Environment|Setting up A Development Environment]].


=== OpenSUSE ===
=== Optional: HTK installation === <!--T:37-->


To install Simon on OpenSUSE, please use the official packages on the OpenSUSE Build Service that are provided by the Simon Listens team.
<!--T:38-->
If you want to train or adapt HTK acoustic models, you also need the HTK. If you don't know what this means, you can safely skip this step.


Simply [http://software.opensuse.org/search?q=simon&baseproject=openSUSE%3A11.3&lang=de&exclude_filter=home%3A&exclude_debug=true search for Simon on the OpenSUSE Software search] and install Simon using the one click installation link for your repository.
<!--T:39-->
Simon uses a software called [http://htk.eng.cam.ac.uk/ Hidden Markov Model Toolkit (HTK)] to generate the speechmodel. This software is free of charge, but its license prohibits its distribution with Simon.


During installation Yast will offer to add the KDE:Unstable:Playground repository to your system which you should accept. This way you also get updates for Simon when we release new versions.
<!--T:40-->
 
For Linux users HTK is only shipped as source code which means that you will have to compile HTK for yourself. Fortunately, this is quite easy.
After completing the installation the Simon applications will be installed on your system. To also install translation and the handbook (recommended) install the simon-doc and simon-lang packages which will show up in your package manager automatically after adding the repository in the previous step. You can of course also download them manually using the software search (link above).
 
For OpenSUSE 11.3 the direct links are these:
 
* [http://software.opensuse.org/ymp/KDE:Unstable:Playground/openSUSE_11.3/simon.ymp?base=openSUSE%3A11.3&query=simon simon]
 
* [http://software.opensuse.org/ymp/KDE:Unstable:Playground/openSUSE_11.3/simon-lang.ymp?base=openSUSE%3A11.3&query=simon simon-lang (translations)]
 
* [http://software.opensuse.org/ymp/KDE:Unstable:Playground/openSUSE_11.3/simon-doc.ymp?base=openSUSE%3A11.3&query=simon simon-doc (manuals)]
 
=== Ubuntu ===
 
For Ubuntu please use the provided ppa repository maintained by the Simon Listens team.
 
To add the repository to your system execute the following commands in a command line:
# sudo add-apt-repository ppa:simon-listens/releases
# sudo apt-get update 
 
You can find more information about this process in the [https://launchpad.net/+help/soyuz/ppa-sources-list.html ubuntu documentation].
 
You can then install Simon with your package manager. Simon will be updated automatically when new versions are released through the systems update process.
 
=== Manual ===
 
* Download the current installation file from our [https://sourceforge.net/projects/speech2text/files/ Sourceforge page]. Select the file matching your architecture (i386/amd64) and your system (.deb/.rpm/.sh).
 
* Install Simon using the just loaded installation file. If installation does not automatically start, you can use the following commands in a terminal:
 
cd <path_to_file>
 
Debian based Systems: (min. Ubuntu Intrepid Ibex (8.10))
sudo dpkg -i simon-<version>-<...>.deb
 
RPM based Systems:
sudo rpm -i simon-<version>-<...>.rpm
 
Generic Systems:
./simon-<version>-<...>.sh
 
=== HTK installation ===
 
If you want to train your acoustic model you also need the HTK. If you only want to use a static base model you can safely skip this step.
 
Simon uses a software called [http://htk.eng.cam.ac.uk/ Hidden Markov Model Toolkit (HTK)] to generate the speechmodel. This software is free of charge, but its licence prohibits its distribution with Simon.
 
For Linux users HTK is only shipped as source code which means that you will have to compile HTK for yourself. Fourtunately, this is quite easy.


<!--T:41-->
Before we can install HTK, we have to install its dependencies. Please install the following packages:
Before we can install HTK, we have to install its dependencies. Please install the following packages:
* ALSA Development files
* ALSA Development files
Line 89: Line 62:
* Buildsystem with Compiler and Linker (mostly called "build-essential" or similar)
* Buildsystem with Compiler and Linker (mostly called "build-essential" or similar)


Debian based Systems:
<!--T:42-->
sudo apt-get install build-essential libx11-dev libasound2-dev
Debian based Systems:
{{Input|sudo apt-get install build-essential libx11-dev libasound2-dev}}


<!--T:43-->
* Now please register at the [http://htk.eng.cam.ac.uk/register.shtml HTK homepage] (it's free). Shortly after you entered your account details you should receive an e-mail containing your personal HTK-password.
* Now please register at the [http://htk.eng.cam.ac.uk/register.shtml HTK homepage] (it's free). Shortly after you entered your account details you should receive an e-mail containing your personal HTK-password.


<!--T:44-->
* Download the most recent [http://htk.eng.cam.ac.uk/ftp/software/ HTK sourcecode] (HTK-<version>.tar.gz). You will be asked your username and HTK-password.
* Download the most recent [http://htk.eng.cam.ac.uk/ftp/software/ HTK sourcecode] (HTK-<version>.tar.gz). You will be asked your username and HTK-password.


<!--T:45-->
* To extract, configure, build and install the downloaded Tarball, execute the following commands in a terminal:
* To extract, configure, build and install the downloaded Tarball, execute the following commands in a terminal:


cd <path_to_file>
<!--T:46-->
{{Input|1=<nowiki>cd <path_to_file>
tar xvf HTK-<version>.tar.gz
cd htk/</nowiki>}}
 
<!--T:48-->
64bit-Systems only!<br />
:Remove all appearances of -m32 in <tt>configure.ac</tt> and run <code>autoconf</code> to regenerate the configure-file. Then run <code>./configure</code> again!
 
<!--T:49-->
{{Input|1=<nowiki>./configure
make
sudo make install</nowiki>}}
 
== Mac OS X == <!--T:51-->


tar xvf HTK-<version>.tar.gz
<!--T:52-->
cd htk/
If you want to use Simon on Mac OS X, you need to compile from source. This is only recommended for more experienced users.


64bit-Systems only!
<!--T:53-->
Remove all appearances of -m32 in configure.ac and run autoconf!
For an installation from sourcecode please follow page [[Special:myLanguage/Simon/Development Environment|Setting up A Development Environment]].


./configure
<!--T:50-->
make
[[Category:Accessibility]]
sudo make install
</translate>

Latest revision as of 11:55, 4 October 2015

Other languages:

The following pages describe how you as an end-user can install and configure Simon on your computer, so that you can control your PC via voice. Please refer to the Handbook for information about how to proceed after the installation.

Software developers please follow page Setting up A Development Environment.

Windows

  • Get the current version of Simon from [1]. Make sure you download the Windows version of Simon - it contains "win32" in its name and ends with ".exe".
  • Run the installation wizard to install Simon. If you are unsure at some point during the installation you can just keep the default values.

Optional: HTK installation

If you want to train or adapt HTK acoustic models, you also need the HTK. If you don't know what that means, you can safely skip this whole step.

Simon uses a software called Hidden Markov Model Toolkit (HTK) to generate the speechmodel. This software is free of charge, but its license prohibits its distribution with Simon.

  • Now please register at the HTK homepage (it's free). Shortly after you entered your account details you should receive an e-mail containing your personal HTK-password.
  • Download the HTK. You will be asked your username and HTK-password.
  • Extract HTK to the bin-subfolder of your Simon installation directory. Default path is C:\Program Files\Simon 0.3\bin. The binary files from the archive (HHEd.exe, HDMan.exe, etc.) must be stored directly in this bin-folder (e.g. C:\Program Files\Simon 0.3\bin\HDMan.exe) and NOT in a subfolder of bin.

Linux

There are several ways to install Simon on linux. If there are packages for your distribution, please install Simon through your regular package manager. Additional steps after installation from the repository are sometimes required:

  • Linux Mint Installation (tested on 17.1 Mate) works fine via repository, but the connection to simond refused due to missing access to database. Connection can be established if libqt4-sql-lite is installed.
sudo apt-get install  libqt4-sql-sqlite

For an installation from sourcecode please follow page Setting up A Development Environment.

Optional: HTK installation

If you want to train or adapt HTK acoustic models, you also need the HTK. If you don't know what this means, you can safely skip this step.

Simon uses a software called Hidden Markov Model Toolkit (HTK) to generate the speechmodel. This software is free of charge, but its license prohibits its distribution with Simon.

For Linux users HTK is only shipped as source code which means that you will have to compile HTK for yourself. Fortunately, this is quite easy.

Before we can install HTK, we have to install its dependencies. Please install the following packages:

  • ALSA Development files
  • X11 Development files
  • Buildsystem with Compiler and Linker (mostly called "build-essential" or similar)

Debian based Systems:

sudo apt-get install build-essential libx11-dev libasound2-dev
  • Now please register at the HTK homepage (it's free). Shortly after you entered your account details you should receive an e-mail containing your personal HTK-password.
  • Download the most recent HTK sourcecode (HTK-<version>.tar.gz). You will be asked your username and HTK-password.
  • To extract, configure, build and install the downloaded Tarball, execute the following commands in a terminal:
cd <path_to_file>
tar xvf HTK-<version>.tar.gz
cd htk/

64bit-Systems only!

Remove all appearances of -m32 in configure.ac and run autoconf to regenerate the configure-file. Then run ./configure again!
./configure
 make
 sudo make install

Mac OS X

If you want to use Simon on Mac OS X, you need to compile from source. This is only recommended for more experienced users.

For an installation from sourcecode please follow page Setting up A Development Environment.