6626fd208a8de3ca1fa1fdf2266361efb421e6a4
[platform/upstream/gstreamer.git] / win32 / README.txt
1 ==== Windows support ====
2
3 == Building GStreamer under Win32 ==
4
5 There are different makefiles that can be used to build GStreamer with the usual Microsoft 
6 compiling tools.
7
8 The Makefile is meant to be used with the GNU make program and the free 
9 version of the Microsoft compiler (http://msdn.microsoft.com/visualc/vctoolkit2003/). You also 
10 have to modify your system environment variables to use it from the command-line. You will also 
11 need a working Platform SDK for Windows that is available for free from Microsoft.
12
13 The projects/makefiles will generate automatically some source files needed to compile 
14 GStreamer. That requires that you have installed on your system some GNU tools and that they are 
15 available in your system PATH.
16
17 The GStreamer project depends on other libraries, namely :
18 - GLib
19 - libpopt
20 - libxml
21 - gettext
22 - libiconv
23
24 The sources should be organised in folders as follow :
25 $(PROJECT_DIR)\glib
26 $(PROJECT_DIR)\gstreamer (this package)
27 $(PROJECT_DIR)\libiconv
28 $(PROJECT_DIR)\gettext
29 $(PROJECT_DIR)\libxml2
30 $(PROJECT_DIR)\popt
31
32 NOTE : you can find Win32 versions of these libraries on http://gettext.sourceforge.net/ and
33 http://gnuwin32.sourceforge.net/ (you will need the Binaries and Developer files for each package.)
34
35 NOTE : GLib can be found on ftp://ftp.gtk.org/pub/gtk/v2.4/ and should be compiled from the 
36 sources
37
38 NOTE : GNU tools needed that you can find on http://gnuwin32.sourceforge.net/
39 - GNU flex      (tested with 2.5.4)
40 - GNU bison     (tested with 1.35)
41 and http://www.mingw.org/
42 - GNU make      (tested with 3.80)
43
44 NOTE : the generated files from the -auto makefiles will be available soon separately on the net 
45 for convenience (people who don't want to install GNU tools).
46
47 == Installation on the system ==
48
49 By default, GSTreamer needs a registry. You have to generate it using "gst-register.exe". It will create
50 the file in c:\gstreamer\registry.xml that will hold all the plugins you can use.
51
52 You should install the GSTreamer core in c:\gstreamer\bin and the plugins in c:\gstreamer\plugins.
53 For example, my current setup is :
54
55 C:\gstreamer\registry.xml
56 C:\gstreamer\bin\gst-inspect.exe
57 C:\gstreamer\bin\gst-launch.exe
58 C:\gstreamer\bin\gst-register.exe
59 C:\gstreamer\bin\gstbytestream.dll
60 C:\gstreamer\bin\gstelements.dll
61 C:\gstreamer\bin\gstoptimalscheduler.dll
62 C:\gstreamer\bin\gstspider.dll
63 C:\gstreamer\bin\iconv.dll
64 C:\gstreamer\bin\intl.dll
65 C:\gstreamer\bin\libglib-2.0-0.dll
66 C:\gstreamer\bin\libgmodule-2.0-0.dll
67 C:\gstreamer\bin\libgobject-2.0-0.dll
68 C:\gstreamer\bin\libgthread-2.0-0.dll
69 C:\gstreamer\bin\libgtreamer-0.8.dll
70 C:\gstreamer\bin\libxml2.dll
71 C:\gstreamer\bin\popt1.dll
72 C:\gstreamer\plugins\gst-libs.dll
73 C:\gstreamer\plugins\gstmatroska.dll