README.md

   1 # gst-build
   2
   3 GStreamer [meson](http://mesonbuild.com/) based repositories aggregrator
   4
   5 You can build GStreamer and all its modules at once using
   6 meson and its [subproject](https://github.com/mesonbuild/meson/wiki/Subprojects) feature.
   7
   8 ## Getting started
   9
  10 ### Install meson and ninja
  11
  12 You should get meson through your package manager or using:
  13
  14   $ pip3 install --user meson
  15
  16 You should get `ninja` using your package manager or downloading it from
  17 [here](https://github.com/ninja-build/ninja/releases).
  18
  19 ### Build GStreamer and its modules
  20
  21 You can get all GStreamer built running:
  22
  23 ```
  24 mkdir build/ && meson build && ninja -C build/
  25 ```
  26
  27 NOTE: on fedora (and maybe other distributions) replace `ninja` with `ninja-build`
  28
  29 # Development environment
  30
  31 ## Uninstalled environment
  32
  33 gst-build also contains a special `uninstalled` target that lets you enter an
  34 uninstalled development environment where you will be able to work on GStreamer
  35 easily. You can get into that environment running:
  36
  37 ```
  38 ninja -C build/ uninstalled
  39 ```
  40
  41 If your operating system handles symlinks, built modules source code will be
  42 available at the root of `gst-build/` for example GStreamer core will be in
  43 `gstreamer/`. Otherwise they will be present in `subprojects/`. You can simply
  44 hack in there and to rebuild you just need to rerun `ninja -C build/`.
  45
  46 ## Update git subprojects
  47
  48 We added a special `update` target to update subprojects (it uses `git pull
  49 --rebase` meaning you should always make sure the branches you work on are
  50 following the right upstream branch, you can set it with `git branch
  51 --set-upstream-to origin/master` if you are working on `gst-build` master
  52 branch).
  53
  54 Update all GStreamer modules and rebuild:
  55
  56 ```
  57 ninja -C build/ update
  58 ```
  59
  60 Update all GStreamer modules without rebuilding:
  61
  62 ```
  63 ninja -C build/ git-update
  64 ```
  65
  66
  67 ## Add information about GStreamer development environment in your prompt line
  68
  69 ### Bash prompt
  70
  71 We automatically handle `bash` and set `$PS1` accordingly
  72
  73 ### Zsh prompt
  74
  75 In your `.zshrc`, you should add something like:
  76
  77 ```
  78 export PROMPT="$GST_ENV-$PROMPT"
  79 ```
  80
  81 ### Using powerline
  82
  83 In your powerline theme configuration file (by default in
  84 `{POWERLINE INSTALLATION DIR}/config_files/themes/shell/default.json`)
  85 you should add a new environment segment as follow:
  86
  87 ```
  88 {
  89   "function": "powerline.segments.common.env.environment",
  90   "args": { "variable": "GST_ENV" },
  91   "priority": 50
  92 },
  93 ```