summaryrefslogtreecommitdiff
path: root/README
blob: c78191c297b553f4a985a73c7cb13ec356b46a8b (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
		README for GIT-COMPIZ script
=================================================================

Copyright (C) 2009 omega
Authors: see file "AUTHORS".
License: GPL v3, see file "COPYING".


A script that build/purge/install git version of:
-Compiz
-Compizconfig Settings Manager
-Compizconfig backend (Gnome-Kde3/4)
-Compiz configuration system library
-Emerald & Themes
-Translations
-Compiz option code generator
-Fusion-Icon
-Main/Extra/Unsupported/3rd Party Plugins
-OpenCV
-Unofficial compiz-fusion icons (tango/oxygen)

Changelog
=========
http://cgit.compiz-fusion.org/~omega/scripts/

Dependencies
============

build-essential libxcomposite-dev libpng12-dev libsm-dev libxrandr-dev libxdamage-dev libxinerama-dev libstartup-notification0-dev libgconf2-dev(gnome-only) libgl1-mesa-dev libglu1-mesa-dev libmetacity-dev librsvg2-dev libdbus-1-dev libdbus-glib-1-dev libgnome-desktop-dev(gnome-only) libgnome-window-settings-dev(gnome-only) gitweb curl autoconf automake automake1.9 libtool intltool libxslt1-dev xsltproc libwnck-dev python-dev libX11-xcb-dev(optional) pyrex-mode python-pyrex x11proto-scrnsaver-dev libxss-dev xorg-dev(kde-only) kde-devel(kde3-only) kde4-devel(kde4-only) protobuf-devel(optional)


Installation
============

Remove follow packages: libgnome-compiz-manager0 compiz-extra libcompizconfig0 compiz-dev compiz-gtk compiz-kde compiz-settings libcompizconfig-backend-gconf compiz-config-ini gcompizthemer compiz-plugins libgnome-compiz-manager-dev compizconfig-backend-kde compizconfig-settings-manager python-compizconfig compiz-config-gnome taskbar-compiz compizconfig-plugin compiz-freedesktop-dev compiz-fusion-plugins-unofficial compiz-bcop compiz-ccs-settings-manager libgnome-compiz-manager libcompizconfig0-dev compiztools compizconfig-settings-legacy compiz-fusion-plugins-extra compiz-compcomm-plugins-main compiz-fusion-plugins-unsupported compiz compiz-extra-plugins compiz-fusion-plugins-main libcompizconfig-backend-kconfig compiz-core compiz-decorator gnome-compiz-manager compiz-fusion-plugins-main compiz-gnome libcompizconfig-dev libgnome-compiz-manager0-dev libcompizconfig0 libcompizconfig-backend-gconf libcompizconfig0-dev libcompizconfig-backend-kconfig libcompizconfig-dev libdecoration0 compiz-wrapper

 git clone git://anongit.compiz-fusion.org/users/omega/scripts
 cd scripts
 ./git-compiz --purge
 ./git-compiz --check-dep   (you can ignore this step if you're distro isn't supported but you have installed all dependencies)
 ./git-compiz

If you want to create custom config file (that remember your personal settings):

 cp git-compiz.def git-compiz.local
 edit git-compiz.local according to your needs


If you want to see all features available with this script:

./git-compiz --help


Distro Supported/Tested
=======================

Arch-Linux,Debian,Fedora,Mandriva,Slackware,Suse,Ubuntu/Kubuntu


Note
====

- STARTUP TIME IMPROVEMENTS
Ubuntu/Debian users should install the packages libprotobuf0, libprotobuf-dev, and protobuf-compiler. 
For Ubuntu 8.10 (Intrepid) and Debian-unstable, they are available in the official repositories. 

For Ubuntu 8.04 (Hardy) can be installed after adding the following lines to /etc/apt/sources.list and doing an apt-get update:
deb http://ppa.launchpad.net/davidf/ubuntu hardy main
deb-src http://ppa.launchpad.net/davidf/ubuntu hardy main

OpenSUSE, Fedora, and Mandriva users should install the protobuf and protobuf-devel packages. If not available in the official repositories, they can be found at
http://download.opensuse.org/repositories/home:/LenzGr

Users who want to install from sources can find the latest Protocol Buffers sources at:
http://code.google.com/p/protobuf/downloads/list

- PATCHES
Convert the patches using the provided tool (scripts/convert-patch), then add them to git-compiz.local

- OPENCV (required by headtracking plugin)
 ./git-compiz --enable-opencv

- EXTRAS
extras/omega_ccsm.profile -> sample compiz profile
extras/tango_dark.emerald -> emerald theme (tango style)
extras/git-compiz.local.compiz-0.9 -> sample conf for compiz-0.9

- COMMON ISSUES
problem: /usr/bin/ld: cannot find -lGL
fix:     sudo ln -s /usr/lib/libGL.so.xxx /usr/lib/libGL.so where xxx is version driver

problem: /bin/sh: /bin/moc: No such file or directory
fix:	 sudo ln -s /usr/bin/moc /bin/moc

problem: launching ccsm/fusion-icon there are errors (example: missing module)
fix:	./git-compiz --fix-python

problem: NVIDIA: could not open the device file /dev/nvidiactl (Permission denied). 
fix:	 http://ubuntuforums.org/showpost.php?p=7201482&postcount=3

Help
====

If you have any questions/bug reports/ideas, you can find help in the following
locations:

http://forum.compiz-fusion.org/showthread.php?t=7744