Manjaro Difference between pages "Build Manjaro ISOs with buildiso" and "Compiz and Emerald"

Difference between pages "Build Manjaro ISOs with buildiso" and "Compiz and Emerald"

From Manjaro
(Difference between pages)
imported>Fhdk
 
imported>Verityproductions
 
Line 1: Line 1:
__TOC__


= Overview =


=Prerequisites=
{{warning|At present, Compiz Fusion is only compatible with the XFCE and KDE desktop environments. It will not work with Gnome / Cinnamon. It is also worth noting that if you are running Manjaro in Oracle's Virtualbox (i.e. in a virtual machine), Compiz may not work fully.}}


Before we began. You need Kernel linux44 or newer.
'''Compiz Fusion''' is a compositing manager that allows you to easily add a wide variety of fancy effects and animations to your desktop environment. Some of the more well known - and popular - examples include:


It is recommend to download the latest version of [https://sourceforge.net/projects/manjarolinux/files/?source=navbar Manjaro Distribution].
* Turning the desktop into a 3D cube, cylinder, or sphere to switch between workspaces / virtual desktops
* Wobbly and stretchy windows
* Zooming in on the desktop


'''Emerald''' is a window decorator that allows for a wide variety new looks to be added to appplication windows. It also allows for decorations to be edited or even created from scratch. For now, there are plenty of existing Emerald themes that can be downloaded and used first.


==Install manjaro-tools-iso==
Using Compiz Fusion and Emerald together can produce some genuinely stunning-looking desktop environments. However, even if you choose to download and install them together, you can still very easily choose to use just one or the other with your desktop environment at any time. For more information about Compiz Fusion and Emerald, the Compiz wiki can be found [http://wiki.compiz.org here].


To get started you need to download the following packages.


* '''manjaro-tools-base'''
<center> [[File:cube2.png]] [[File:expo.jpg]]  [[File:cylinder.png]] </center>
* '''manjaro-tools-iso'''
* '''manjaro-efi-shell'''
* '''manjaro-isolinux'''




==Install manjaro-iso-profiles==
= Install Compiz Fusion and Emerald =


You will also need to download manjaro-iso-profiles from Package Manager.
[[File: compiz_dependencies.png|thumb|left|375px]]


There are three manjaro-iso-profiles packages to choose.


* '''manjaro-iso-profiles-official'''
Although it is possible to download and install them via the ''Add/Remove Software'' application provided with Manjaro, it is actually faster and easier to use the terminal, which will be used in this tutorial.
* '''manjaro-iso-profiles-minimal'''
* '''manjaro-iso-profiles-community'''


{{Tip|pacman will automatically download dependencies, so it is not necessary to actually specify ALL the packages we need. For example, asking pacman to download and install Emerald's themes will automatically result in downloading Emerald itself, if not already installed. This is because Emerald is a dependency of the themes.}}


You can choose any profiles you want.
As illustrated, entering the command to install both Compiz Fusion and Emerald together for XFCE has resulted in pacman automatically pulling a few extra packages as dependencies of the ones specified (i.e. seven packages have been listed, but eleven are being downloaded in this instance).


We're going to choose <code>manjaro-iso-profiles-official</code> along with XFCE to help you understand what you need to do.
Once installed, it will not be necessary to reboot your machine; you can start setting them up straight away!
<br clear="all" />




We do not recommend downloading profiles from GitHub. It may not work for you while building. But, if it does work for you. That's fine.


== Installation for XFCE ==


=Name your own Manjaro Distribution=
* To install only Compiz Fusion:
 
Open Thunar Root and go to this file
 
/usr/share/manjaro-tools/isolinux/gfxboot.cfg
 
Find '''product=Manjaro Linux''' and change from '''Manjaro Linux''' to whatever you want to name it.
 
===Example:===
 
; Sections are read in the order given in base::layout, with section 'base'
; implicitly added at the end. If a config value is given more than once,
; the first entry wins.
;
; If a screen resolution can't be set, 640x480 is used as fallback (and
; section '640x480' added to the layout list).
;
; Setting livecd=1 implicitly adds section 'live' to the layout list.
;
; Color values: 24 bit RGB (e.g. 0xff0000 = red).
;
[base]
; theme name
theme=artwork-gfxboot
; product name
product='''NAME YOUR MANJARO DISTRIBUTION HERE'''
; other sections to read
layout=800x600,live,install
; sound volume (0..100)
volume=70
; menu background transparency (0..255)
menu.transparency=0x0
; default font
font.normal=16x16.fnt
; main menu font
font.large=16x16.fnt
; max. visible main menu items
mainmenu.entries=8
; minimal main menu selection bar width
mainmenu.bar.minwidth=300
; main menu selection bar transparency (0..255)
mainmenu.bar.transparency=0
; main menu colors
mainmenu.bar.color=0xffffff
mainmenu.normal.fg=0xffffff
mainmenu.selected.fg=0x000000
; boot option colors
bootopt.label.fg=0xffffff
bootopt.text.fg=0xffffff
; progress bar color
progress.bar.color=0x295202
; menu colors
menu.normal.bg=0xd8deed
menu.normal.fg=0x000000
menu.normal.alt.fg=0x606060
menu.selected.bg=0x6c6c6c
menu.selected.fg=0xffffff
; window colors
window.bg=0xd8deed
window.fg=0x000000
window.title.bg=0x217b05
window.title.fg=0xffffff
window.title.error.bg=0xc00000
; help system colors
help.link.fg=0x0000a0
help.link.selected.fg=0xffffff
help.link.selected.bg=0x0000a0
help.highlight.fg=0x009000
; panel colors
panel.fg=0xffffff
panel.title.fg=0xffffff
panel.f-key.fg=0xffe050
; default keymap (e.g. de-latin1-nodeadkeys or cz-lat2-us)
keymap=
; replace underscores ('_') with space in menu entries
_2space=1
[800x600]
; screen size
screen.size=800,600
; background image
background=back800x600.jpg
; upper left corner, if x = -1, center horizontally
mainmenu.pos=-1,240
; boot option input field position
bootopt.pos=263,480
[640x480]
; screen size
screen.size=640,480
; background image
background=back640x480.jpg
; upper left corner, if x = -1, center horizontally
mainmenu.pos=-1,170
; boot option input field position
bootopt.pos=263,380
[live]
; show welcome animation
welcome=1
; set livecd flag
livecd=1
; main menu items where user can't add boot options
nobootoptions=hdt,memtest
; move down one menu entry the first time an F-key is used
autodown=0
; F-key assignments, see install section for doc
; serial line setup (up to four lines)
; format: port,baud,dev
;  - port: 0-3: first four BIOS serial lines (COM1-COM4); >=4: I/O port (0x3f8)
;  - baud: baud rate (e.g. 115200); 0 = autodetect (considers baud rates >= 9600)
;  - dev: linux device name (e.g. ttyS0)
; - all lines are set up with 8 bits, no parity, 1 stop bit
; - if the bootloader also has a serial line setup, the port is
;  automatically used
serial.line0=0,0,ttyS0
serial.line1=1,0,ttyS1
serial.line2=
serial.line3=
key.F2=lang
key.F3=video
key.F4=kernelopts
key.F5=
key.F6=
key.F7=
key.F8=
key.F11=
key.F12=
; show keymap menu as submenu in lang dialog
keymap.submenu=1
; add 'keytable' option with current keymap
addopt.keytable=1
; add 'lang' option with current locale
addopt.lang=1
; add 'layout' option with current keyboad layout
addopt.layout=1
   
   
sudo pacman -S ccsm compiz-core fusion-icon compiz-fusion-plugins-extra libcompizconfig compiz-manager


* To install only Emerald:


=ISO profile=
  sudo pacman -S emerald-themes
 
 
==ISO profile overview==
 
Open Thunar Root and go to this directory.
 
  /usr/share/manjaro-tools/iso-profiles/manjaro/xfce
 
Let's take a closer look at the XFCE profile folder (marked above):
 
~ >>> ls -lAgo /usr/share/manjaro-tools/iso-profiles/manjaro/xfce
drwxr-xr-x 3 4096 16 feb 19:52 '''desktop-overlay'''
lrwxr-xr-x 1  33 16 feb 19:52 live-overlay -> ../../shared/manjaro/live-overlay
lrwxr-xr-x 1  28 16 feb 19:52 mkinitcpio.conf -> ../../shared/mkinitcpio.conf
-rw-r--r-- 1 5115 16 feb 19:52 '''Packages-Desktop'''
lrwxr-xr-x 1  26 16 feb 19:52 Packages-Live -> ../../shared/Packages-Live
lrwxr-xr-x 1  26 16 feb 19:52 Packages-Mhwd -> ../../shared/Packages-Mhwd
lrwxr-xr-x 1  26 16 feb 19:52 Packages-Root -> ../../shared/Packages-Root
-rw-r--r-- 1 2400 16 feb 19:52 '''profile.conf'''
 
* '''desktop-overlay''': After every successful installation of your ISO the files and folders in here will get copied over.
* ''live-overlay'': Similar to ''desktop-overlay''. Files and folders in here will only get copied over to the LiveCD of your ISO.
* ''mkinitcpio.conf'' holds the information of all needed kernel modules.
* '''Packages-Desktop''': This file contains packages for the ISO installation. All packages will also get installed on LiveCDs.
* ''Packages-Live'': This file contains packages, which will only get installed on the LiveCD.
* ''Packages-Mhwd'': This file contains Mhwd packages important to all Manjaro installations and LiveCDs.
* ''Packages-Root'': This file contains base packages important to all Manjaro installations and LiveCDs.
* '''profile.conf''' contains basic settings for your ISO installation and LiveCD.
 
As you have probably noticed, all files and folders are readonly and several are only symlinks to the <code>shared</code> ISO profile. It is good practice to never change files or folders in the <code>shared</code> ISO profile. If you ever want to change them, first copy them to your ISO profile folder and delete the symlink.
 
All folders and files specific to your ISO are '''in bold'''. You can change them to your liking.
 
==Modifying an ISO profile==
 
The most common places to tweak and customize an ISO profile are the 3 folders marked above: ''xfce-overlay'', ''profile.conf'', ''Packages-Xfce'':
 
 
===desktop-overlay===
 
The ''desktop-overlay'' folder looks like this:
 
~ >>> tree /usr/share/manjaro-tools/iso-profiles/manjaro/xfce/desktop-overlay/etc                                         
/usr/share/manjaro-tools/iso-profiles/manjaro/xfce/desktop-overlay/etc
├── fonts
│   └── conf.d
│      └── 70-no-bitmaps.conf -> /etc/fonts/conf.avail/70-no-bitmaps.conf
└── lightdm
    └── lightdm-gtk-greeter.conf
 
3 directories, 2 files
 
Go to this directory.
 
/usr/share/manjaro-tools/iso-profiles/manjaro/xfce/desktop-overlay/etc/
 
Then create '''skel''' folder. This is where you can clone everything you see on your Desktop Screen to ISO.
 
After the ISO has been successfully installed all files and folder in ''desktop-overlay'' folder get copied over to the installed system. This includes settings/config files but also themes and backgrounds/pictures.
 
All files and folder in here will get copied to the home folder. Most hidden files and their structure in <code>/usr/share/manjaro-tools/iso-profiles/manjaro/xfce/desktop-overlay/etc/skel/</code> should be already familiar to you, because your home folder looks very similar.
 
===Clone Custom Wallpaper Desktop===
 
To clone your Custom Wallpaper Desktop. Open a New File Manager and go to this file.
 
/home/<username>/.config/xfce4/xfconf/xfce-perchannel-xml/xfce4-desktop.xml
 
Change all image directories to where your Custom Wallpaper was located at.
 
/usr/share/backgrounds/<YOUR IMAGE HERE>
 
===Example===
 
<?xml version="1.0" encoding="UTF-8"?>
<channel name="xfce4-desktop" version="1.0">
  <property name="backdrop" type="empty">
    <property name="screen0" type="empty">
      <property name="monitor0" type="empty">
        <property name="image-path" type="string" value="'''/usr/share/backgrounds/<YOUR IMAGE HERE>'''"/>
        <property name="last-image" type="string" value="'''/usr/share/backgrounds/<YOUR IMAGE HERE>'''"/>
        <property name="last-single-image" type="string" value="'''/usr/share/backgrounds/<YOUR IMAGE HERE>'''"/>
        <property name="image-style" type="int" value="5"/>
      </property>
      <property name="monitorVGA-0" type="empty">
        <property name="workspace0" type="empty">
          <property name="color-style" type="int" value="0"/>
          <property name="image-style" type="int" value="5"/>
          <property name="last-image" type="string" value="'''/usr/share/backgrounds/<YOUR IMAGE HERE>'''"/>
        </property>
        <property name="workspace1" type="empty">
          <property name="color-style" type="int" value="0"/>
          <property name="image-style" type="int" value="5"/>
          <property name="last-image" type="string" value="'''/usr/share/backgrounds/<YOUR IMAGE HERE>'''"/>
        </property>
      </property>
    </property>
  </property>
  <property name="desktop-icons" type="empty">
    <property name="style" type="int" value="2"/>
    <property name="file-icons" type="empty">
      <property name="show-removable" type="bool" value="true"/>
    </property>
    <property name="icon-size" type="uint" value="32"/>
  </property>
</channel>
 
Go to this directory in Thunar Root.
 
/usr/share/manjaro-tools/iso-profiles/manjaro/xfce/desktop-overlay/
 
Then create <code>usr/share/backgrounds</code> and place your Custom Wallpaper at this directory.
 
/usr/share/manjaro-tools/iso-profiles/manjaro/xfce/desktop-overlay/usr/share/backgrounds/
 
===profile.conf===
 
##########################################
###### use this file in the profile ######
##########################################
# use multilib packages; x86_64 only
# multilib="true"
displaymanager="lightdm"
# Set to false to disable autologin in the livecd
# autologin="true"
# nonfree mhwd drivers
# nonfree_mhwd="true"
# use plymouth; initcpio hook
# plymouth_boot="true"
# use pxe boot; initcpio hook
pxe_boot="false"
# use core packages as defined in pkglist to use in basic profile
# basic="false"
# use extra packages as defined in pkglist to activate a full profile
extra="true"
################ install ################
# unset defaults to given value
# efi_boot_loader="grub"
# configure calamares for netinstall
# netinstall="false"
# the default url for the netinstall.yaml
# netgroups="https://raw.githubusercontent.com/manjaro/iso-profiles/master/shared/netgroups"
# configure calamares to use chrootcfg instead of unpackfs
# chrootcfg="false"
# use geoip for localization
# geoip='true'
# unset defaults to given value
# plymouth_theme=manjaro-elegant
# unset defaults to given values
# names must match systemd service names
enable_systemd=('avahi-daemon' 'bluetooth' 'cronie' 'ModemManager' 'NetworkManager' 'org.cups.cupsd' 'tlp' 'tlp-sleep')
disable_systemd=('pacman-init')
# unset defaults to given values,
# names must match openrc service names
# enable_openrc=('acpid' 'bluetooth' 'cgmanager' 'consolekit' 'cronie' 'cupsd' 'dbus' 'syslog-ng' 'NetworkManager')
# disable_openrc=()
# the same workgroup name if samba is used
# smb_workgroup=""
################# livecd #################
# unset defaults to given value
# hostname="manjaro"
# unset defaults to given value
# username="manjaro"
# unset defaults to given value
# password="manjaro"
# the login shell
# defaults to bash
# login_shell=/bin/bash
# unset defaults to given values
# addgroups="video,audio,power,disk,storage,optical,network,lp,scanner,wheel"
# unset defaults to given values
# names must match systemd service names
# services in enable_systemd array don't need to be listed here
# enable_systemd_live=('manjaro-live' 'mhwd-live' 'pacman-init' 'mirrors-live')
# unset defaults to given values,
# names must match openrc service names
# services in enable_openrc array don't need to be listed here
# enable_openrc_live=('manjaro-live' 'mhwd-live' 'pacman-init' 'mirrors-live')
 
 
This config file contains setting options. All default settings are commented. If you want to change them, uncomment them (remove the <code>#</code> symbol in front) and change it.
 
The following settings are noteworthy:
 
* <code>initsys=</code> lets you choose between systemd and OpenRC. This setting is associated with the <code>>systemd</code> and <code>>openrc</code> flags in your package lists.
* <code>multilib=</code> setting belongs to the <code>>multilib</code> flag in your package lists. multilib will install basic 32bit libraries on 64bit systems. This increases compatibility for 32bit applications on 64bit systems.
* <code>displaymanager=</code> sets the display / login manager your system uses. You need to list your display manager in your package list, too.
* <code>nonfree_xorg=</code> refers to proprietary graphics drivers.
* <code>plymouth_boot=</code> lets you activate Plymouth (the graphics displayed during boot). Do not forget the <code> playmouth</code>  package in your package list.
* <code>pxe_boot=</code> activates PXE boot on your system.
* <code>kernel=</code> lets you set the installed kernel. Do '''not''' include any kernels in your package list! This setting is all you need.
* <code>start_systemd=</code> let's you set systemd services, which get started on the installed system and on the livecd. A similar setting is available for OpenRC.
 
===Packages-Desktop===
 
<pre>
## Network
>systemd avahi
>openrc avahi-openrc
>systemd networkmanager
>openrc networkmanager-openrc
>openrc networkmanager-consolekit
networkmanager-openconnect
networkmanager-openvpn
networkmanager-pptp
networkmanager-vpnc
networkmanager-dispatcher-ntpd
nss-mdns # NSS support for mDNS (optdepend for avahi)
>systemd ntp
>openrc ntp-openrc
mobile-broadband-provider-info
modemmanager
>systemd openresolv
>systemd openssh
>openrc openssh-openrc
samba
 
## Libraries for Sound/Audio/Video
alsa-firmware
>systemd alsa-utils
>openrc alsa-utils-openrc
ffmpeg
gst-libav
gst-plugins-bad
gst-plugins-base
gst-plugins-good
gst-plugins-ugly
libdvdcss
>multilib manjaro-alsa
>systemd manjaro-pulse
>systemd pulseaudio-bluetooth
>systemd pulseaudio-ctl
>systemd pulseaudio-zeroconf
 
## Connect Packages
android-tools
android-udev
gvfs
gvfs-afc
gvfs-gphoto2
gvfs-mtp
gvfs-nfs
gvfs-smb
mtpfs
udiskie
udisks2
 
## AUR Support/Development
# Missing base-devel packages
autoconf
automake
binutils
bison
fakeroot
flex
gcc
>multilib gcc-multilib
libtool
m4
make
patch
pkg-config
>multilib lib32-flex
# Extra packages for AUR support
>extra git
>extra patchutils
>extra subversion
yaourt
 
## Fonts
cantarell-fonts
# noto-fonts              # default font
# noto-fonts-cjk        # big package, ~76 mb compressed
# >extra noto-fonts-emoji
>extra terminus-font
>extra ttf-bitstream-vera
# ttf-dejavu            # Installed as gnome-themes-standard dependency
>extra ttf-inconsolata
>extra ttf-indic-otf
>extra ttf-liberation
>extra ttf-droid
 
## Games
>extra steam-manjaro
 
## Package management
pamac
 
## Java
>extra jdk8-openjdk
>extra jre8-openjdk-headless
>extra jre8-openjdk
 
## Printing
>extra cups
>extra cups-pdf
>extra cups-pk-helper
>extra ghostscript
>extra gsfonts
>extra hplip
>extra splix
 
## Optional dependencies for hplip
>extra pyqt5-common # For hplip
>extra python-pillow # For hplip
>extra python-pip # For hplip
>extra python-pyqt5  # For hplip gui
>extra python-reportlab # For hplip
 
## Display manager
lightdm
lightdm-gtk-greeter
lightdm-gtk-greeter-settings
accountsservice  # Enhanced user accounts handling
 
## XFCE Group
exo
garcon
gtk-xfce-engine
thunar
thunar-volman
tumbler
xfce4-appfinder
xfce4-panel
xfce4-power-manager
xfce4-session
xfce4-settings
xfce4-terminal
xfconf
xfdesktop
xfwm4
xfwm4-themes
 
## XFCE Extras
blueman
ffmpegthumbnailer  # tumbler - for video thumbnails
freetype2          # tumbler - for font thumbnails
gconf              # fix qt-theme
gksu
gnome-keyring      # fix wlan segfault
libgsf            # tumbler - for ODF thumbnails
libopenraw        # tumbler - for RAW thumbnails
light-locker
network-manager-applet
menulibre
orage
poppler-glib      # tumbler - for PDF thumbnails
thunar-archive-plugin
thunar-media-tags-plugin
# >extra xfce4-artwork
xfce4-battery-plugin
xfce4-clipman-plugin
>extra xfce4-cpufreq-plugin
>extra xfce4-cpugraph-plugin
# xfce4-datetime-plugin
>extra xfce4-dict
>extra xfce4-diskperf-plugin
>extra xfce4-fsguard-plugin
>extra xfce4-genmon-plugin
>extra xfce4-mailwatch-plugin
>extra xfce4-mount-plugin
>extra xfce4-mpc-plugin
>extra xfce4-netload-plugin
>extra xfce4-notes-plugin
xfce4-notifyd
xfce4-screenshooter
>extra xfce4-sensors-plugin
>extra xfce4-smartbookmark-plugin
>extra xfce4-systemload-plugin
xfce4-taskmanager
>extra xfce4-time-out-plugin
>extra xfce4-timer-plugin
>extra xfce4-verve-plugin
>extra xfce4-wavelan-plugin
>extra xfce4-weather-plugin
xfce4-whiskermenu-plugin
xfce4-xkb-plugin
>systemd pa-applet
>systemd pavucontrol
 
## Themes QT/GTK/SDDM
>extra manjaro-backgrounds
gnome-icon-theme
gnome-themes-standard
gtk-theme-breath
>systemd plymouth-legacy
>systemd plymouth-theme-manjaro-elegant
xcursor-simpleandsoft
xcursor-vanilla-dmz-aa
 
## Applications
>extra catfish
dmidecode # optional dependency inxi
engrampa
engrampa-thunar-plugin
>extra firefox
>extra flashplugin
>extra galculator-gtk2
>extra gimp
gparted
gufw
>extra guayadeque
>extra hexchat
htop
qpdfview
>extra qpdfview-djvu-plugin
>extra qpdfview-ps-plugin
inxi
>extra libreoffice-still
manjaro-hello
manjaro-settings-manager
manjaro-settings-manager-notifier
>basic midori
>extra mlocate
mousepad
mugshot
parole # media player
>extra pidgin
powertop
>extra poppler-data  # CKJ support for pdf
>basic sylpheed # mail client
>extra thunderbird
# vlc-nightly
>extra viewnior
>extra xfburn
>extra yelp
 
# Optional dependencies engrampa
p7zip  # 7Z and ARJ archive support
unace  # ACE archive support
unrar  # RAR archive support
 
## Documentation
manjaro-documentation
 
## Settings packages
>extra manjaro-xfce-settings
>basic manjaro-xfce-minimal-settings
manjaro-browser-settings
 
## Xorg Input Drivers
xf86-input-elographics
xf86-input-evdev
xf86-input-keyboard
xf86-input-libinput
xf86-input-mouse
xf86-input-void
 
## Xorg Server and Graphics
numlockx
mesa-demos
>multilib lib32-mesa-demos
xorg-server
xorg-server-utils
xorg-twm
xorg-utils
xorg-xinit
xorg-xkill
 
## Desktop Utils
perl-file-mimeinfo
xdg-user-dirs
xdg-utils
xdg-su
 
## Misc
>openrc consolekit-openrc
>openrc displaymanager-openrc
>openrc pm-utils
>openrc cgmanager-openrc
manjaro-hotfixes
</pre>
 
This file contains a list of packages, which will get installed on your installed ISO (XFCE) and the LiveCD. This is a package list with Xfce specific packages (and packages you like to add to your custom Manjaro ISO) of multiple package lists in your ISO profile. The other package lists are more generic.
 
You can add or remove package names from this list as you like. You do not need to worry about dependencies when adding package names, just make sure the package name is spelled correctly and the package is available in the Manjaro repositories.
 
<code>#</code> marks a comment. The rest of the line after the <code>#</code> symbol gets ignored.
 
<code>>i686</code> is a flag and marks a package, which will only get installed on the 32bit version of your ISO (XFCE).
 
<code>>x86_64</code> marks a package, which will only get installed on the 64bit version of your ISO (XFCE).
 
===Adding AUR packages===
 
If you want to add AUR packages to your ISO, you need to create a online repository and add it to the right <code>pacman-XXXXX.conf</code> file in <code>/usr/share/manjaro-tools/</code>


[https://wiki.manjaro.org/index.php?title=Buildiso_with_AUR_packages:_Using_buildpkg Buildiso with AUR packages: Using buildpkg]
* To install both Compiz Fusion and Emerald together:


=manjaro-tools.conf=
sudo pacman -S ccsm compiz-core fusion-icon emerald-themes compiz-fusion-plugins-extra libcompizconfig compiz-manager


<code>manjaro-tools.conf</code> is the central configuration file for all tools part of ''manjaro-tools''. Only edit the general and the "buildiso" part to not exceed the scope of this tutorial. If you are not sure what and how to edit it, do '''not''' edit it. You can always use arguments with the <code>buildiso</code> command later.


By default, the systemwide config file is installed in
== Installation for KDE ==


/etc/manjaro-tools/manjaro-tools.conf
* To install only Compiz Fusion:


Additionally, a userconfig <code>manjaro-tools.conf</code> file can be placed in your home directory here:
sudo pacman -S ccsm compiz-core fusion-icon compiz-fusion-plugins-extra libcompizconfig compiz-manager compiz-decorator-kde


~/.config/manjaro-tools/manjaro-tools.conf
* To install only Emerald:


If the userconfig is present, ''manjaro-tools''/''buildiso'' will load the userconfig values, however, if variables have been set in the systemwide config file, these values take precedence over the userconfig. Best practice is to leave the systemwide file untouched. By default it is commented and shows just initialization values done in code.
sudo pacman -S emerald-themes


* To install both Compiz Fusion and Emerald together:


=Build your ISO=
sudo pacman -S ccsm compiz-core fusion-icon emerald-themes compiz-fusion-plugins-extra libcompizconfig compiz-manager compiz-decorator-kde


Open Terminal and enter this command to Root Terminal.


su
= Set up Compiz Fusion and Emerald =


Navigate to <code>manjaro-tools</code> folder:
== Compiz Fusion ==


cd /usr/share/manjaro-tools/
This guide will provide you with the very basics to get up and running with Compiz Fusion. This includes setting it up as your default windows manager so that it will automatically activate upon starting your desktop, rather than having to manually start it each time.


There are many Compiz tutorials available on the 'net, including video tutorials on websites such as Youtube.


Build your ISO with the following command:
=== The Compiz Configuration Settings Manager (ccsm) ===


buildiso -p xfce


You need to specify the name of your ISO profile after the <code>-p</code> argument. In this case, it is <code>xfce</code>.
[[File: ccsm.png|thumb|left|375px]]


If the build process fails with an error, start it again.


Attention: The build process needs at least 10 minutes to complete or much longer when you are using HDDs, slow CPUs, or large ISOs.
This is where you can activate and tweak any and all of the special effects and animations you want. Although they are quite easy and straightforward to set up, there are a wide variety of options available, and an even wider variety of tweaks that can be done to them.  


{{tip| It is worthwhile taking your time to explore what's available - you may end up being pleasantly surprised!}}


When the build process finishes successfully, the ISO file and the package list will appear in this folder:
As illustrated, the Compiz Configuration Settings Manager itself can be found in the ''Settings'' section of your desktop menu. Alternatively, typing ''ccsm'' in XFCE's ''Application Finder'' or KDE's built-in search bar will also bring it up.
<br clear="all" />


/var/cache/manjaro-tools/iso/
=== A note about 3D Cubes, Cylinders, and Spheres ===


{{tip| To activate this feature fully, you must enable Desktop Cube, Rotate Cube, and 3D windows in the Compiz Configuration Manager.}}


===Example:===
You can use arguments with the <code>buildiso</code> command for more build options:


buildiso -p xfce -a i686 -b stable
[[File:workspaces.png|thumb|left|375px]]


* <code>-a</code> let's you build for other architectures. Here, it builds a 32bit ISO image on a 64bit host system. You can also set this in your <code>manjaro-tools.conf</code> file.
* <code>-b</code> let's you specify the branch. You can also set this in your <code>manjaro-tools.conf</code> file.


You can find other examples of builds using different arguments for ''buildiso'' [https://wiki.manjaro.org/index.php?title=Manjaro-tools#buildiso here].
There are two '''very important''' things to know if you want to access this feature:


'''1. Make sure you have enough workspaces / virtual desktops to form the 3D shape(s) you want'''. For the cube and sphere, you should have at least four workspaces  - try them with less and see what happens! For the cylinder, you should have at least three workspaces.


=Cleaning your hard drive=
'''2. The number of workspaces set in the Compiz Configuration Manager <u>MUST</u> match the number of workspaces set in your XFCE or KDE desktop'''. For example, as illustrated, if you set three workspaces in Compiz, you must also set three workspaces in your desktop environment, and vice-versa. If there is a mismatch, applications placed on different workspaces may seem to disappear and/or there may be problems switching between the workspaces themselves.


After a successful or failed build, you can get rid of most data (the "raw" ISO with all downloaded packages) by deleting this folder:
The workspace settings of your desktop can be found in the ''Settings'' section of your desktop menu. Alternatively, typing ''workspace'' in XFCE's ''Application Finder'' or KDE's built-in search bar will also bring it up.
<br clear="all" />


sudo rm -r /var/lib/manjaro-tools/buildiso/xfce/
[[File:ccsmworkspaces.png|thumb|left|375px]]




To clean your system of packages files of packages not installed on your system (this includes all the package files downloaded for your custom ISO):
The workspace settings of the Compiz Configuration Manager can be found by first going to ''General Options'', and then selecting the ''Desktop Size'' tab.


paccache -ruk0
As illustrated, the horizontal virtual size setting is 3. This means that there are three virtual desktops sitting side by side (i.e. horizontally). This matches both the number and position of the three virtual desktops set in the XFCE desktop, as shown in the taskbar at the bottom of the screen. '''You can click on the image to enlarge it''' to see this; there are three squares representing the workspaces sitting side by side (i.e. horizontally) adjacent the time.


The remaining two options can just be set to 1, as they will multiply the number of desktops (e.g. if the vertical desktop size was also set to 2, then the total number of desktops would be 6 in this instance: 3 * 2 = 6)


You can also manually look into
<br clear="all" />


/var/cache/manjaro-tools/
=== A Note about Key Bindings ===


and delete folders or files to your liking. If you want to delete all ISO images, package lists, and cached Xorg packages do:


sudo rm -r /var/cache/manjaro-tools/
[[file:keybindings.png|thumb|left|375px]]




Please remember that all these packages and files are saved for your convenience. If you clean your system like suggested above, you have to download '''all''' packages and build '''all''' images again the next time you want to build your own Manjaro ISO.
''Key Bindings'' are also a very important element of Compiz. In fact, they will literally affect the way you use and enjoy the features provided. In essence, they are used to determine how certain effects are activated, such as by pressing certain keys together or by placing the mouse at a certain edge or corner of the screen.  


{{tip| Many features will automatically activate, even if key bindings are listed for them. For example, the ability to have your application windows stretch like elastic will happen automatically when resizing them (if activated!), even though key bindings are listed to do so. It is also worth noting that not all key bindings need your attention; many can be ignored.}}


=Further Reading=
For example, as illustrated, the ''initiate'' key binding to activate the ability to turn the desktop into a cube/cylinder/sphere and rotate it has been changed. Whereas before a certain combination of keys had to be pressed, now all that needs to be done is to click in the top-right corner of the screen. The cube/cylinder/sphere can be rotated by just holding down the mouse button and moving the mouse. '''Only this key binding needs to be looked at. All the rest can be completely ignored!'''


There is a dedicated forum subsection about Manjaro-Tools and ''buildiso'':
<br clear="all" />


* [https://forum.manjaro.org/index.php?board=52.0 Support for Manjaro-Tools]
=== Using the Compiz Fusion Icon to Start Compiz Automatically ===


[[file: fusionmenu.png|thumb|left|375px]]


Here are some more tutorials of ''manjaro-tools'' and ''buildiso'':


* [https://github.com/manjaro/manjaro-tools manjaro-tools on GitHub] (always up to date)
Once you have set the effects and animations you want in the Compiz Configuration Manager, they are activated through the Compiz Fusion Icon. This can be found in the ''System'' section of your desktop menu. Alternatively, typing ''fusion'' in XFCE's ''Application Finder'' or KDE's built-in search bar will also bring it up.
* [[Manjaro-tools]] (outdated)
* [https://forum.manjaro.org/t/how-to-create-your-own-manjaro-spin-with-manjaro-tools/1355 How to create your own Manjaro spin with Manjaro-Tools?]
* [https://www.youtube.com/watch?v=9BxqN326G6o Building Manjaro by Spatry (Tutorial Video)]
* [https://forum.manjaro.org/index.php?topic=21976.0 simple buildiso tutorial] (outdated)
* [https://forum.manjaro.org/index.php?topic=20167.0 How to use Manjaro-Tools] (outdated)
* [[Buildiso with AUR packages: Using buildpkg]] (outdated)
* [[Buildiso with AUR packages: Using yaourt]] (outdated)


Once selected, your screen will momentarily flicker as Compiz is activated, and the red and black Fusion icon itself will appear in your desktop's taskbar.
<br clear="all" />


It is also possible to ask questions on IRC:  
[[file: fusionicon.png|thumb|left|375px]]
* Server: <code>irc.freenode.net</code>
<br clear="all" />
* Channel: <code>#manjaro</code>


== Emerald ==


=== The Emerald Theme Manager ===


[[Category:Contents Page]]
=== Making Emerald your Window Decorator ===

Revision as of 21:48, 27 September 2012

Overview

Warning
At present, Compiz Fusion is only compatible with the XFCE and KDE desktop environments. It will not work with Gnome / Cinnamon. It is also worth noting that if you are running Manjaro in Oracle's Virtualbox (i.e. in a virtual machine), Compiz may not work fully.

Compiz Fusion is a compositing manager that allows you to easily add a wide variety of fancy effects and animations to your desktop environment. Some of the more well known - and popular - examples include:

  • Turning the desktop into a 3D cube, cylinder, or sphere to switch between workspaces / virtual desktops
  • Wobbly and stretchy windows
  • Zooming in on the desktop

Emerald is a window decorator that allows for a wide variety new looks to be added to appplication windows. It also allows for decorations to be edited or even created from scratch. For now, there are plenty of existing Emerald themes that can be downloaded and used first.

Using Compiz Fusion and Emerald together can produce some genuinely stunning-looking desktop environments. However, even if you choose to download and install them together, you can still very easily choose to use just one or the other with your desktop environment at any time. For more information about Compiz Fusion and Emerald, the Compiz wiki can be found here.


File:Cube2.png File:Expo.jpg File:Cylinder.png


Install Compiz Fusion and Emerald


Although it is possible to download and install them via the Add/Remove Software application provided with Manjaro, it is actually faster and easier to use the terminal, which will be used in this tutorial.



Tip
pacman will automatically download dependencies, so it is not necessary to actually specify ALL the packages we need. For example, asking pacman to download and install Emerald's themes will automatically result in downloading Emerald itself, if not already installed. This is because Emerald is a dependency of the themes.

As illustrated, entering the command to install both Compiz Fusion and Emerald together for XFCE has resulted in pacman automatically pulling a few extra packages as dependencies of the ones specified (i.e. seven packages have been listed, but eleven are being downloaded in this instance).

Once installed, it will not be necessary to reboot your machine; you can start setting them up straight away!


Installation for XFCE

  • To install only Compiz Fusion:
sudo pacman -S ccsm compiz-core fusion-icon compiz-fusion-plugins-extra libcompizconfig compiz-manager
  • To install only Emerald:
sudo pacman -S emerald-themes
  • To install both Compiz Fusion and Emerald together:
sudo pacman -S ccsm compiz-core fusion-icon emerald-themes compiz-fusion-plugins-extra libcompizconfig compiz-manager


Installation for KDE

  • To install only Compiz Fusion:
sudo pacman -S ccsm compiz-core fusion-icon compiz-fusion-plugins-extra libcompizconfig compiz-manager compiz-decorator-kde
  • To install only Emerald:
sudo pacman -S emerald-themes
  • To install both Compiz Fusion and Emerald together:
sudo pacman -S ccsm compiz-core fusion-icon emerald-themes compiz-fusion-plugins-extra libcompizconfig compiz-manager compiz-decorator-kde


Set up Compiz Fusion and Emerald

Compiz Fusion

This guide will provide you with the very basics to get up and running with Compiz Fusion. This includes setting it up as your default windows manager so that it will automatically activate upon starting your desktop, rather than having to manually start it each time.

There are many Compiz tutorials available on the 'net, including video tutorials on websites such as Youtube.

The Compiz Configuration Settings Manager (ccsm)


This is where you can activate and tweak any and all of the special effects and animations you want. Although they are quite easy and straightforward to set up, there are a wide variety of options available, and an even wider variety of tweaks that can be done to them.



Tip
It is worthwhile taking your time to explore what's available - you may end up being pleasantly surprised!

As illustrated, the Compiz Configuration Settings Manager itself can be found in the Settings section of your desktop menu. Alternatively, typing ccsm in XFCE's Application Finder or KDE's built-in search bar will also bring it up.

A note about 3D Cubes, Cylinders, and Spheres

Tip
To activate this feature fully, you must enable Desktop Cube, Rotate Cube, and 3D windows in the Compiz Configuration Manager.



There are two very important things to know if you want to access this feature:

1. Make sure you have enough workspaces / virtual desktops to form the 3D shape(s) you want. For the cube and sphere, you should have at least four workspaces - try them with less and see what happens! For the cylinder, you should have at least three workspaces.

2. The number of workspaces set in the Compiz Configuration Manager MUST match the number of workspaces set in your XFCE or KDE desktop. For example, as illustrated, if you set three workspaces in Compiz, you must also set three workspaces in your desktop environment, and vice-versa. If there is a mismatch, applications placed on different workspaces may seem to disappear and/or there may be problems switching between the workspaces themselves.

The workspace settings of your desktop can be found in the Settings section of your desktop menu. Alternatively, typing workspace in XFCE's Application Finder or KDE's built-in search bar will also bring it up.


The workspace settings of the Compiz Configuration Manager can be found by first going to General Options, and then selecting the Desktop Size tab.

As illustrated, the horizontal virtual size setting is 3. This means that there are three virtual desktops sitting side by side (i.e. horizontally). This matches both the number and position of the three virtual desktops set in the XFCE desktop, as shown in the taskbar at the bottom of the screen. You can click on the image to enlarge it to see this; there are three squares representing the workspaces sitting side by side (i.e. horizontally) adjacent the time.

The remaining two options can just be set to 1, as they will multiply the number of desktops (e.g. if the vertical desktop size was also set to 2, then the total number of desktops would be 6 in this instance: 3 * 2 = 6)


A Note about Key Bindings


Key Bindings are also a very important element of Compiz. In fact, they will literally affect the way you use and enjoy the features provided. In essence, they are used to determine how certain effects are activated, such as by pressing certain keys together or by placing the mouse at a certain edge or corner of the screen.



Tip
Many features will automatically activate, even if key bindings are listed for them. For example, the ability to have your application windows stretch like elastic will happen automatically when resizing them (if activated!), even though key bindings are listed to do so. It is also worth noting that not all key bindings need your attention; many can be ignored.

For example, as illustrated, the initiate key binding to activate the ability to turn the desktop into a cube/cylinder/sphere and rotate it has been changed. Whereas before a certain combination of keys had to be pressed, now all that needs to be done is to click in the top-right corner of the screen. The cube/cylinder/sphere can be rotated by just holding down the mouse button and moving the mouse. Only this key binding needs to be looked at. All the rest can be completely ignored!


Using the Compiz Fusion Icon to Start Compiz Automatically


Once you have set the effects and animations you want in the Compiz Configuration Manager, they are activated through the Compiz Fusion Icon. This can be found in the System section of your desktop menu. Alternatively, typing fusion in XFCE's Application Finder or KDE's built-in search bar will also bring it up.

Once selected, your screen will momentarily flicker as Compiz is activated, and the red and black Fusion icon itself will appear in your desktop's taskbar.


Emerald

The Emerald Theme Manager

Making Emerald your Window Decorator

Cookies help us deliver our services. By using our services, you agree to our use of cookies.