Changes: Installing tovid

Latest revision as of 05:17, 16 May 2015

This page provides download links and instructions for installing tovid.

Use the source
Install from Git
Platform-specific instructions

Use the source[]

For platform-independent installation, you can use the source .tar.gz. First install all tovid dependencies, to prevent potential problems.

Next, download tovid-0.35.2.tar.gz. This tarball contains everything you need to run tovid and the GUI. Save this somewhere on your computer (for now, we'll assume it's saved in ~/Downloads/).

To extract the tarball, open a terminal window (such as XTerm, RXVT, or Konsole) and type the following commands, substituting for ~/Downloads the path where you saved the .tar.gz:

$ cd ~/Downloads
$ tar -xzvf tovid-0.35.2.tar.gz
$ cd tovid-0.35.2
$ ./setup.py build

Then:

$ sudo ./setup.py install
or
$ su -c './setup.py install'

depending on your distribution (Ubuntuers should use sudo). You will be prompted for the root password to install tovid system-wide. If you want a prefix other than /usr/local , add --prefix=/opt to the above command (for example).

If you decide you don't want tovid installed anymore, run:

$ sudo ./setup.py uninstall
or
$ su -c './setup.py uninstall'

from the original installation directory (~/Downloads/tovid-0.35.2) as root.

Git[]

If you want to get the latest code directly from the development repository, you will need to install git and txt2tags first. Assuming you want to put the tovid installer in ~/Downloads:

$ cd ~/Downloads
$ git clone https://github.com/tovid-suite/tovid.git
$ cd tovid
$ ./setup.py build
$ ./setup.py build_docs
$ ./setup.py build_tovid_init

Note: do not use --depth 1 as part of your "git clone" command or setup.py with not be able to determine a version string.

then, as before:

$ sudo ./setup.py install
or
$ su -c './setup.py install'

You should now have the latest version installed (bugs and all!) You can keep in sync with updates by doing:

$ cd ~/Downloads/tovid
$ git pull

followed by a re-install (sudo ./setup.py install). See the Official Git Tutorial for more about dealing with git.

Check out the Development plans and talk page.

Platform-specific instructions[]

Updated April 14 2015

There are a number of new instructions for tovid-0.35.2 for various distributions below. As well, outdated packages and links have been removed. If your distro is not included there, it is recommended that you use git or the source tarball instead of an outdated package from your distribution.

If you have created a tovid package, please become a packager and add links/instructions above.

@@ Line 1: / Line 1: @@
 This page provides download links and instructions for installing tovid.
+* [[#Use the source|Use the source]]
-== Subversion ==
+* [[#Git|Install from Git]]
+* [[#Platform-specific instructions|Platform-specific instructions]]
+== Use the source ==
+For platform-independent installation, you can use the source '''.tar.gz'''. First install all [[tovid dependencies]], to prevent potential problems.
-As 0.31 is very old now, the best install option is to use subversion (a.k.a SVN).  By using SVN you can get a copy of the latest development version of tovid.
+Next, download {{LatestTarball}}. This tarball contains everything you need to run tovid and the GUI. Save this somewhere on your computer (for now, we'll assume it's saved in '''~/Downloads/''').
-Use [http://subversion.tigris.org/ Subversion] (SVN) to get the latest code directly from the development repository. You'll need the tool used to make the manpages: [http://txt2tags.sourceforge.net txt2tags]. Again, assuming you want to put the tovid installer in '''~/Downloads''':
+To extract the tarball, open a terminal window (such as XTerm, RXVT, or Konsole) and type the following commands, substituting for '''~/Downloads''' the path where you saved the .tar.gz:
-<pre style="overflow:auto">
  $ cd ~/Downloads
+ $ tar -xzvf {{LatestRelease}}.tar.gz
- $ <nowiki>svn checkout http://tovid.googlecode.com/svn/trunk/tovid tovid</nowiki>
- $ cd tovid
+ $ cd {{LatestRelease}}
- $ ./bootstrap
+ $ ./setup.py build
- $ ./configure
- $ su -c "make install"
-</pre>
+Then:
-{{Note|Use '''sudo make install''' on Ubuntu.}}
+ $ sudo ./setup.py install
-You should now have the latest version installed (bugs and all!) You can keep in sync with updates by doing:
+ or
+ $ su -c './setup.py install'
+depending on your distribution (Ubuntuers should use <code>sudo</code>). You will be prompted for the root password to install tovid system-wide.
- $ cd ~/Downloads/tovid
+If you want a prefix other than /usr/local , add --prefix=/opt to the above command (for example).
- $ svn update
- $ ./bootstrap
-followed by a re-install (<code>./configure && su -c "make install"</code>). See the [[SVN crash course]] for more about dealing with SVN. If you install from SVN, you're strongly encouraged to start hanging out with the developers on the IRC channel, or on the tovid forum, to get involved with development. Even if you don't know the first thing about code, your input is needed. (Do you really want to leave tovid in the hands of a bunch of code monkeys?)
+If you decide you don't want tovid installed anymore, run:
-Check out the [[Development plans]] and [[Talk:Development plans|talk page]].
+ $ sudo ./setup.py uninstall
-== Platform-specific instructions ==
+ or
+ $ su -c './setup.py uninstall'
+from the original installation directory ('''~/Downloads/{{LatestRelease}}''') as root.
-'''Note:''' tovid 0.31 is very old now.  It is recommended that you use subversion (see 'Subversion' above) instead of a source tarball or a distro specific 0.31 package.  Non-the-less platform-specific instructions follow:
+== Git ==
-* [[Installing tovid/Debian | Debian]]
-* [[Installing tovid/Ubuntu | Ubuntu]]
-* [[Installing_tovid/Gentoo | Gentoo]]
-* [[Installing tovid/Mandriva | Mandriva]]
-* [[Installing tovid/Slackware | Slackware]]
-* [[Installing_tovid/Freespire | Freespire]]
-* [[Installing_tovid/Cygwin | Cygwin]]
+If you want to get the latest code directly from the development repository, you will need to install [http://git-scm.com/ git] and [http://txt2tags.sourceforge.net txt2tags] first. Assuming you want to put the tovid installer in '''~/Downloads''':
-Other available package formats (no instructions yet):
+ $ cd ~/Downloads
-* [http://packman.links2linux.de/ SuSE RPM repository]
+ $ <nowiki>git clone https://github.com/tovid-suite/tovid.git</nowiki>
-* [http://www.bennewitz.com/rpms/ Fedora Core yum enabled repository] ''NOTE: As of March 14, 2007 the todiscgui.desktop file (fedora-tovid-todisc.desktop) in the Fedora rpm is broken.  Edit and set '''Terminal=true''' instead of '''Terminal=false'''.''
+ $ cd tovid
+ $ ./setup.py build
+ $ ./setup.py build_docs
+ $ ./setup.py build_tovid_init
+'''Note: do not use --depth 1 as part of your "git clone" command or setup.py with not be able to determine a version string.'''
-If you have created a tovid package, please [[become a packager]] and add links/instructions above.
+then, as before:
-== Use the source ==
+ $ sudo ./setup.py install
-For platform-independent installation, you can use the source '''.tar.gz'''. Again, 0.31 is very old so it is recommended that you use subversion instead. (see 'Subversion' above).  First install all [[tovid dependencies]], to prevent potential problems.
+ or
+ $ su -c './setup.py install'
+You should now have the latest version installed (bugs and all!) You can keep in sync with updates by doing:
-Next, download {{LatestTarball}}. This tarball contains everything you need to run tovid and the GUI. Save this somewhere on your computer (for now, we'll assume it's saved in '''~/Downloads/''').
+ $ cd ~/Downloads/tovid
-To extract the tarball, open a terminal window (such as XTerm, RXVT, or Konsole) and type the following commands, substituting for '''~/Downloads''' the path where you saved the .tar.gz:
+ $ git pull
+followed by a re-install (<code>sudo ./setup.py install</code>). See the [http://git-scm.com/docs/gittutorial Official Git Tutorial] for more about dealing with git.
- $ cd ~/Downloads
- $ tar -xzvf {{LatestRelease}}.tar.gz
+Check out the [[Development plans]] and [[Talk:Development plans|talk page]].
-The installation files will go into a subdirectory '''{{LatestRelease}}''' within the current directory.  Next, check to see if there are any patches that need to be made by looking at the [http://www.createphpbb.com/phpbb/viewtopic.php?t=242&mforum=tovid Official Patches Sticky] in the forums. Follow any instructions you find there, keeping in mind you only need patches for '''{{LatestRelease}}'''.
+== Platform-specific instructions ==
-Finally, do the following:
+'''Updated April 14 2015'''
- $ cd ~/Downloads/{{LatestRelease}}
- $ ./configure
- $ su -c "make install"
+There are a number of new instructions for {{LatestRelease}} for various distributions below. As well, outdated packages and links have been removed. If your distro is not included there, it is recommended that you use [[#Git|git]] or the [[#Use the source | source tarball]] instead of an outdated package from your distribution.
-{{Note|Ubuntu users should use '''sudo make install''' instead, and must have package '''build-essential''' installed.}}
+* [[Installing_tovid/Arch Linux | Arch Linux]]
-You will be prompted for the root password to install tovid system-wide. If you decide you don't want tovid installed anymore, run '''make uninstall''' from the original installation directory ('''~/Downloads/{{LatestRelease}}''') as root.
+* [[Installing_tovid/FreeBSD | FreeBSD]]
+* [[Installing_tovid/Centos | Centos]]
-{{Note|Again, Ubuntu users should use '''sudo make uninstall''' instead.}}
+* [[Installing_tovid/Cygwin | Cygwin]]
+* [[Installing tovid/Debian | Debian]]
+* [[Installing_tovid/Fedora | Fedora]]
+* [[Installing_tovid/Gentoo | Gentoo]]
+* [[Installing_tovid/Linux Mint |Linux Mint]]
+* [[Installing_tovid/Mageia | Mageia]]
+* [[Installing tovid/Slackware | Slackware]]
+* [[Installing_tovid/Suse | Suse]]
+* [[Installing tovid/Ubuntu | Ubuntu]]
+* [[Installing tovid/Embedded | Embedded]] (Buildroot)
+If you have created a tovid package, please [[become a packager]] and add links/instructions above.
 [[Category:Documentation]]
 [[Category:HOWTO]]