| 1 | # INSTALL |
|---|
| 2 | # ======= |
|---|
| 3 | |
|---|
| 4 | |
|---|
| 5 | # 1. Requirements |
|---|
| 6 | # =============== |
|---|
| 7 | |
|---|
| 8 | python (>= 2.3.5-7), python-xml, python-mutagen, python-django (>= 1.0-1), |
|---|
| 9 | python-imaging (>= 1.1.6), sox, vorbis-tools, flac, normalize-audio, |
|---|
| 10 | python-mysqldb, mysql-server, octave2.9, python-tk, libgd2-xpm, |
|---|
| 11 | libsndfile1 (>= 1.0.17), python-numpy, python-ctypes (>= 1.0.1), |
|---|
| 12 | python-scikits-audiolab (>= 0.7), python-setuptools (>= 0.6b3), |
|---|
| 13 | python-support (>= 0.3), |
|---|
| 14 | |
|---|
| 15 | optional: |
|---|
| 16 | lame, ecasound, par2 |
|---|
| 17 | |
|---|
| 18 | # 2. Install |
|---|
| 19 | # ========== |
|---|
| 20 | |
|---|
| 21 | 2.1.1 Install Telemeta: |
|---|
| 22 | |
|---|
| 23 | * On Debian (Testing recommended) or Ubuntu Hoary : |
|---|
| 24 | |
|---|
| 25 | Just add these lines to your /etc/apt/sources-list: |
|---|
| 26 | |
|---|
| 27 | deb http://debian.parisson.org/ binary/ |
|---|
| 28 | deb-src http://debian.parisson.org/ source/ |
|---|
| 29 | deb http://www.debian-multimedia.org etch main |
|---|
| 30 | |
|---|
| 31 | Then, |
|---|
| 32 | |
|---|
| 33 | $ sudo apt-get update |
|---|
| 34 | $ sudo apt-get install telemeta |
|---|
| 35 | |
|---|
| 36 | This method provides the installation of all needed packages |
|---|
| 37 | thanks to the Debian dependency system. |
|---|
| 38 | |
|---|
| 39 | Go to 2.2. |
|---|
| 40 | |
|---|
| 41 | * On other linux platforms |
|---|
| 42 | |
|---|
| 43 | Install all dependencies listed at 1. |
|---|
| 44 | |
|---|
| 45 | Download the lastest release of telemeta at |
|---|
| 46 | |
|---|
| 47 | http://svn.parisson.org/telemeta/ |
|---|
| 48 | |
|---|
| 49 | Uncompress the archive like : |
|---|
| 50 | |
|---|
| 51 | $ tar xzvf telemeta_0.3.2.tar.gz |
|---|
| 52 | |
|---|
| 53 | Go to the main folder of telemeta and run this command |
|---|
| 54 | in a shell as root: |
|---|
| 55 | |
|---|
| 56 | $ sudo python setup.py install |
|---|
| 57 | |
|---|
| 58 | |
|---|
| 59 | 2.1.2. Install audiolab |
|---|
| 60 | |
|---|
| 61 | This is ONLY needed if you did NOT install telemeta with Debian's apt-get. |
|---|
| 62 | |
|---|
| 63 | In order to get the wavforms of the audio files, |
|---|
| 64 | python-audiolab have to be installed in telemeta : |
|---|
| 65 | |
|---|
| 66 | $ svn export http://svn.scipy.org/svn/scikits/trunk/audiolab |
|---|
| 67 | $ cd audiolab/ |
|---|
| 68 | $ sudo python setup.py install |
|---|
| 69 | |
|---|
| 70 | |
|---|
| 71 | 2.1.3. Install the Django framework version 1.0: |
|---|
| 72 | |
|---|
| 73 | Â * On Debian (Testing recommended) or Ubuntu Hoary : |
|---|
| 74 | |
|---|
| 75 | $ sudo apt-get install python-django |
|---|
| 76 | |
|---|
| 77 | * On other linux platforms, download and install from: |
|---|
| 78 | |
|---|
| 79 | http://www.djangoproject.com/download/ |
|---|
| 80 | |
|---|
| 81 | |
|---|
| 82 | 2.2. Create a Django project if you haven't already done it: |
|---|
| 83 | |
|---|
| 84 | $ cd ~/my_projects |
|---|
| 85 | $ django-admin startproject mysite |
|---|
| 86 | |
|---|
| 87 | |
|---|
| 88 | 2.3. Create the media and cache directories: |
|---|
| 89 | |
|---|
| 90 | $ cd mysite |
|---|
| 91 | $ mkdir media cache |
|---|
| 92 | |
|---|
| 93 | You might want to place these somewhere else... |
|---|
| 94 | |
|---|
| 95 | |
|---|
| 96 | 2.4. Configure Django (settings.py): |
|---|
| 97 | |
|---|
| 98 | Modifiy the following variables: |
|---|
| 99 | |
|---|
| 100 | DATABASE_*: your database settings (don't forget to create the database if needed) |
|---|
| 101 | MEDIA_ROOT: absolute path to the media directory you just created |
|---|
| 102 | INSTALLED_APPS: add 'telemeta' |
|---|
| 103 | |
|---|
| 104 | Add the following variables: |
|---|
| 105 | |
|---|
| 106 | TELEMETA_CACHE_DIR = absolute path to the cache directory you just created |
|---|
| 107 | |
|---|
| 108 | Just paste the two lines below: |
|---|
| 109 | TELEMETA_EXPORT_CACHE_DIR = TELEMETA_CACHE_DIR + "/export" |
|---|
| 110 | CACHE_BACKEND = "file://" + TELEMETA_CACHE_DIR + "/data" |
|---|
| 111 | |
|---|
| 112 | |
|---|
| 113 | 2.5. Initialize the database: |
|---|
| 114 | |
|---|
| 115 | $ python manage.py syncdb |
|---|
| 116 | |
|---|
| 117 | |
|---|
| 118 | 2.6. Configure your urls: |
|---|
| 119 | |
|---|
| 120 | The simplest case is to have telemeta running at public root. To do so, add |
|---|
| 121 | this url in urls.py : |
|---|
| 122 | |
|---|
| 123 | (r'^', include('telemeta.urls')), |
|---|
| 124 | |
|---|
| 125 | |
|---|
| 126 | 2.7. Start the project: |
|---|
| 127 | |
|---|
| 128 | $ python manage.py runserver |
|---|
| 129 | |
|---|
| 130 | By default, the server starts on the port 8000. |
|---|
| 131 | You can override this with, for example: |
|---|
| 132 | |
|---|
| 133 | $ python manage.py runserver 9000 |
|---|
| 134 | |
|---|
| 135 | |
|---|
| 136 | 2.8. Go the web page: |
|---|
| 137 | |
|---|
| 138 | http://localhost:8000 |
|---|
| 139 | or |
|---|
| 140 | http://localhost:9000 |
|---|
| 141 | |
|---|
| 142 | |
|---|
| 143 | See README and http://svn.parisson.org/telemeta/ for more informations. |
|---|