summaryrefslogtreecommitdiff
path: root/Installation.mdwn
blob: 47dd0e3862b75bbc22477e32692bfebc21d7633e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131


# Installation

This article describes how to install swfdec from source. Before you do this you should check and see if swfdec is available in your distribution's package manager. By using the version supplied by your distribution you will get updates and security fixes automatically. 

Which version should I use? 

* If your package manager has a current version in it, try that first. 
* If you want the latest features install from Git (recommended.) The installation instructions below describe how to install and use Git to the extent required to install swfdec. 
* If you cannot use Git for some reason then use the Source download instructions. 

## Installation from Git

These generic install instructions are derived from the Ubuntu/Kubuntu install instructions listed at [[http://revis.co.uk/site/?q=node/157|http://revis.co.uk/site/?q=node/157]] which have more detail for users of those distributions. Please note that packages names are still Debian / Ubuntu centric. 

The first step is to install Git, the distributed version control tool. 

Warning! the Git package is is not always called Git as there is another tool with the same name. The actual Git package we want is sometime called git-core. You should be able to install from your package manager. 

The second step is to grab the source from the swfdec repository: 

_git clone git://anongit.freedesktop.org/git/swfdec/swfdec_ 

_cd swfdec_ 

When you want to update in the future you can refresh your local copy with _git pull origin_ instead of deleting everything and starting from scratch. 

The third step is to make sure you have all the necessary build dependencies installed. The following packages are required and they, or packages with similar names, should be available from your package manager: 

_autoconf automake binutils gcc libasound2-dev libc6-dev libcairo2-dev libglib2.0-dev libgtk2.0-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev  libnss3-dev liboil0.3-dev libpango1.0-dev libsoup2.4-dev libtool make pkg-config_ 

If you want to use pulseaudio as audio backend add _libpulse-dev_, *BSD users needs to do so. 

Please check that you are using a recent gcc version (_gcc -v_), Git snapshots of swfdec don't compile with gcc 3.x compilers. 

Please note that since 0.7.x development series swfdec will use exclusively gstreamer as audio and video decoder. In order to have a good experience you have to install the gstreamer good and ugly plugins, called _gstreamer0.10-plugins-good_, _gstreamer0.10-plugins-ffmpeg_ and _gstreamer0.10-plugins-ugly_. 

Additionally, if you want to hack on swfdec you need to install (somewhere in PKG_CONFIG_PATH) the fairly recent libming 0.4.0beta5: [[http://sourceforge.net/project/showfiles.php?group_id=18365&package_id=187304&release_id=540333|http://sourceforge.net/project/showfiles.php?group_id=18365&package_id=187304&release_id=540333]] 

The fourth step is to create the config files with 

_./autogen.sh_ 

If you get any error messages here then it's probably because you are still missing some libraries that the application needs. If this is the case you can try your package manager for a package of a similar name with -dev on the end. 

The default configure will use ALSA as audio backend, alternatively there is a Pulse Audio backend: 

_./autogen.sh --with-audio=pulse_ 

Once the configure has completed you can build and install the package: 

_make_ 

_sudo make install_ 

The fifth step is to grab and install the mozilla plugin in your home directory. Remember to move out of swfdec directory first (_cd .._). 

_git clone git://anongit.freedesktop.org/git/swfdec/swfdec-mozilla_ 

_cd swfdec-mozilla_ 

_./autogen.sh --with-plugin-dir=$HOME/.mozilla/plugins_ 

_make_ 

_make install_ 

After installing the plugin restarting Firefox activates it. You can check to see if it has worked by typing about:plugins in the Firefox address bar. You should then see Flash registered to the swfdec plugin. 


## Installation from source tarball

As time of writing latest stable releases are swfdec 0.8.4 and swfdec-mozilla 0.8.2. 

Before you start should should make sure you have the following packages installed from your package manager or another source, debian / ubuntu names listed, yours may be a little different: 

_autoconf automake binutils gcc libasound2-dev libc6-dev libcairo2-dev libglib2.0-dev libgtk2.0-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev libnss3-dev liboil0.3-dev libpango1.0-dev libsoup2.4-dev libtool make pkg-config_ 

If you want to use pulseaudio as audio backend add _libpulse-dev_, *BSD users needs to do so. 

In order to have a good experience you have to install the gstreamer good and ugly plugins, called _gstreamer0.10-plugins-good_, _gstreamer0.10-plugins-ffmpeg_ and _gstreamer0.10-plugins-ugly_. 

You can then download the source code from the swfdec site and configure it. 

_wget [[http://swfdec.freedesktop.org/download/swfdec/0.8/swfdec-0.8.4.tar.gz|http://swfdec.freedesktop.org/download/swfdec/0.8/swfdec-0.8.4.tar.gz]]_ 

_tar xvzf swfdec-0.8.4.tar.gz_ 

_cd swfdec-0.8.4_ 

_./configure_ 

If you want the pulseaudio backend use: 

_./configure --with-audio=pulse_ 

If you get any error messages here then it's probably because you are still missing some libraries that the application needs. If this is the case you can try your package manager for a package of a similar name with -dev on the end. 

You can then make and install it... 

_make_ 

_sudo make install_ 

...before installing the plugin. 

_cd .._ 

_wget [[http://swfdec.freedesktop.org/download/swfdec-mozilla/0.8/swfdec-mozilla-0.8.2.tar.gz|http://swfdec.freedesktop.org/download/swfdec-mozilla/0.8/swfdec-mozilla-0.8.2.tar.gz]]_ 

_tar xvzf swfdec-mozilla-0.8.2.tar.gz_ 

_cd swfdec-mozilla-0.8.2_ 

_./configure --with-plugin-dir=$HOME/.mozilla/plugins_ 

_make_ 

_make install_ 

After installing the plugin restarting Firefox activates it You can check to see if it has worked by typing about:plugins in the Firefox address bar. You should then see Flash registered to the swfdec plugin. 


## Mozilla Issues Fix

Sometimes, even after you install the Mozilla plugin from the repository, it still won't work. This is because it does not recognise it as an alternative flash player. Run the following command in your Terminal to fix this *   

. Restart Firefox and voila! It should work. 

_sudo ln -sf /usr/lib/swfdec/libswfdecmozilla.so /usr/lib/mozilla/plugins/flashplugin-alternative.so_